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)