App::Prove::State(3pm) Perl Programmers Reference Guide App::Prove::State(3pm)NAME
App::Prove::State - State storage for the "prove" command.
VERSION
Version 3.23
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:
o "store"
The filename of the data store holding the data that App::Prove::State reads.
o "extensions" (optional)
The test name extensions. Defaults to ".t".
o "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
perl v5.16.2 2012-10-25 App::Prove::State(3pm)
Check Out this Related Man Page
App::Prove::State::Result(3pm) Perl Programmers Reference Guide App::Prove::State::Result(3pm)NAME
App::Prove::State::Result - Individual test suite results.
VERSION
Version 3.17
DESCRIPTION
The "prove" command supports a "--state" option that instructs it to store persistent state across runs. This module encapsulates the
results for a single test suite run.
SYNOPSIS
# Re-run failed tests
$ prove --state=fail,save -rbv
METHODS
Class Methods
"new"
my $result = App::Prove::State::Result->new({
generation => $generation,
tests => \%tests,
});
Returns a new "App::Prove::State::Result" instance.
"state_version"
Returns the current version of state storage.
"test_class"
Returns the name of the class used for tracking individual tests. This class should either subclass from "App::Prove::State::Result::Test"
or provide an identical interface.
"generation"
Getter/setter for the "generation" of the test suite run. The first generation is 1 (one) and subsequent generations are 2, 3, etc.
"last_run_time"
Getter/setter for the time of the test suite run.
"tests"
Returns the tests for a given generation. This is a hashref or a hash, depending on context called. The keys to the hash are the individual
test names and the value is a hashref with various interesting values. Each k/v pair might resemble something like this:
't/foo.t' => {
elapsed => '0.0428488254547119',
gen => '7',
last_pass_time => '1219328376.07815',
last_result => '0',
last_run_time => '1219328376.07815',
last_todo => '0',
mtime => '1191708862',
seq => '192',
total_passes => '6',
}
"test"
my $test = $result->test('t/customer/create.t');
Returns an individual "App::Prove::State::Result::Test" instance for the given test name (usually the filename). Will return a new
"App::Prove::State::Result::Test" instance if the name is not found.
"test_names"
Returns an list of test names, sorted by run order.
"remove"
$result->remove($test_name); # remove the test
my $test = $result->test($test_name); # fatal error
Removes a given test from results. This is a no-op if the test name is not found.
"num_tests"
Returns the number of tests for a given test suite result.
"raw"
Returns a hashref of raw results, suitable for serialization by YAML.
perl v5.12.1 2010-04-26 App::Prove::State::Result(3pm)