1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
4 .\" ========================================================================
5 .de Sh \" Subsection heading
13 .de Sp \" Vertical space (when we can't use .PP)
17 .de Vb \" Begin verbatim text
22 .de Ve \" End verbatim text
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. | will give a
29 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30 .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
57 . tm Index:\\$1\t\\n%\t"\\$2"
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear. Run. Save yourself. No user-serviceable parts.
70 . \" fudge factors for nroff and troff
79 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
85 . \" simple accents for nroff and troff
95 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
102 . \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 . \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 . \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
129 .\" ========================================================================
131 .IX Title "App::Prove::State::Result 3"
132 .TH App::Prove::State::Result 3 "2009-05-05" "perl v5.8.7" "User Contributed Perl Documentation"
134 App::Prove::State::Result \- Individual test suite results.
139 .IX Header "DESCRIPTION"
140 The \f(CW\*(C`prove\*(C'\fR command supports a \f(CW\*(C`\-\-state\*(C'\fR option that instructs it to
141 store persistent state across runs. This module encapsulates the results for a
142 single test suite run.
144 .IX Header "SYNOPSIS"
146 \& # Re\-run failed tests
147 \& $ prove \-\-state=fail,save \-rbv
152 .IX Subsection "Class Methods"
153 \fI\f(CI\*(C`new\*(C'\fI\fR
157 \& my $result = App::Prove::State::Result\->new({
158 \& generation => $generation,
159 \& tests => \e%tests,
163 Returns a new \f(CW\*(C`App::Prove::State::Result\*(C'\fR instance.
164 .ie n .Sh """state_version"""
165 .el .Sh "\f(CWstate_version\fP"
166 .IX Subsection "state_version"
167 Returns the current version of state storage.
168 .ie n .Sh """test_class"""
169 .el .Sh "\f(CWtest_class\fP"
170 .IX Subsection "test_class"
171 Returns the name of the class used for tracking individual tests. This class
172 should either subclass from \f(CW\*(C`App::Prove::State::Result::Test\*(C'\fR or provide an
175 \fI\f(CI\*(C`generation\*(C'\fI\fR
176 .IX Subsection "generation"
178 Getter/setter for the \*(L"generation\*(R" of the test suite run. The first
179 generation is 1 (one) and subsequent generations are 2, 3, etc.
181 \fI\f(CI\*(C`last_run_time\*(C'\fI\fR
182 .IX Subsection "last_run_time"
184 Getter/setter for the time of the test suite run.
186 \fI\f(CI\*(C`tests\*(C'\fI\fR
187 .IX Subsection "tests"
189 Returns the tests for a given generation. This is a hashref or a hash,
190 depending on context called. The keys to the hash are the individual
191 test names and the value is a hashref with various interesting values.
192 Each k/v pair might resemble something like this:
196 \& elapsed => '0.0428488254547119',
198 \& last_pass_time => '1219328376.07815',
199 \& last_result => '0',
200 \& last_run_time => '1219328376.07815',
202 \& mtime => '1191708862',
204 \& total_passes => '6',
208 \fI\f(CI\*(C`test\*(C'\fI\fR
209 .IX Subsection "test"
212 \& my $test = $result\->test('t/customer/create.t');
215 Returns an individual \f(CW\*(C`App::Prove::State::Result::Test\*(C'\fR instance for the
216 given test name (usually the filename). Will return a new
217 \&\f(CW\*(C`App::Prove::State::Result::Test\*(C'\fR instance if the name is not found.
219 \fI\f(CI\*(C`test_names\*(C'\fI\fR
220 .IX Subsection "test_names"
222 Returns an list of test names, sorted by run order.
224 \fI\f(CI\*(C`remove\*(C'\fI\fR
225 .IX Subsection "remove"
228 \& $result\->remove($test_name); # remove the test
229 \& my $test = $result\->test($test_name); # fatal error
232 Removes a given test from results. This is a no-op if the test name is not
235 \fI\f(CI\*(C`num_tests\*(C'\fI\fR
236 .IX Subsection "num_tests"
238 Returns the number of tests for a given test suite result.
240 \fI\f(CI\*(C`raw\*(C'\fI\fR
243 Returns a hashref of raw results, suitable for serialization by \s-1YAML\s0.