---
name: "App::Prove::State"
section: "3perl"
platform: "linux"
package: "perl"
version: "5.44.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/App::Prove::State/3perl"
---

# App::Prove::State(3perl)

State storage for the "prove" command.

## NAME

App::Prove::State - State storage for the "prove" command.

## VERSION

Version 3.52

## DESCRIPTION

The `"prove"` command supports a `"--state"` option that instructs it to store persistent state across runs. This module implements that state and the operations that may be performed on it.

## SYNOPSIS

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

## METHODS

### Class Methods

*"new"*

Accepts a hashref with the following 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.

### "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"*

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

Apply a list of switch options to the state, updating the internal object state as a result. Nothing is returned.

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 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