App::Prove::State(3pm)

🌸 NAME 🌸

Okay bestie, welcome to the App::Prove::State(3pm) page — it's from the Perl Programmers Reference Guide, and it's literally the state-storage module for the prove command. 💖

✨ VERSION ✨

Version 3.50 — periodt. 🎀

💖 DESCRIPTION 💖

So prove supports a --state option that tells it to store persistent state across runs. This module implements that state plus the operations you can perform on it. No cap. ✨

🎀 SYNOPSIS 🎀

# Re-run failed tests
$ prove --state=failed,save -rbv

💅 METHODS 💅

🧚 Class Methods

• new — accepts a hashref with these key/value pairs:
  • store — the filename of the data store holding the data that App::Prove::State reads. 🗂️
  • extensions (optional) — the test name extensions. Defaults to .t.
  • result_class (optional) — the name of the result_class. Defaults to App::Prove::State::Result.
• result_class — getter/setter for the name of the class used for tracking test results. This class should either subclass from App::Prove::State::Result or provide an identical interface. Slay. 👑
• extensions — get or set the list of extensions that files must have in order to be considered tests. Defaults to ['.t'].
• results — get the results of the last test run. Returns a result_class() instance. 💅
• commit — save the test results. Should be called after all tests have run. ✨

🦋 Instance Methods

• apply_switch — apply a list of switch options to the state, updating the internal object state as a result. Nothing is returned.

$self->apply_switch('failed,save');

Diagnostics:

• Illegal state option: %s
• last — run in the same order as last time.
• failed — run only the failed tests from last time.
• passed — run only the passed tests from last time.
• all — run all tests in normal order.
• hot — run the tests that most recently failed first.
• todo — run the tests ordered by number of todos.
• slow — run the tests in slowest to fastest order.
• fast — run tests in fastest to slowest order.
• new — run the tests in newest to oldest order.
• old — run the tests in oldest to newest order.
• save — save the state on exit. 💾
• get_tests — given a list of args, get the names of tests that should run.
• observe_test — store the results of a test.
• save — write the state to a file. (Yes, there's another save bestie — this one writes the state. 🫶)
• load — load the state from a file.

---

That's the whole vibe check, bestie. This page came with Perl v5.42.3, dated 2026-11-03, and it's App::Prove::State(3pm) — bye and slay! 💖✨