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::Test 3"
132 .TH App::Prove::State::Result::Test 3 "2009-05-05" "perl v5.8.7" "User Contributed Perl Documentation"
134 App::Prove::State::Result::Test \- Individual test 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
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
155 .Sh "Instance Methods"
156 .IX Subsection "Instance Methods"
157 \fI\f(CI\*(C`name\*(C'\fI\fR
158 .IX Subsection "name"
160 The name of the test. Usually a filename.
162 \fI\f(CI\*(C`elapsed\*(C'\fI\fR
163 .IX Subsection "elapsed"
165 The total elapsed times the test took to run, in seconds from the epoch..
167 \fI\f(CI\*(C`generation\*(C'\fI\fR
168 .IX Subsection "generation"
170 The number for the \*(L"generation\*(R" of the test run. The first generation is 1
171 (one) and subsequent generations are 2, 3, etc.
173 \fI\f(CI\*(C`last_pass_time\*(C'\fI\fR
174 .IX Subsection "last_pass_time"
176 The last time the test program passed, in seconds from the epoch.
178 Returns \f(CW\*(C`undef\*(C'\fR if the program has never passed.
180 \fI\f(CI\*(C`last_fail_time\*(C'\fI\fR
181 .IX Subsection "last_fail_time"
183 The last time the test suite failed, in seconds from the epoch.
185 Returns \f(CW\*(C`undef\*(C'\fR if the program has never failed.
187 \fI\f(CI\*(C`mtime\*(C'\fI\fR
188 .IX Subsection "mtime"
190 Returns the mtime of the test, in seconds from the epoch.
192 \fI\f(CI\*(C`raw\*(C'\fI\fR
195 Returns a hashref of raw test data, suitable for serialization by \s-1YAML\s0.
197 \fI\f(CI\*(C`result\*(C'\fI\fR
198 .IX Subsection "result"
200 Currently, whether or not the test suite passed with no 'problems' (such as
201 \&\s-1TODO\s0 passed).
203 \fI\f(CI\*(C`run_time\*(C'\fI\fR
204 .IX Subsection "run_time"
206 The total time it took for the test to run, in seconds. If \f(CW\*(C`Time::HiRes\*(C'\fR is
207 available, it will have finer granularity.
209 \fI\f(CI\*(C`num_todo\*(C'\fI\fR
210 .IX Subsection "num_todo"
212 The number of tests with \s-1TODO\s0 directives.
214 \fI\f(CI\*(C`sequence\*(C'\fI\fR
215 .IX Subsection "sequence"
217 The order in which this test was run for the given test suite result.
219 \fI\f(CI\*(C`total_passes\*(C'\fI\fR
220 .IX Subsection "total_passes"
222 The number of times the test has passed.
224 \fI\f(CI\*(C`total_failures\*(C'\fI\fR
225 .IX Subsection "total_failures"
227 The number of times the test has failed.
229 \fI\f(CI\*(C`parser\*(C'\fI\fR
230 .IX Subsection "parser"
232 The underlying parser object. This is useful if you need the full
233 information for the test program.