Manual

- Overview
- Tutorials
- FAQs
- History / Changes
- License

Reference

- Language
- Functions
- Operators
- Special Variables
- Pragmas
- Utilities
- Internals
- Platform Specific

Modules

- A • B • C • D • E
- F • G • H • I • L
- M • N • O • P • S
- T • U • X

News / Blogs

- Perl Buzz
- Perl Iron Man
- Perlsphere
- Planet Perl
- TPF news
- Use Perl

See also

- CPAN
- Perl.org
- Perl.com
- Perl 5 Wiki
- Perl Jobs
- Perl Mongers
- Perl Monks

Contact

- Site designed and maintained by Jon Allen (JJ)
- http://perl.jonallen.info

- View the project page and FAQs

# App::Prove::State

Perl 5 version 10.1 documentation
Go to top • Show page index • Download PDF

# App::Prove::State

- NAME
- VERSION
- DESCRIPTION
- SYNOPSIS
- METHODS
  - Class Methods
  - result_class
  - extension
  - results
  - commit
  - Instance Methods

# NAME

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

# VERSION

Version 3.17

# 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=fail,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.

- `extension` (optional)

  The test name extension. 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.

## `extension`

Get or set the extension 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

Page index

- NAME
- VERSION
- DESCRIPTION
- SYNOPSIS
- METHODS
  - Class Methods
  - result_class
  - extension
  - results
  - commit
  - Instance Methods

Recently read

Tools

- Preferences