{
    "mode": "perldoc",
    "parameter": "App::Prove::State::Result",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/perldoc/App%3A%3AProve%3A%3AState%3A%3AResult/json",
    "generated": "2026-06-16T03:10:09Z",
    "synopsis": "# Re-run failed tests\n$ prove --state=failed,save -rbv",
    "sections": {
        "NAME": {
            "content": "App::Prove::State::Result - Individual test suite results.\n",
            "subsections": []
        },
        "VERSION": {
            "content": "Version 3.43\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The \"prove\" command supports a \"--state\" option that instructs it to store persistent state\nacross runs. This module encapsulates the results for a single test suite run.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "# Re-run failed tests\n$ prove --state=failed,save -rbv\n",
            "subsections": []
        },
        "METHODS": {
            "content": "",
            "subsections": [
                {
                    "name": "Class Methods",
                    "content": "\"new\"\nmy $result = App::Prove::State::Result->new({\ngeneration => $generation,\ntests      => \\%tests,\n});\n\nReturns a new \"App::Prove::State::Result\" instance.\n\n\"stateversion\"\nReturns the current version of state storage.\n\n\"testclass\"\nReturns the name of the class used for tracking individual tests. This class should either\nsubclass from \"App::Prove::State::Result::Test\" or provide an identical interface.\n\n\"generation\"\nGetter/setter for the \"generation\" of the test suite run. The first generation is 1 (one) and\nsubsequent generations are 2, 3, etc.\n\n\"lastruntime\"\nGetter/setter for the time of the test suite run.\n\n\"tests\"\nReturns the tests for a given generation. This is a hashref or a hash, depending on context\ncalled. The keys to the hash are the individual test names and the value is a hashref with\nvarious interesting values. Each k/v pair might resemble something like this:\n\n't/foo.t' => {\nelapsed        => '0.0428488254547119',\ngen            => '7',\nlastpasstime => '1219328376.07815',\nlastresult    => '0',\nlastruntime  => '1219328376.07815',\nlasttodo      => '0',\nmtime          => '1191708862',\nseq            => '192',\ntotalpasses   => '6',\n}\n\n\"test\"\nmy $test = $result->test('t/customer/create.t');\n\nReturns an individual \"App::Prove::State::Result::Test\" instance for the given test name\n(usually the filename). Will return a new \"App::Prove::State::Result::Test\" instance if the name\nis not found.\n\n\"testnames\"\nReturns an list of test names, sorted by run order.\n\n\"remove\"\n$result->remove($testname);            # remove the test\nmy $test = $result->test($testname);   # fatal error\n\nRemoves a given test from results. This is a no-op if the test name is not found.\n\n\"numtests\"\nReturns the number of tests for a given test suite result.\n\n\"raw\"\nReturns a hashref of raw results, suitable for serialization by YAML.\n"
                }
            ]
        }
    },
    "summary": "App::Prove::State::Result - Individual test suite results.",
    "flags": [],
    "examples": [],
    "see_also": []
}