Linux repositories inspector

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

perl v5.28.1
2019-03-31

perl-doc

Perl language documentation

perl

Larry Wall's Practical Extraction and Report Language

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.

CWstate_version

Returns the current version of state storage.

CWtest_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.
⇧ Top