App::Prove::State::Result - Individual test suite results.
# Re-run failed tests $ prove --state=failed,save -rbv
Perl Programmers Reference Guide
App::Prove::State::Result(3)
NAME
App::Prove::State::Result - Individual test suite results.
VERSION
Version 3.42
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=failed,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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | runtime/perl-532 |
+---------------+-----------------------+
|Stability | Pass-through volatile |
+---------------+-----------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
http://www.cpan.org/src/5.0/perl-5.32.0.tar.gz.
Further information about this software can be found on the open source
community website at https://www.perl.org/.
perl v5.32.0 2020-06-14
App::Prove::State::Result(3)