APP::PROVE::STATE(3perl)

✨ NAME ✨

App::Prove::State — bestie, it's the state storage for the prove command 💾💖

---

🌸 VERSION 🌸

Version 3.52 ⭐

---

🦋 DESCRIPTION 🦋

Okay so picture this: the prove command has a --state option, and what that does is tell it to keep persistent state across runs — like, it remembers stuff between invocations, main character energy fr fr. This module is the thing that implements that state, plus all the operations you can do on it. Periodt. 👑

---

💅 SYNOPSIS 💅

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

look at her go 🥰

---

🎀 METHODS 🎀

🌈 Class Methods 🌈

• new — the constructor, obviously. 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. no cap, identical interface, she's not picky but she IS specific 💅
• 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. do NOT forget this one bestie, it's giving "unsaved homework" 😭

---

💜 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 (yeah she WILL call you out 💀)

So here's the menu of switch options you can feed her:

• 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 test 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. 📝
• load — load the state from a file. 📥

---

and that's the whole vibe, iykyk 🌈

k byeeee, this was App::P...::State(3perl) from perl v5.44.0, dated 2026-10-17 — slay, stream it, cite it, love her 💖✨🎀