blib/lib/Venus/Test.pm

filter: Statementstmt 96.7% 3925 / 4055 Branchbran 69.0% 385 / 558 Conditioncond 45.5% 71 / 156 MC/DCmcdc 16.0% 14 / 87 Subroutinesub 99.4% 1186 / 1193 Podpod 96.1% 101 / 105 totaltotal 92.3% 5682 / 6154 CC 474 SCAR 57.6
CC
474
Cov
92%
AUTOLOAD
2224.6
handler
14.3
build_args
5.0
CRAP 318.7
↑ Summary blib/lib/Venus/Task/Venus/Gen.pm »
1 package Venus::Test;
2  
3 126 ▶use 5.018;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 123 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
6 120 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
7  
8 # IMPORTS
9  
10 120 ▶use Venus 'fault';
Subroutine BEGIN: called CC=1 SCAR=0.0
11  
12 120 ▶use Venus::Class 'attr', 'base', 'with';
Subroutine BEGIN: called CC=1 SCAR=0.0
13  
14 # INHERITS
15  
16 119 base 'Venus::Kind';
17  
18 # INTEGRATES
19  
20 119 with 'Venus::Role::Buildable';
21 119 with 'Venus::Role::Encaseable';
22  
23 # REQUIRES
24  
25 119 require Test::More;
26  
27 # STATE
28  
29 119 our @EXPORT = ('false', 'test', 'true');
30  
31 # CONFIG
32  
33 119 our $CONFIG = {
34 block => {
35 abstract => {
36 find => {
37 list => undef,
38 name => 'abstract'
39 },
40 render => {
41 index => 2,
42 section => undef
43 },
44 required => true,
45 },
46 attribute => {
47 find => {
48 list => 'attribute',
49 name => undef
50 },
51 render => {
52 index => 6,
53 section => 'attributes'
54 },
55 required => false,
56 },
57 attributes => {
58 find => {
59 list => undef,
60 name => 'attributes'
61 },
62 render => {
63 index => 6,
64 section => undef
65 },
66 required => false,
67 },
68 authors => {
69 find => {
70 list => undef,
71 name => 'authors'
72 },
73 render => {
74 index => 17,
75 section => undef
76 },
77 required => false,
78 },
79 description => {
80 find => {
81 list => undef,
82 name => 'description'
83 },
84 render => {
85 index => 5,
86 section => undef
87 },
88 required => true,
89 },
90 encoding => {
91 find => {
92 list => undef,
93 name => 'encoding'
94 },
95 render => {
96 index => 0,
97 section => undef
98 },
99 required => false,
100 },
101 error => {
102 find => {
103 list => 'error',
104 name => undef
105 },
106 render => {
107 index => 14,
108 section => 'errors'
109 },
110 required => false,
111 },
112 example => {
113 find => {
114 list => 'example',
115 name => undef
116 },
117 render => {
118 index => undef,
119 section => undef
120 },
121 required => false,
122 },
123 feature => {
124 find => {
125 list => 'feature',
126 name => undef
127 },
128 render => {
129 index => 13,
130 section => 'features'
131 },
132 required => false,
133 },
134 function => {
135 find => {
136 list => 'function',
137 name => undef
138 },
139 render => {
140 index => 10,
141 section => 'functions'
142 },
143 required => false,
144 },
145 includes => {
146 find => {
147 list => undef,
148 name => 'includes'
149 },
150 render => {
151 index => undef,
152 section => undef
153 },
154 required => false,
155 },
156 inherits => {
157 find => {
158 list => undef,
159 name => 'inherits'
160 },
161 render => {
162 index => 7,
163 section => undef
164 },
165 required => false,
166 },
167 integrates => {
168 find => {
169 list => undef,
170 name => 'integrates'
171 },
172 render => {
173 index => 8,
174 section => undef
175 },
176 required => false,
177 },
178 layout => {
179 find => {
180 list => undef,
181 name => 'layout'
182 },
183 render => {
184 index => undef,
185 section => undef
186 },
187 required => false,
188 },
189 libraries => {
190 find => {
191 list => undef,
192 name => 'libraries'
193 },
194 render => {
195 index => 9,
196 section => undef
197 },
198 required => false,
199 },
200 license => {
201 find => {
202 list => undef,
203 name => 'license'
204 },
205 render => {
206 index => 18,
207 section => undef
208 },
209 required => false,
210 },
211 message => {
212 find => {
213 list => 'message',
214 name => undef
215 },
216 render => {
217 index => 12,
218 section => 'messages'
219 },
220 required => false,
221 },
222 metadata => {
223 find => {
224 list => 'metadata',
225 name => undef
226 },
227 render => {
228 index => undef,
229 section => undef
230 },
231 required => false,
232 },
233 method => {
234 find => {
235 list => 'method',
236 name => undef
237 },
238 render => {
239 index => 11,
240 section => 'methods'
241 },
242 required => false,
243 },
244 name => {
245 find => {
246 list => undef,
247 name => 'name'
248 },
249 render => {
250 index => 1,
251 section => undef
252 },
253 required => true,
254 },
255 operator => {
256 find => {
257 list => 'operator',
258 name => undef
259 },
260 render => {
261 index => 15,
262 section => 'operators'
263 },
264 required => false,
265 },
266 partials => {
267 find => {
268 list => undef,
269 name => 'partials'
270 },
271 render => {
272 index => 16,
273 section => undef
274 },
275 required => false,
276 },
277 project => {
278 find => {
279 list => undef,
280 name => 'project'
281 },
282 render => {
283 index => 19,
284 section => undef
285 },
286 required => false,
287 },
288 raise => {
289 find => {
290 list => 'raise',
291 name => undef
292 },
293 render => {
294 index => undef,
295 section => undef
296 },
297 required => false,
298 },
299 signature => {
300 find => {
301 list => 'signature',
302 name => undef
303 },
304 render => {
305 index => undef,
306 section => undef
307 },
308 required => false,
309 },
310 synopsis => {
311 find => {
312 list => undef,
313 name => 'synopsis'
314 },
315 render => {
316 index => 4,
317 section => undef
318 },
319 required => true,
320 },
321 tagline => {
322 find => {
323 list => undef,
324 name => 'tagline'
325 },
326 render => {
327 index => undef,
328 section => undef
329 },
330 required => true,
331 },
332 version => {
333 find => {
334 list => undef,
335 name => 'version'
336 },
337 render => {
338 index => 3,
339 section => undef
340 },
341 required => false,
342 },
343 },
344 };
345  
346 # ATTRIBUTES
347  
348 119 attr 'file';
349  
350 # BUILDERS
351  
352 370 ▶sub build_arg {
Subroutine build_arg: called CC=1 SCAR=0.0
Pod undocumented
353 370 my ($self, $data) = @_;
354  
355 return {
356 370 file => $data,
357 };
358 }
359  
360 399 ▶sub build_self {
Subroutine build_self: called CC=4 SCAR=14.0
Pod undocumented
361 399 my ($self, $data) = @_;
362  
363 399 ▶ return $self if !$self->file;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->file 1 399 400
364  
365 398 for my $name (grep {$CONFIG->{block}->{$_}->{required}} keys %{$CONFIG->{block}}) {
366 1986 ▶ if (!$self->text->count({name => $name, list => undef})) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->text->count({"name", $name, "list", undef})) 0 1986 1986
367 0 $self->error_on_new({file => $self->file, block => $name})->throw;
368 }
369 }
370  
371 397 return $self;
372 }
373  
374 # FUNCTIONS
375  
376 215 ▶sub test {
Subroutine test: called CC=1 SCAR=0.0
Pod documented
377  
378 215 return Venus::Test->new($_[0]);
379 }
380  
381 # METHODS
382  
383 11830 ▶sub auto {
Subroutine auto: called CC=3 SCAR=11.0
Pod documented
384 11830 my ($self, $name, @args) = @_;
385  
386 11830 ▶ return if !$name;
Branch: 1 branch
BranchTrueFalseTotal
unless $name 0 11831 11831
387  
388 11830 my $NAME = uc "venus_test_auto_${name}";
389  
390 11830 ▶ return $ENV{$NAME} if !@args;
Branch: 1 branch
BranchTrueFalseTotal
unless @args 11818 13 11831
391  
392 12 return ($ENV{$NAME}) = @args;
393 }
394  
395 0 ▶sub diag {
Subroutine diag: not called CC=1 SCAR=6.9
Pod documented
396 0 my ($self, @args) = @_;
397  
398 0 return $self->handler('diag', $self->explain(@args));
399 }
400  
401 1 ▶sub done {
Subroutine done: called CC=3 SCAR=12.5
Pod documented
402 1 my ($self) = @_;
403  
404 1 ▶ $self->render if $self->auto('render') && !$self->encased('rendered');
Branch: 1 branch
BranchTrueFalseTotal
if $self->auto("render") and not $self->encased("rendered") 0 2 2
Condition33%1/3
$self->auto("render") and not $self->encased("rendered")
!ll&&!rl&&r
100
MC/DC0%0/2
$self->auto("render") and not $self->encased("rendered")
$self->auto("render") not $self->encased("rendered")
Truth table33%1/3
A and not(B)
A= $self->auto("render")B= not $self->encased("rendered")
ABresult
0X0
100
111
405  
406 1 return $self->handler('done_testing');
407 }
408  
409 5365 ▶sub eval {
Subroutine eval: called CC=3 SCAR=11.0
Pod documented
410 5365 my ($self, $perl) = @_;
411  
412 5365 local $@;
413  
414 120 ▶ my @result = CORE::eval(join("\n\n", "no warnings q(redefine);", $perl));
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BEGIN: called CC=1 SCAR=0.0
Subroutine BUILD: called CC=1 SCAR=0.0
Subroutine BUILD: called CC=1 SCAR=0.0
Subroutine BUILD: called CC=1 SCAR=0.0
Subroutine BUILD: called CC=1 SCAR=0.0
Subroutine BUILD: called CC=1 SCAR=0.0
Subroutine BUILD: called CC=1 SCAR=0.0
Subroutine test: called CC=1 SCAR=0.0
Subroutine test: called CC=1 SCAR=0.0
Subroutine test: called CC=1 SCAR=0.0
Subroutine test: called CC=1 SCAR=0.0
Subroutine test: called CC=1 SCAR=0.0
Subroutine test: called CC=1 SCAR=0.0
Subroutine test: called CC=1 SCAR=0.0
Subroutine __ANON__: called CC=1 SCAR=0.0
Subroutine conditions: called CC=1 SCAR=0.0
Subroutine new: called CC=1 SCAR=0.0
Subroutine new: called CC=1 SCAR=0.0
Subroutine new: called CC=1 SCAR=0.0
Subroutine new: called CC=1 SCAR=0.0
Subroutine AUDIT: called CC=3 SCAR=11.0
Subroutine AUDIT: called CC=3 SCAR=11.0
Subroutine AUDIT: called CC=2 SCAR=6.9
Subroutine EXPORT: called CC=1 SCAR=0.0
Subroutine EXPORT: called CC=1 SCAR=0.0
Subroutine EXPORT: called CC=1 SCAR=0.0
Subroutine EXPORT: called CC=1 SCAR=0.0
Subroutine EXPORT: called CC=1 SCAR=0.0
Subroutine EXPORT: called CC=1 SCAR=0.0
Subroutine action: called CC=1 SCAR=0.0
Subroutine attempt: called CC=1 SCAR=0.0
Subroutine attempt: called CC=1 SCAR=0.0
Subroutine attempt: called CC=1 SCAR=0.0
Subroutine authenticate: called CC=1 SCAR=0.0
Subroutine get_secret: called CC=1 SCAR=0.0
Subroutine knowledge: called CC=1 SCAR=0.0
Subroutine no: called CC=1 SCAR=0.0
Subroutine no: called CC=1 SCAR=0.0
Subroutine output: called CC=1 SCAR=0.0
Subroutine set_secret: called CC=1 SCAR=0.0
Subroutine valid: called CC=3 SCAR=11.0
Subroutine yes: called CC=1 SCAR=0.0
Subroutine yes: called CC=1 SCAR=0.0
Subroutine ARGS: called CC=1 SCAR=0.0
Subroutine ARGS: called CC=1 SCAR=0.0
Subroutine AUDIT: called CC=3 SCAR=11.0
Subroutine AUDIT: called CC=3 SCAR=11.0
Subroutine BUILDARGS: called CC=3 SCAR=11.0
Subroutine BUILDARGS: called CC=1 SCAR=0.0
Subroutine CONSTRUCT: called CC=1 SCAR=0.0
Subroutine CONSTRUCT: called CC=1 SCAR=0.0
Subroutine DATA: called CC=1 SCAR=0.0
Subroutine DATA: called CC=1 SCAR=0.0
Subroutine DATA: called CC=1 SCAR=0.0
Subroutine DATA: called CC=1 SCAR=0.0
Subroutine DECONSTRUCT: called CC=1 SCAR=0.0
Subroutine DESTROY: not called CC=1 SCAR=0.0
Subroutine IMPORT: called CC=1 SCAR=0.0
Subroutine debug: called CC=1 SCAR=0.0
Subroutine get_password: called CC=1 SCAR=0.0
Subroutine get_password: called CC=1 SCAR=0.0
Subroutine set_password: called CC=1 SCAR=0.0
Subroutine set_password: not called CC=1 SCAR=0.0
Subroutine shutdown: called CC=1 SCAR=0.0
Subroutine shutdown: called CC=1 SCAR=0.0
Subroutine startup: called CC=1 SCAR=0.0
Subroutine work: called CC=1 SCAR=0.0
Subroutine as_auth_error: called CC=1 SCAR=0.0
Subroutine as_auth_error: called CC=1 SCAR=0.0
Subroutine as_auth_error: called CC=1 SCAR=0.0
Subroutine as_auth_error: called CC=1 SCAR=0.0
Subroutine as_auth_error: called CC=1 SCAR=0.0
Subroutine as_auth_error: called CC=1 SCAR=0.0
Subroutine as_auth_error: called CC=1 SCAR=0.0
Subroutine as_role_error: called CC=1 SCAR=0.0
Subroutine as_role_error: called CC=1 SCAR=0.0
Branch: 29 branches
BranchTrueFalseTotal
unless $self->calls 7 3 10
unless $from->can("login") 9 5 14
if not $from->can("password") 4 6 10
unless $from->can("startup") 4 6 10
if not $from->can("shutdown") 4 4 8
if $_[1]->isa("Example") 7 2 9
$self->login && $self->password ? : 4 2 6
@args ? : 3 2 5
@args == 1 && ref $args[0] eq 'ARRAY' ? : 4 2 6
@args ? : 4 2 6
@args == 1 && ref $args[0] eq 'ARRAY' ? : 3 1 4
unless $from->can("startup") 3 0 3
if not $from->can("shutdown") 2 0 2
if not $from->DOES("Admin") 2 0 2
@args == 1 && !ref($args[0]) ? : 3 0 3
$data ? : 3 0 3
$data ? : 3 1 4
unless $from->can("login") 3 0 3
if not $from->can("password") 1 1 2
unless $from->can("login") 2 1 3
if not $from->can("password") 2 0 2
unless $from->can("login") 2 2 4
if not $from->can("password") 1 2 3
unless $from->can("login") 2 2 4
if not $from->can("password") 1 2 3
unless $from->can("login") 2 2 4
if not $from->can("password") 1 2 3
unless $from->can("login") 1 0 1
if not $from->can("password") 1 0 1
Condition57%15/26
$self->login and $self->password
!ll&&!rl&&r
231
@args == 1 and ref $args[0] eq "ARRAY"
!ll&&!rl&&r
021
@args == 1 and ref $args[0] eq "ARRAY"
!ll&&!rl&&r
121
@args == 1 and not ref $args[0]
!ll&&!rl&&r
020
$data->{"x"} ||= int($data->{"x"} || 100)
l!l&&r!l&&!r
022
$data->{'x'} || 100
l!l
020
$data->{"y"} ||= int($data->{"y"} || 100)
l!l&&r!l&&!r
400
$data->{'y'} || 100
l!l
30
not exists $args->{"z"} and exists $xargs->{"z"}
!ll&&!rl&&r
300
MC/DC100%2/2
$self->login and $self->password
$self->login $self->password
MC/DC50%1/2
@args == 1 and ref $args[0] eq "ARRAY"
@args == 1 ref $args[0] eq "ARRAY"
MC/DC50%1/2
@args == 1 and ref $args[0] eq "ARRAY"
@args == 1 ref $args[0] eq "ARRAY"
MC/DC0%0/2
@args == 1 and not ref $args[0]
@args == 1 not ref $args[0]
MC/DC0%0/2
$data->{"x"} ||= int($data->{"x"} || 100)
$data->{"x"} $data->{'x'}
MC/DC0%0/2
$data->{"y"} ||= int($data->{"y"} || 100)
$data->{"y"} $data->{'y'}
MC/DC0%0/2
not exists $args->{"z"} and exists $xargs->{"z"}
not exists $args->{"z"} exists $xargs->{"z"}
Truth table100%3/3
A and B
A= $self->loginB= $self->password
ABresult
0X0
100
111
Truth table66%2/3
A and B
A= @args == 1B= ref $args[0] eq "ARRAY"
ABresult
0X0
100
111
Truth table66%2/3
A and B
A= @args == 1B= ref $args[0] eq "ARRAY"
ABresult
0X0
100
111
Truth table33%1/3
A and not(B)
A= @args == 1B= not ref $args[0]
ABresult
0X0
100
111
Truth table0%0/3
A ||= B
A= $data->{"x"}B= $data->{'x'}
ABresult
1X1
011
000
Truth table0%0/3
A ||= B
A= $data->{"y"}B= $data->{'y'}
ABresult
1X1
011
000
Truth table0%0/3
not(A) and B
A= not exists $args->{"z"}B= exists $xargs->{"z"}
ABresult
0X0
100
111
415  
416 5365 my $dollarat = $@;
417  
418 5365 ▶ die $dollarat if $dollarat;
Branch: 1 branch
BranchTrueFalseTotal
if $dollarat 154 5212 5366
419  
420 5211 ▶ return wantarray ? (@result) : $result[0];
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 5210 2 5212
421 }
422  
423 11 ▶sub explain {
Subroutine explain: called CC=1 SCAR=0.0
Pod documented
424 3 my ($self, @args) = @_;
425  
426 return join ' ',
427 3 map {s/^\s+|\s+$//gr} map {$self->more('explain', $_)} grep {defined} @args;
428 }
429  
430 32 ▶sub fail {
Subroutine fail: called CC=1 SCAR=0.0
Pod documented
431 26 my ($self, $bool, @args) = @_;
432  
433 26 my $result = $self->handler('ok', !$bool, @args);
434  
435 26 return $result;
436 }
437  
438 6430 ▶sub for {
Subroutine for: called CC=2 SCAR=6.9
Pod documented
439 6411 my ($self, $type, @args) = @_;
440  
441 6411 ▶ my $code = ref $args[-1] eq 'CODE' ? pop @args : undef;
Branch: 1 branch
BranchTrueFalseTotal
ref $args[-1] eq 'CODE' ? : 5401 1014 6415
442  
443 6411 my $name = join ' ', grep {!ref $_} $type, @args;
444  
445 6411 ▶ $self->subtest($name, sub {$self->execute($type, @args, $code)});
Subroutine __ANON__: called CC=1 SCAR=0.0
446  
447 6411 return $self;
448 }
449  
450 38 ▶sub gate {
Subroutine gate: called CC=1 SCAR=0.0
Pod documented
451 28 my ($self, $note, $code) = @_;
452  
453 28 my $test = $self->renew;
454  
455 28 $test->recase('gate', [$note, $code]);
456  
457 28 return $test;
458 }
459  
460 24846 ▶sub handler {
Subroutine handler: called CC=13 SCAR=26.6
Pod documented
461 24839 my ($self, $name, @args) = @_;
462  
463 24839 my $found = 0;
464 24839 my $level = 0;
465  
466 24839 ▶ while (my @caller = caller($level)) {
Branch: 1 branch
BranchTrueFalseTotal
if (my(@caller) = caller $level) 211157 24691 235848
467 211157 $level++;
468 211157 ▶ $found++ && last if $caller[1] =~ qr{@{[quotemeta($self->file)]}$};
Branch: 1 branch
BranchTrueFalseTotal
if $caller[1] =~ qr/@{[quotemeta $self->file];}$/u 24920 186237 211157
Condition100%5/5
$caller[1] =~ qr/@{[quotemeta $self->file];}$/u && ($found++ && (last))
!ll
186240249207
$found++ and last
!ll
24772148
MC/DC50%1/2
$caller[1] =~ qr/@{[quotemeta $self->file];}$/u && ($found++ && (last))
$caller[1] =~ qr/@{[quotemeta $self->file];}$/u $found++
Truth table66%2/3
A && B
A= $caller[1] =~ qr/@{[quotemeta $self->file];}$/uB= $found++
ABresult
0X0
100
111
469 }
470  
471 24839 ▶ local $Test::Builder::Level = $found ? $level + 1 : $Test::Builder::Level + $level;
Branch: 1 branch
BranchTrueFalseTotal
$found ? : 24772 67 24839
472  
473 24839 my @return;
474  
475 24839 ▶ if (wantarray) {
Branch: 1 branch
BranchTrueFalseTotal
if (wantarray) { } 3 24836 24839
476 4 @return = Test::More->can($name)->(@args);
477 }
478 else {
479 24836 $return[0] = Test::More->can($name)->(@args);
480 }
481  
482 # whitelist methods
483 24830 state $test_more_functions = {
484 BAIL_OUT => 'BAIL_OUT',
485 done_testing => 'done_testing',
486 plan => 'plan',
487 skip => 'skip',
488 };
489 $self->BAIL_OUT
490 if (!@return || (@return == 1 && !$return[0]))
491 && $self->auto('bailout')
492 24830 ▶ && !$test_more_functions->{$name};
Branch: 1 branch
BranchTrueFalseTotal
if !@return || @return == 1 && !$return[0] and $self->auto("bailout") and not $test_more_functions->{$name} 0 24830 24830
Condition33%4/12
!@return || @return == 1 && !$return[0] and $self->auto("bailout") and not $test_more_functions->{$name}
!ll&&!rl&&r
2482900
!@return || @return == 1 && !$return[0] and $self->auto("bailout")
!ll&&!rl&&r
2482900
not @return or @return == 1 and not $return[0]
l!l&&r!l&&!r
0024829
@return == 1 and not $return[0]
!ll&&!rl&&r
0248290
MC/DC0%0/5
!@return || @return == 1 && !$return[0] and $self->auto("bailout") and not $test_more_functions->{$name}
not @return @return == 1 not $return[0] $self->auto("bailout") not $test_more_functions->{$name}
Truth table12%1/8
not(A) or B and not(C) and D and not(E)
A= not @returnB= @return == 1C= not $return[0]D= $self->auto("bailout")E= not $test_more_functions->{$name}
ABCDEresult
00XXX0
010XX0
1XX0X0
0110X0
1XX100
011100
1XX111
011111
493  
494 24830 ▶ return wantarray ? @return : defined(wantarray) ? $return[0] : ();
Branch: 2 branches
BranchTrueFalseTotal
wantarray ? : 3 24827 24830
defined wantarray ? : 24826 1 24827
495 }
496  
497 4 ▶sub in {
Subroutine in: called CC=1 SCAR=0.0
Pod documented
498 2 my ($self, $this, $that, @args) = @_;
499  
500 2 return $self->pass(Venus::in($this, $that), @args);
501 }
502  
503 5 ▶sub is {
Subroutine is: called CC=1 SCAR=0.0
Pod documented
504 2 my ($self, $data, @args) = @_;
505  
506 2 my $result = $self->handler('is', scalar($data), @args);
507  
508 2 return $result;
509 }
510  
511 4 ▶sub is_arrayref {
Subroutine is_arrayref: called CC=1 SCAR=0.0
Pod documented
512 2 my ($self, $data, @args) = @_;
513  
514 2 return $self->pass(Venus::is_arrayref($data), @args);
515 }
516  
517 3 ▶sub is_blessed {
Subroutine is_blessed: called CC=1 SCAR=0.0
Pod documented
518 2 my ($self, $data, @args) = @_;
519  
520 1 return $self->pass(Venus::is_blessed($data), @args);
521 }
522  
523 2 ▶sub is_boolean {
Subroutine is_boolean: called CC=1 SCAR=0.0
Pod documented
524 1 my ($self, $data, @args) = @_;
525  
526 1 return $self->pass(Venus::is_boolean($data), @args);
527 }
528  
529 3 ▶sub is_coderef {
Subroutine is_coderef: called CC=1 SCAR=0.0
Pod documented
530 2 my ($self, $data, @args) = @_;
531  
532 2 return $self->pass(Venus::is_coderef($data), @args);
533 }
534  
535 2 ▶sub is_dirhandle {
Subroutine is_dirhandle: called CC=1 SCAR=0.0
Pod documented
536 1 my ($self, $data, @args) = @_;
537  
538 1 return $self->pass(Venus::is_dirhandle($data), @args);
539 }
540  
541 2 ▶sub is_enum {
Subroutine is_enum: called CC=1 SCAR=0.0
Pod documented
542 1 my ($self, $data, $items, @args) = @_;
543  
544 1 return $self->pass(Venus::is_enum($data, Venus::list($items)), @args);
545 }
546  
547 48 ▶sub is_error {
Subroutine is_error: called CC=1 SCAR=0.0
Pod documented
548 47 my ($self, $data, @args) = @_;
549  
550 47 return $self->pass(Venus::is_error($data), @args);
551 }
552  
553 2 ▶sub is_false {
Subroutine is_false: called CC=1 SCAR=0.0
Pod documented
554 1 my ($self, $data, @args) = @_;
555  
556 1 return $self->pass(Venus::is_false($data), @args);
557 }
558  
559 2 ▶sub is_fault {
Subroutine is_fault: called CC=1 SCAR=0.0
Pod documented
560 1 my ($self, $data, @args) = @_;
561  
562 1 return $self->pass(Venus::is_fault($data), @args);
563 }
564  
565 2 ▶sub is_filehandle {
Subroutine is_filehandle: called CC=1 SCAR=0.0
Pod documented
566 1 my ($self, $data, @args) = @_;
567  
568 1 return $self->pass(Venus::is_filehandle($data), @args);
569 }
570  
571 2 ▶sub is_float {
Subroutine is_float: called CC=1 SCAR=0.0
Pod documented
572 1 my ($self, $data, @args) = @_;
573  
574 1 return $self->pass(Venus::is_float($data), @args);
575 }
576  
577 2 ▶sub is_glob {
Subroutine is_glob: called CC=1 SCAR=0.0
Pod documented
578 1 my ($self, $data, @args) = @_;
579  
580 1 return $self->pass(Venus::is_glob($data), @args);
581 }
582  
583 2 ▶sub is_hashref {
Subroutine is_hashref: called CC=1 SCAR=0.0
Pod documented
584 1 my ($self, $data, @args) = @_;
585  
586 1 return $self->pass(Venus::is_hashref($data), @args);
587 }
588  
589 2 ▶sub is_number {
Subroutine is_number: called CC=1 SCAR=0.0
Pod documented
590 1 my ($self, $data, @args) = @_;
591  
592 1 return $self->pass(Venus::is_number($data), @args);
593 }
594  
595 2 ▶sub is_object {
Subroutine is_object: called CC=1 SCAR=0.0
Pod documented
596 1 my ($self, $data, @args) = @_;
597  
598 1 return $self->pass(Venus::is_object($data), @args);
599 }
600  
601 2 ▶sub is_package {
Subroutine is_package: called CC=1 SCAR=0.0
Pod documented
602 1 my ($self, $data, @args) = @_;
603  
604 1 return $self->pass(Venus::is_package($data), @args);
605 }
606  
607 2 ▶sub is_reference {
Subroutine is_reference: called CC=1 SCAR=0.0
Pod documented
608 1 my ($self, $data, @args) = @_;
609  
610 1 return $self->pass(Venus::is_reference($data), @args);
611 }
612  
613 2 ▶sub is_regexp {
Subroutine is_regexp: called CC=1 SCAR=0.0
Pod documented
614 1 my ($self, $data, @args) = @_;
615  
616 1 return $self->pass(Venus::is_regexp($data), @args);
617 }
618  
619 2 ▶sub is_scalarref {
Subroutine is_scalarref: called CC=1 SCAR=0.0
Pod documented
620 1 my ($self, $data, @args) = @_;
621  
622 1 return $self->pass(Venus::is_scalarref($data), @args);
623 }
624  
625 2 ▶sub is_string {
Subroutine is_string: called CC=1 SCAR=0.0
Pod documented
626 1 my ($self, $data, @args) = @_;
627  
628 1 return $self->pass(Venus::is_string($data), @args);
629 }
630  
631 2 ▶sub is_true {
Subroutine is_true: called CC=1 SCAR=0.0
Pod documented
632 1 my ($self, $data, @args) = @_;
633  
634 1 return $self->pass(Venus::is_true($data), @args);
635 }
636  
637 2 ▶sub is_undef {
Subroutine is_undef: called CC=1 SCAR=0.0
Pod documented
638 1 my ($self, $data, @args) = @_;
639  
640 1 return $self->pass(Venus::is_undef($data), @args);
641 }
642  
643 2 ▶sub is_value {
Subroutine is_value: called CC=1 SCAR=0.0
Pod documented
644 1 my ($self, $data, @args) = @_;
645  
646 1 return $self->pass(Venus::is_value($data), @args);
647 }
648  
649 2 ▶sub is_yesno {
Subroutine is_yesno: called CC=1 SCAR=0.0
Pod documented
650 1 my ($self, $data, @args) = @_;
651  
652 1 return $self->pass(Venus::is_yesno($data), @args);
653 }
654  
655 2 ▶sub isnt {
Subroutine isnt: called CC=1 SCAR=0.0
Pod documented
656 1 my ($self, $data, @args) = @_;
657  
658 1 my $result = $self->handler('isnt', scalar($data), @args);
659  
660 1 return $result;
661 }
662  
663 2 ▶sub isnt_arrayref {
Subroutine isnt_arrayref: called CC=1 SCAR=0.0
Pod documented
664 1 my ($self, $data, @args) = @_;
665  
666 1 return $self->fail(Venus::is_arrayref($data), @args);
667 }
668  
669 2 ▶sub isnt_blessed {
Subroutine isnt_blessed: called CC=1 SCAR=0.0
Pod documented
670 1 my ($self, $data, @args) = @_;
671  
672 1 return $self->fail(Venus::is_blessed($data), @args);
673 }
674  
675 2 ▶sub isnt_boolean {
Subroutine isnt_boolean: called CC=1 SCAR=0.0
Pod documented
676 1 my ($self, $data, @args) = @_;
677  
678 1 return $self->fail(Venus::is_boolean($data), @args);
679 }
680  
681 2 ▶sub isnt_coderef {
Subroutine isnt_coderef: called CC=1 SCAR=0.0
Pod documented
682 1 my ($self, $data, @args) = @_;
683  
684 1 return $self->fail(Venus::is_coderef($data), @args);
685 }
686  
687 2 ▶sub isnt_dirhandle {
Subroutine isnt_dirhandle: called CC=1 SCAR=0.0
Pod documented
688 1 my ($self, $data, @args) = @_;
689  
690 1 return $self->fail(Venus::is_dirhandle($data), @args);
691 }
692  
693 2 ▶sub isnt_enum {
Subroutine isnt_enum: called CC=1 SCAR=0.0
Pod documented
694 1 my ($self, $data, @args) = @_;
695  
696 1 return $self->fail(Venus::is_enum($data), @args);
697 }
698  
699 2 ▶sub isnt_error {
Subroutine isnt_error: called CC=1 SCAR=0.0
Pod documented
700 1 my ($self, $data, @args) = @_;
701  
702 1 return $self->fail(Venus::is_error($data), @args);
703 }
704  
705 2 ▶sub isnt_false {
Subroutine isnt_false: called CC=1 SCAR=0.0
Pod documented
706 1 my ($self, $data, @args) = @_;
707  
708 1 return $self->fail(Venus::is_false($data), @args);
709 }
710  
711 2 ▶sub isnt_fault {
Subroutine isnt_fault: called CC=1 SCAR=0.0
Pod documented
712 1 my ($self, $data, @args) = @_;
713  
714 1 return $self->fail(Venus::is_fault($data), @args);
715 }
716  
717 2 ▶sub isnt_filehandle {
Subroutine isnt_filehandle: called CC=1 SCAR=0.0
Pod documented
718 1 my ($self, $data, @args) = @_;
719  
720 1 return $self->fail(Venus::is_filehandle($data), @args);
721 }
722  
723 2 ▶sub isnt_float {
Subroutine isnt_float: called CC=1 SCAR=0.0
Pod documented
724 1 my ($self, $data, @args) = @_;
725  
726 1 return $self->fail(Venus::is_float($data), @args);
727 }
728  
729 2 ▶sub isnt_glob {
Subroutine isnt_glob: called CC=1 SCAR=0.0
Pod documented
730 1 my ($self, $data, @args) = @_;
731  
732 1 return $self->fail(Venus::is_glob($data), @args);
733 }
734  
735 2 ▶sub isnt_hashref {
Subroutine isnt_hashref: called CC=1 SCAR=0.0
Pod documented
736 1 my ($self, $data, @args) = @_;
737  
738 1 return $self->fail(Venus::is_hashref($data), @args);
739 }
740  
741 2 ▶sub isnt_number {
Subroutine isnt_number: called CC=1 SCAR=0.0
Pod documented
742 1 my ($self, $data, @args) = @_;
743  
744 1 return $self->fail(Venus::is_number($data), @args);
745 }
746  
747 2 ▶sub isnt_object {
Subroutine isnt_object: called CC=1 SCAR=0.0
Pod documented
748 1 my ($self, $data, @args) = @_;
749  
750 1 return $self->fail(Venus::is_object($data), @args);
751 }
752  
753 2 ▶sub isnt_package {
Subroutine isnt_package: called CC=1 SCAR=0.0
Pod documented
754 1 my ($self, $data, @args) = @_;
755  
756 1 return $self->fail(Venus::is_package($data), @args);
757 }
758  
759 2 ▶sub isnt_reference {
Subroutine isnt_reference: called CC=1 SCAR=0.0
Pod documented
760 1 my ($self, $data, @args) = @_;
761  
762 1 return $self->fail(Venus::is_reference($data), @args);
763 }
764  
765 2 ▶sub isnt_regexp {
Subroutine isnt_regexp: called CC=1 SCAR=0.0
Pod documented
766 1 my ($self, $data, @args) = @_;
767  
768 1 return $self->fail(Venus::is_regexp($data), @args);
769 }
770  
771 2 ▶sub isnt_scalarref {
Subroutine isnt_scalarref: called CC=1 SCAR=0.0
Pod documented
772 1 my ($self, $data, @args) = @_;
773  
774 1 return $self->fail(Venus::is_scalarref($data), @args);
775 }
776  
777 2 ▶sub isnt_string {
Subroutine isnt_string: called CC=1 SCAR=0.0
Pod documented
778 1 my ($self, $data, @args) = @_;
779  
780 1 return $self->fail(Venus::is_string($data), @args);
781 }
782  
783 2 ▶sub isnt_true {
Subroutine isnt_true: called CC=1 SCAR=0.0
Pod documented
784 1 my ($self, $data, @args) = @_;
785  
786 1 return $self->fail(Venus::is_true($data), @args);
787 }
788  
789 2 ▶sub isnt_undef {
Subroutine isnt_undef: called CC=1 SCAR=0.0
Pod documented
790 1 my ($self, $data, @args) = @_;
791  
792 1 return $self->fail(Venus::is_undef($data), @args);
793 }
794  
795 2 ▶sub isnt_value {
Subroutine isnt_value: called CC=1 SCAR=0.0
Pod documented
796 1 my ($self, $data, @args) = @_;
797  
798 1 return $self->fail(Venus::is_value($data), @args);
799 }
800  
801 2 ▶sub isnt_yesno {
Subroutine isnt_yesno: called CC=1 SCAR=0.0
Pod documented
802 1 my ($self, $data, @args) = @_;
803  
804 1 return $self->fail(Venus::is_yesno($data), @args);
805 }
806  
807 2 ▶sub lfile {
Subroutine lfile: called CC=1 SCAR=0.0
Pod documented
808 1 my ($self) = @_;
809  
810 1 my $lfile = $self->space->format('lfile', 'lib/%s');
811  
812 1 return $lfile;
813 }
814  
815 3 ▶sub like {
Subroutine like: called CC=2 SCAR=6.9
Pod documented
816 2 my ($self, $this, $that, @args) = @_;
817  
818 2 ▶ $that = qr/$that/ if ref $that ne 'Regexp';
Branch: 1 branch
BranchTrueFalseTotal
if ref $that ne "Regexp" 1 2 3
819  
820 2 my $result = $self->handler('like', $this, $that, @args);
821  
822 2 return $result;
823 }
824  
825 2 ▶sub mktemp_dir {
Subroutine mktemp_dir: called CC=1 SCAR=0.0
Pod documented
826 1 my ($self) = @_;
827  
828 1 my $path = $self->path;
829  
830 1 return $path->mktemp_dir;
831 }
832  
833 2 ▶sub mktemp_file {
Subroutine mktemp_file: called CC=1 SCAR=0.0
Pod documented
834 1 my ($self) = @_;
835  
836 1 my $path = $self->path;
837  
838 1 return $path->mktemp_file;
839 }
840  
841 0 ▶sub note {
Subroutine note: not called CC=1 SCAR=6.9
Pod documented
842 0 my ($self, @args) = @_;
843  
844 0 $self->handler('diag', $self->explain(@args));
845  
846 0 return;
847 }
848  
849 10 ▶sub only_if {
Subroutine only_if: called CC=1 SCAR=0.0
Pod documented
850 10 my ($self, $what, @args) = @_;
851  
852 10 local $_ = $self;
853  
854 return $self->gate(
855 10 ▶ (join ' ', 'only_if', grep {!ref} $what), sub {$self->$what(@args) ? true : false}
Subroutine __ANON__: called CC=2 SCAR=6.9
Branch: 1 branch
BranchTrueFalseTotal
$self->$what(@args) ? : 1 9 10
856 10 );
857 }
858  
859 34 ▶sub os {
Subroutine os: called CC=2 SCAR=6.9
Pod documented
860 34 my ($self) = @_;
861  
862 34 my $os;
863  
864 34 require Venus::Os;
865  
866 34 $os = $self->encased('os');
867  
868 34 ▶ return $os if $os;
Branch: 1 branch
BranchTrueFalseTotal
if $os 21 14 35
869  
870 13 $os = Venus::Os->new;
871  
872 13 return $self->recase('os', $os);
873 }
874  
875 2 ▶sub os_is_bsd {
Subroutine os_is_bsd: called CC=1 SCAR=0.0
Pod documented
876 2 my ($self) = @_;
877  
878 2 return $self->os->is_bsd;
879 }
880  
881 2 ▶sub os_is_cyg {
Subroutine os_is_cyg: called CC=1 SCAR=0.0
Pod documented
882 2 my ($self) = @_;
883  
884 2 return $self->os->is_cyg;
885 }
886  
887 2 ▶sub os_is_dos {
Subroutine os_is_dos: called CC=1 SCAR=0.0
Pod documented
888 2 my ($self) = @_;
889  
890 2 return $self->os->is_dos;
891 }
892  
893 3 ▶sub os_is_lin {
Subroutine os_is_lin: called CC=1 SCAR=0.0
Pod documented
894 3 my ($self) = @_;
895  
896 3 return $self->os->is_lin;
897 }
898  
899 2 ▶sub os_is_mac {
Subroutine os_is_mac: called CC=1 SCAR=0.0
Pod documented
900 2 my ($self) = @_;
901  
902 2 return $self->os->is_mac;
903 }
904  
905 2 ▶sub os_is_non {
Subroutine os_is_non: called CC=1 SCAR=0.0
Pod documented
906 2 my ($self) = @_;
907  
908 2 return $self->os->is_non;
909 }
910  
911 2 ▶sub os_is_sun {
Subroutine os_is_sun: called CC=1 SCAR=0.0
Pod documented
912 2 my ($self) = @_;
913  
914 2 return $self->os->is_sun;
915 }
916  
917 2 ▶sub os_is_vms {
Subroutine os_is_vms: called CC=1 SCAR=0.0
Pod documented
918 2 my ($self) = @_;
919  
920 2 return $self->os->is_vms;
921 }
922  
923 8 ▶sub os_is_win {
Subroutine os_is_win: called CC=1 SCAR=0.0
Pod documented
924 8 my ($self) = @_;
925  
926 8 return $self->os->is_win;
927 }
928  
929 1 ▶sub os_isnt_bsd {
Subroutine os_isnt_bsd: called CC=2 SCAR=7.2
Pod documented
930 1 my ($self) = @_;
931  
932 1 ▶ return $self->os->is_bsd ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_bsd ? : 0 2 2
933 }
934  
935 1 ▶sub os_isnt_cyg {
Subroutine os_isnt_cyg: called CC=2 SCAR=7.2
Pod documented
936 1 my ($self) = @_;
937  
938 1 ▶ return $self->os->is_cyg ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_cyg ? : 0 2 2
939 }
940  
941 1 ▶sub os_isnt_dos {
Subroutine os_isnt_dos: called CC=2 SCAR=7.2
Pod documented
942 1 my ($self) = @_;
943  
944 1 ▶ return $self->os->is_dos ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_dos ? : 0 2 2
945 }
946  
947 0 ▶sub os_isnt_lin {
Subroutine os_isnt_lin: not called CC=2 SCAR=13.0
Pod documented
948 0 my ($self) = @_;
949  
950 0 ▶ return $self->os->is_lin ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_lin ? : 0 1 1
951 }
952  
953 1 ▶sub os_isnt_mac {
Subroutine os_isnt_mac: called CC=2 SCAR=7.2
Pod documented
954 1 my ($self) = @_;
955  
956 1 ▶ return $self->os->is_mac ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_mac ? : 0 2 2
957 }
958  
959 1 ▶sub os_isnt_non {
Subroutine os_isnt_non: called CC=2 SCAR=7.2
Pod documented
960 1 my ($self) = @_;
961  
962 1 ▶ return $self->os->is_non ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_non ? : 0 2 2
963 }
964  
965 1 ▶sub os_isnt_sun {
Subroutine os_isnt_sun: called CC=2 SCAR=7.2
Pod documented
966 1 my ($self) = @_;
967  
968 1 ▶ return $self->os->is_sun ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_sun ? : 0 2 2
969 }
970  
971 1 ▶sub os_isnt_vms {
Subroutine os_isnt_vms: called CC=2 SCAR=7.2
Pod documented
972 1 my ($self) = @_;
973  
974 1 ▶ return $self->os->is_vms ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_vms ? : 0 2 2
975 }
976  
977 1 ▶sub os_isnt_win {
Subroutine os_isnt_win: called CC=2 SCAR=7.2
Pod documented
978 1 my ($self) = @_;
979  
980 1 ▶ return $self->os->is_win ? false : true;
Branch: 1 branch
BranchTrueFalseTotal
$self->os->is_win ? : 0 2 2
981 }
982  
983 18377 ▶sub pass {
Subroutine pass: called CC=1 SCAR=0.0
Pod documented
984 18377 my ($self, $bool, @args) = @_;
985  
986 18377 my $result = $self->handler('ok', $bool, @args);
987  
988 18377 return $result;
989 }
990  
991 2 ▶sub patch {
Subroutine patch: called CC=1 SCAR=0.0
Pod documented
992 2 my ($self, $name, $code) = @_;
993  
994 2 my $space = $self->space;
995  
996 2 $space->patch($name, $code);
997  
998 2 my $patched = $space->{patched}->{$name};
999  
1000 2 return $patched;
1001 }
1002  
1003 3 ▶sub path {
Subroutine path: called CC=2 SCAR=7.0
Pod documented
1004 3 my ($self, $file) = @_;
1005  
1006 3 ▶ $file ||= $self->file;
Condition66%2/3
$file ||= $self->file
l!l&&r!l&&!r
120
MC/DC0%0/2
$file ||= $self->file
$file $self->file
Truth table66%2/3
A ||= B
A= $fileB= $self->file
ABresult
1X1
011
000
1007  
1008 3 require Venus::Path;
1009  
1010 3 return Venus::Path->new($file);
1011 }
1012  
1013 1 ▶sub pfile {
Subroutine pfile: called CC=1 SCAR=0.0
Pod documented
1014 1 my ($self) = @_;
1015  
1016 1 my $pfile = $self->space->format('pfile', 'lib/%s');
1017  
1018 1 return $pfile;
1019 }
1020  
1021 1 ▶sub render {
Subroutine render: called CC=3 SCAR=11.0
Pod documented
1022 1 my ($self, $file) = @_;
1023  
1024 1 ▶ $file ||= $self->pfile;
Condition33%1/3
$file ||= $self->pfile
l!l&&r!l&&!r
100
MC/DC0%0/2
$file ||= $self->pfile
$file $self->pfile
Truth table33%1/3
A ||= B
A= $fileB= $self->pfile
ABresult
1X1
011
000
1025  
1026 1 require Venus::Path;
1027  
1028 1 my $path = Venus::Path->new($file);
1029  
1030 1 $path->parent->mkdirs;
1031  
1032 1 my @layout = split /\r?\n/, join "\n\n", $self->collect('layout');
1033  
1034 1 my @output;
1035  
1036 1 for my $item (grep {length} @layout) {
1037 20 push @output, grep {length} $self->present(split /:\s*/, $item);
1038 }
1039  
1040 1 $path->write(join "\n", @output);
1041  
1042 1 $self->recase('rendered', true);
1043  
1044 1 return $path;
1045 }
1046  
1047 1 ▶sub same {
Subroutine same: called CC=1 SCAR=0.0
Pod documented
1048 1 my ($self, $this, $that, @args) = @_;
1049  
1050 1 my $result = $self->handler('is_deeply', $this, $that, @args);
1051  
1052 1 return $result;
1053 }
1054  
1055 10 ▶sub skip {
Subroutine skip: called CC=1 SCAR=0.0
Pod documented
1056 10 my ($self, $note) = @_;
1057  
1058 10 return $self->handler('plan', 'skip_all', $note);
1059 }
1060  
1061 16 ▶sub skip_if {
Subroutine skip_if: called CC=1 SCAR=0.0
Pod documented
1062 16 my ($self, $what, @args) = @_;
1063  
1064 16 local $_ = $self;
1065  
1066 return $self->gate(
1067 16 ▶ (join ' ', 'skip_if', grep {!ref} $what), sub {$self->$what(@args) ? false : true}
Subroutine __ANON__: called CC=2 SCAR=6.9
Branch: 1 branch
BranchTrueFalseTotal
$self->$what(@args) ? : 1 15 16
1068 16 );
1069 }
1070  
1071 17 ▶sub space {
Subroutine space: called CC=4 SCAR=13.9
Pod documented
1072 17 my ($self, $name) = @_;
1073  
1074 17 my $space;
1075  
1076 17 require Venus::Space;
1077  
1078 17 ▶ $space = Venus::Space->new($name) if $name;
Branch: 1 branch
BranchTrueFalseTotal
if $name 9 9 18
1079  
1080 17 ▶ return $space if $name;
Branch: 1 branch
BranchTrueFalseTotal
if $name 9 9 18
1081  
1082 8 $space = $self->encased('space');
1083  
1084 8 ▶ return $space if $space;
Branch: 1 branch
BranchTrueFalseTotal
if $space 2 7 9
1085  
1086 6 $space = Venus::Space->new($self->collect('name'));
1087  
1088 6 return $self->recase('space', $space);
1089 }
1090  
1091 6411 ▶sub subtest {
Subroutine subtest: called CC=3 SCAR=11.0
Pod documented
1092 6411 my ($self, $name, $code) = @_;
1093  
1094 6411 my $gate = $self->encased('gate');
1095  
1096 24 ▶ my $callback = !$gate ? $code : sub {
Subroutine __ANON__: called CC=3 SCAR=11.1
1097 24 ▶ ($gate->[1] && $gate->[1]->()) ? $code->() : $self->skip($gate->[0]);
Branch: 1 branch
BranchTrueFalseTotal
$gate->[1] && $gate->[1]->() ? : 15 10 25
Condition66%2/3
$gate->[1] and $gate->[1]->()
!ll&&!rl&&r
0915
MC/DC50%1/2
$gate->[1] and $gate->[1]->()
$gate->[1] $gate->[1]->()
Truth table66%2/3
A and B
A= $gate->[1]B= $gate->[1]->()
ABresult
0X0
100
111
1098 6411 ▶ };
Branch: 1 branch
BranchTrueFalseTotal
!$gate ? : 6387 25 6412
1099  
1100 6411 my $result = $self->handler('subtest', $name, $callback);
1101  
1102 6411 ▶ $self->unpatch if $self->auto('unpatch');
Branch: 1 branch
BranchTrueFalseTotal
if $self->auto("unpatch") 0 6412 6412
1103  
1104 6411 return $result;
1105 }
1106  
1107 12169 ▶sub text {
Subroutine text: called CC=2 SCAR=6.9
Pod documented
1108 12169 my ($self) = @_;
1109  
1110 12169 my $text;
1111  
1112 12169 $text = $self->encased('text');
1113  
1114 12169 ▶ return $text if $text;
Branch: 1 branch
BranchTrueFalseTotal
if $text 11771 399 12170
1115  
1116 398 require Venus::Text::Pod;
1117  
1118 398 $text = Venus::Text::Pod->new($self->file);
1119  
1120 398 return $self->recase('text', $text);
1121 }
1122  
1123 1 ▶sub tfile {
Subroutine tfile: called CC=1 SCAR=0.0
Pod documented
1124 1 my ($self) = @_;
1125  
1126 1 my $tfile = $self->space->format('tfile', 't/%s');
1127  
1128 1 return $tfile;
1129 }
1130  
1131 7 ▶sub type {
Subroutine type: called CC=1 SCAR=0.0
Pod documented
1132 7 my ($self, $data, $expr, @args) = @_;
1133  
1134 7 require Venus::Type;
1135  
1136 7 my $type = Venus::Type->new;
1137  
1138 7 return $self->pass($type->check($expr)->eval($data), @args);
1139 }
1140  
1141 1 ▶sub unlike {
Subroutine unlike: called CC=2 SCAR=7.0
Pod documented
1142 1 my ($self, $this, $that, @args) = @_;
1143  
1144 1 ▶ $that = qr/$that/ if ref $that ne 'Regexp';
Branch: 1 branch
BranchTrueFalseTotal
if ref $that ne "Regexp" 0 2 2
1145  
1146 1 my $result = $self->handler('unlike', $this, $that, @args);
1147  
1148 1 return $result;
1149 }
1150  
1151 2 ▶sub unpatch {
Subroutine unpatch: called CC=1 SCAR=0.0
Pod documented
1152 2 my ($self, @args) = @_;
1153  
1154 2 my $space = $self->space;
1155  
1156 2 return $space->unpatch(@args);
1157 }
1158  
1159 # COMPATIBILITY
1160  
1161 119 *data = *text; # deprecated since 4.15
1162 119 *more = *handler; # deprecated since 4.15
1163 119 *okay = *pass; # deprecated since 4.15
1164  
1165 # ERRORS
1166  
1167 0 ▶sub error_on_missing {
Subroutine error_on_missing: not called CC=1 SCAR=6.9
Pod undocumented
1168 0 my ($self, $data) = @_;
1169  
1170 0 my $error = $self->error->sysinfo;
1171  
1172 0 my $message = 'Can\'t locate object method "{{method}}" via package "{{class}}"';
1173  
1174 0 $error->name('on.missing');
1175 0 $error->message($message);
1176 0 $error->offset(1);
1177 0 $error->stash($data);
1178 0 $error->reset;
1179  
1180 0 return $error;
1181 }
1182  
1183 0 ▶sub error_on_new {
Subroutine error_on_new: not called CC=1 SCAR=6.9
Pod undocumented
1184 0 my ($self, $data) = @_;
1185  
1186 0 my $error = $self->error->sysinfo;
1187  
1188 0 my $message = 'Test file "{{file}}" missing {{block}} block';
1189  
1190 0 $error->name('on.new');
1191 0 $error->message($message);
1192 0 $error->offset(1);
1193 0 $error->stash($data);
1194 0 $error->reset;
1195  
1196 0 return $error;
1197 }
1198  
1199 # AUTOLOAD
1200  
1201 23517 ▶sub AUTOLOAD {
Subroutine AUTOLOAD: called CC=281 SCAR=77.1
1202 23517 my ($self, @args) = @_;
1203  
1204 23517 our $AUTOLOAD;
1205 23517 my $method = $AUTOLOAD =~ s/.*:://r;
1206  
1207 # Handle collect method
1208 23517 ▶ if ($method eq 'collect' && @args) {
Branch: 1 branch
BranchTrueFalseTotal
if ($method eq "collect" and @args) 8706 14812 23518
Condition66%2/3
$method eq "collect" and @args
!ll&&!rl&&r
1481108706
MC/DC50%1/2
$method eq "collect" and @args
$method eq "collect" @args
Truth table66%2/3
A and B
A= $method eq "collect"B= @args
ABresult
0X0
100
111
1209 8706 my ($name) = shift @args;
1210 8706 $method = "collect_data_for_${name}";
1211 8706 ▶ return $self->$method(@args) if $self->can($method);
Branch: 1 branch
BranchTrueFalseTotal
if $self->can($method) 0 8707 8707
1212 }
1213  
1214 # Handle collect_data_for_* methods using config
1215 23517 ▶ if (my ($block) = $method =~ /^collect_data_for_(\w+)$/) {
Branch: 1 branch
BranchTrueFalseTotal
if (my($block) = $method =~ /^collect_data_for_(\w+)$/u) 9800 13718 23518
1216 9800 ▶ if ($method eq 'collect_data_for_layout') {
Branch: 3 branches
BranchTrueFalseTotal
if ($method eq 'collect_data_for_layout') { } 5 9796 9801
elsif ($method eq 'collect_data_for_version') { } 4 9792 9796
elsif (my $config = $Venus::Test::CONFIG->{'block'}{$block}) { } 9791 1 9792
1217 5 my ($find) = $self->data->find(undef, 'layout');
1218  
1219 my $data = $find ? $find->{data} : [
1220 5 ▶ 'encoding',
Branch: 1 branch
BranchTrueFalseTotal
$find ? : 4 2 6
1221 'name',
1222 'abstract',
1223 'version',
1224 'synopsis',
1225 'description',
1226 'attributes: attribute',
1227 'inherits',
1228 'integrates',
1229 'libraries',
1230 'functions: function',
1231 'methods: method',
1232 'messages: message',
1233 'features: feature',
1234 'errors: error',
1235 'operators: operator',
1236 'partials',
1237 'authors',
1238 'license',
1239 'project',
1240 ];
1241  
1242 5 ▶ return wantarray ? (@{$data}) : $data;
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 2 4 6
1243 }
1244 elsif ($method eq 'collect_data_for_version') {
1245 4 my ($find) = $self->data->find(undef, 'version');
1246  
1247 4 ▶ my $data = $find ? $find->{data} : [];
Branch: 1 branch
BranchTrueFalseTotal
$find ? : 3 2 5
1248  
1249 4 require Venus::Space;
1250  
1251 4 ▶ if (!@{$data} && (my ($name) = $self->collect('name'))) {
Branch: 1 branch
BranchTrueFalseTotal
if (not @{$data;} and my($name) = $self->collect("name")) 1 4 5
Condition66%2/3
not @{$data;} and my($name) = $self->collect("name")
!ll&&!rl&&r
301
MC/DC50%1/2
not @{$data;} and my($name) = $self->collect("name")
not @{$data;} my($name) = $self->collect("name")
Truth table66%2/3
not(A) and B
A= not @{$data;}B= my($name) = $self->collect("name")
ABresult
0X0
100
111
1252 1 ▶ @{$data} = (Venus::Space->new($name)->version) || ();
Condition33%1/3
'Venus::Space'->new($name)->version || ()
l!l&&r!l&&!r
001
MC/DC0%0/2
'Venus::Space'->new($name)->version || ()
'Venus::Space'->new($name)->version ()
Truth table33%1/3
A || B
A= 'Venus::Space'->new($name)->versionB= ()
ABresult
1X1
011
000
1253 }
1254  
1255 4 ▶ return wantarray ? (@{$data}) : $data;
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 2 3 5
1256 }
1257 elsif (my $config = $CONFIG->{block}{$block}) {
1258 9791 my $find_spec = $config->{find};
1259 9791 my ($list, $name) = @{$find_spec}{qw(list name)};
1260  
1261 9791 ▶ if ($block eq 'example' && @args == 2) {
Branch: 1 branch
BranchTrueFalseTotal
if ($block eq "example" and @args == 2) 5521 4271 9792
Condition66%2/3
$block eq "example" and @args == 2
!ll&&!rl&&r
427005521
MC/DC50%1/2
$block eq "example" and @args == 2
$block eq "example" @args == 2
Truth table66%2/3
A and B
A= $block eq "example"B= @args == 2
ABresult
0X0
100
111
1262 5521 my ($number, $arg_name) = @args;
1263 5521 my ($find) = $self->text->find("example-$number", $arg_name);
1264 5521 ▶ my $data = $find ? $find->{data} : [];
Branch: 1 branch
BranchTrueFalseTotal
$find ? : 5520 2 5522
1265 5521 ▶ return wantarray ? (@{$data}) : $data;
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 299 5223 5522
1266 }
1267  
1268 4270 ▶ my ($find) = defined($list)
Branch: 2 branches
BranchTrueFalseTotal
defined $list ? : 844 3427 4271
@args ? : 844 1 845
1269 ? $self->text->find($list, @args ? $args[0] : undef)
1270 : $self->text->find(undef, $name);
1271  
1272 4270 ▶ my $data = $find ? $find->{data} : [];
Branch: 1 branch
BranchTrueFalseTotal
$find ? : 4258 13 4271
1273  
1274 # special-case: encoding
1275 4270 ▶ if ($block eq 'encoding') {
Branch: 1 branch
BranchTrueFalseTotal
if ($block eq "encoding") 6 4265 4271
1276 6 @{$data} = (map {map uc, split /\r?\n+/} @{$data});
1277 }
1278  
1279 # special-case: includes
1280 4270 ▶ if ($block eq 'includes') {
Branch: 1 branch
BranchTrueFalseTotal
if ($block eq "includes") 115 4156 4271
1281 115 @{$data} = grep !/^#/, grep /\w/, map {split/\n/} @{$data};
1282 }
1283  
1284 4270 ▶ return wantarray ? (@{$data}) : $data;
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 3195 1076 4271
1285 }
1286 }
1287  
1288 # Handle execute method
1289 13717 ▶ if ($method eq 'execute' && @args) {
Branch: 1 branch
BranchTrueFalseTotal
if ($method eq "execute" and @args) 6403 7315 13718
Condition66%2/3
$method eq "execute" and @args
!ll&&!rl&&r
731406403
MC/DC50%1/2
$method eq "execute" and @args
$method eq "execute" @args
Truth table66%2/3
A and B
A= $method eq "execute"B= @args
ABresult
0X0
100
111
1290 6403 my ($name) = shift @args;
1291 6403 $method = "execute_test_for_${name}";
1292 6403 ▶ return $self->$method(@args) if $self->can($method);
Branch: 1 branch
BranchTrueFalseTotal
if $self->can($method) 0 6404 6404
1293 }
1294  
1295 # Handle execute_test_for_* methods using config
1296 13717 ▶ if (my ($block) = $method =~ /^execute_test_for_(\w+)$/) {
Branch: 1 branch
BranchTrueFalseTotal
if (my($block) = $method =~ /^execute_test_for_(\w+)$/u) 6423 7295 13718
1297 6423 ▶ if ($method eq 'execute_test_for_attributes') {
Branch: 6 branches
BranchTrueFalseTotal
if ($method eq 'execute_test_for_attributes') { } 13 6410 6423
elsif ($method eq 'execute_test_for_example') { } 5220 1190 6410
elsif ($method eq 'execute_test_for_raise') { } 53 1137 1190
elsif ($method eq 'execute_test_for_synopsis') { } 121 1016 1137
elsif ($method eq 'execute_test_for_name') { } 122 894 1016
elsif (my $config = $Venus::Test::CONFIG->{'block'}{$block}) { } 894 0 894
1298 13 my ($code) = @args;
1299 13 my $data = $self->collect('attributes');
1300 13 my $result = $self->perform('attributes', $data);
1301 13 ▶ $result = $code->($data) if $code;
Branch: 1 branch
BranchTrueFalseTotal
if $code 0 13 13
1302 13 $self->pass($result, '=attributes');
1303 13 my ($package) = $self->collect('name');
1304 13 for my $line (@{$data}) {
1305 13 ▶ next if !$line;
Branch: 1 branch
BranchTrueFalseTotal
unless $line 0 13 13
1306 13 my ($name, $is, $pre, $isa, $def) = map { split /,\s*/ } split /:\s*/,
1307 $line, 2;
1308 13 $self->pass($package->can($name), "$package has $name");
1309 13 ▶ $self->pass((($is eq 'ro' || $is eq 'rw')
Condition41%5/12
($is eq 'ro' || $is eq 'rw') && ($pre eq 'opt' || $pre eq 'req') && $isa
!ll&&!rl&&r
0013
$is eq "ro" || $is eq "rw" and $pre eq "opt" || $pre eq "req"
!ll&&!rl&&r
0013
$is eq "ro" or $is eq "rw"
l!l&&r!l&&!r
1120
$pre eq "opt" or $pre eq "req"
l!l&&r!l&&!r
1300
MC/DC0%0/5
($is eq 'ro' || $is eq 'rw') && ($pre eq 'opt' || $pre eq 'req') && $isa
$is eq "ro" $is eq "rw" $pre eq "opt" $pre eq "req" $isa
Truth table18%2/11
A or B and C or D && E
A= $is eq "ro"B= $is eq "rw"C= $pre eq "opt"D= $pre eq "req"E= $isa
ABCDEresult
00XXX0
1X00X0
0100X0
1X1X00
1X0100
011X00
010100
1X1X11
1X0111
011X11
010111
1310 && ($pre eq 'opt' || $pre eq 'req')
1311 && $isa), $line);
1312 }
1313 13 return $result;
1314 }
1315 elsif ($method eq 'execute_test_for_example') {
1316 5220 my ($number, $name, $code) = @args;
1317 5220 my $data = $self->collect('example', $number, $name);
1318 5220 my $text = join "\n\n", @{$data};
1319 5220 my @includes;
1320 5220 ▶ if ($text =~ /.*#\s*given:\s*synopsis/m) {
Branch: 1 branch
BranchTrueFalseTotal
if ($text =~ /.*#\s*given:\s*synopsis/mu) 2371 2849 5220
1321 2371 my $line = $&;
1322 2371 ▶ if ($line !~ /#.*#\s*given:\s*synopsis/) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($line =~ /#.*#\s*given:\s*synopsis/u) 2336 35 2371
1323 2336 push @includes, $self->collect('synopsis');
1324 }
1325 }
1326 5220 for my $given ($text =~ /.*#\s*given:\s*example-((?:\d+)\s+(?:[\-\w]+))/gm) {
1327 34 my $line = $&;
1328 34 ▶ if ($line !~ /#.*#\s*given:\s*example-(?:\d+)\s+(?:[\-\w]+)/) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($line =~ /#.*#\s*given:\s*example-(?:\d+)\s+(?:[\-\w]+)/u) 34 0 34
1329 34 my ($number, $name) = split /\s+/, $given, 2;
1330 34 push @includes, $self->collect('example', $number, $name);
1331 }
1332 }
1333 5220 $text =~ s/.*#\s*given:\s*.*\n\n*//g;
1334 5220 $text = join "\n\n", @includes, $text;
1335 5220 my $result = $self->perform('example', $number, $name, $data);
1336 5220 $self->pass($result, "=example-$number $name");
1337 5220 ▶ $result = $code->($self->try('eval', $text)) if $code;
Branch: 1 branch
BranchTrueFalseTotal
if $code 5219 1 5220
1338 5220 ▶ $self->pass($result, "=example-$number $name returns ok") if $code;
Branch: 1 branch
BranchTrueFalseTotal
if $code 5219 1 5220
1339 5220 ▶ if ($self->auto('scrub')) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->auto("scrub")) 0 5220 5220
1340 0 state $name = $self->text->string(undef, 'name');
1341 0 for my $package ($text =~ /package\W+([\w:]+)/g) {
1342 0 ▶ next if $package eq 'main';
Branch: 1 branch
BranchTrueFalseTotal
if $package eq "main" 0 0 0
1343 0 ▶ next if $package eq __PACKAGE__;
Branch: 1 branch
BranchTrueFalseTotal
if $package eq __PACKAGE__ 0 0 0
1344 0 ▶ next if $package eq $name;
Branch: 1 branch
BranchTrueFalseTotal
if $package eq $name 0 0 0
1345 0 $self->space($package)->scrub;
1346 }
1347 }
1348 5220 return $result;
1349 }
1350 elsif ($method eq 'execute_test_for_raise') {
1351 53 my ($site, $class, $name, $code) = @args;
1352 53 my $data = do {
1353 53 my ($find) = $self->text->find($block, "$site $class $name");
1354 53 ▶ $find ? $find->{data} : [];
Branch: 1 branch
BranchTrueFalseTotal
$find ? : 53 0 53
1355 };
1356 53 my $text = join "\n\n", @{$data};
1357 53 my @includes;
1358 53 ▶ if ($text =~ /.*#\s*given:\s*synopsis/m) {
Branch: 1 branch
BranchTrueFalseTotal
if ($text =~ /.*#\s*given:\s*synopsis/mu) 32 21 53
1359 32 my $line = $&;
1360 32 ▶ if ($line !~ /#.*#\s*given:\s*synopsis/) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($line =~ /#.*#\s*given:\s*synopsis/u) 32 0 32
1361 32 push @includes, $self->collect('synopsis');
1362 }
1363 }
1364 53 for my $given ($text =~ /.*#\s*given:\s*example-((?:\d+)\s+(?:[\-\w]+))/gm) {
1365 0 my $line = $&;
1366 0 ▶ if ($line !~ /#.*#\s*given:\s*example-(?:\d+)\s+(?:[\-\w]+)/) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($line =~ /#.*#\s*given:\s*example-(?:\d+)\s+(?:[\-\w]+)/u) 0 0 0
1367 0 my ($number, $name) = split /\s+/, $given, 2;
1368 0 push @includes, $self->collect('example', $number, $name);
1369 }
1370 }
1371 53 $text =~ s/.*#\s*given:\s*.*\n\n*//g;
1372 53 $text = join "\n\n", @includes, $text;
1373 53 my $handle = join ' ', grep defined, $site, $class, $name;
1374 53 my $result = $self->perform('raise', $handle, $data);
1375 53 $self->pass($result, "=$handle");
1376 53 ▶ $result = $code->($self->try('eval', $text)) if $code;
Branch: 1 branch
BranchTrueFalseTotal
if $code 52 1 53
1377 53 ▶ $self->pass($result, "=error $site $class $name returns ok") if $code;
Branch: 1 branch
BranchTrueFalseTotal
if $code 52 1 53
1378 53 ▶ if ($self->auto('scrub')) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->auto("scrub")) 0 53 53
1379 0 state $name = $self->text->string(undef, 'name');
1380 0 for my $package ($text =~ /package\W+([\w:]+)/g) {
1381 0 ▶ next if $package eq 'main';
Branch: 1 branch
BranchTrueFalseTotal
if $package eq "main" 0 0 0
1382 0 ▶ next if $package eq __PACKAGE__;
Branch: 1 branch
BranchTrueFalseTotal
if $package eq __PACKAGE__ 0 0 0
1383 0 ▶ next if $package eq $name;
Branch: 1 branch
BranchTrueFalseTotal
if $package eq $name 0 0 0
1384 0 $self->space($package)->scrub;
1385 }
1386 }
1387 53 return $result;
1388 }
1389 elsif ($method eq 'execute_test_for_synopsis') {
1390 121 my ($code) = @args;
1391 121 my $data = $self->collect('synopsis');
1392 121 my $text = join "\n\n", @{$data};
1393 121 my @includes;
1394 121 for my $given ($text =~ /.*#\s*given:\s*example-((?:\d+)\s+(?:[\-\w]+))/gm) {
1395 0 my $line = $&;
1396 0 ▶ if ($line !~ /#.*#\s*given:\s*example-(?:\d+)\s+(?:[\-\w]+)/) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($line =~ /#.*#\s*given:\s*example-(?:\d+)\s+(?:[\-\w]+)/u) 0 0 0
1397 0 my ($number, $name) = split /\s+/, $given, 2;
1398 0 push @includes, $self->collect('example', $number, $name);
1399 }
1400 }
1401 121 $text =~ s/.*#\s*given:\s*.*\n\n*//g;
1402 121 $text = join "\n\n", @includes, $text;
1403 121 my $result = $self->perform('synopsis', $data);
1404 121 $self->pass($result, "=synopsis");
1405 121 ▶ $result = $code->($self->try('eval', $text)) if $code;
Branch: 1 branch
BranchTrueFalseTotal
if $code 120 1 121
1406 121 ▶ $self->pass($result, "=synopsis returns ok") if $code;
Branch: 1 branch
BranchTrueFalseTotal
if $code 120 1 121
1407 121 ▶ if ($self->auto('scrub')) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->auto("scrub")) 0 121 121
1408 0 state $name = $self->text->string(undef, 'name');
1409 0 for my $package ($text =~ /package\W+([\w:]+)/g) {
1410 0 ▶ next if $package eq 'main';
Branch: 1 branch
BranchTrueFalseTotal
if $package eq "main" 0 0 0
1411 0 ▶ next if $package eq __PACKAGE__;
Branch: 1 branch
BranchTrueFalseTotal
if $package eq __PACKAGE__ 0 0 0
1412 0 ▶ next if $package eq $name;
Branch: 1 branch
BranchTrueFalseTotal
if $package eq $name 0 0 0
1413 0 $self->space($package)->scrub;
1414 }
1415 }
1416 121 return $result;
1417 }
1418 elsif ($method eq 'execute_test_for_name') {
1419 122 my ($code) = @args;
1420 122 my ($text) = $self->collect_data_for_name;
1421 122 ▶ my $result = length($text) ? true : false;
Branch: 1 branch
BranchTrueFalseTotal
length $text ? : 122 0 122
1422 122 $self->pass($result, '=name content');
1423 122 $self->pass(scalar(eval("require $text")), "require $text");
1424 122 return $result;
1425 }
1426 elsif (my $config = $CONFIG->{block}{$block}) {
1427 894 my $find_spec = $config->{find};
1428 894 my ($list, $name) = @{$find_spec}{qw(list name)};
1429  
1430 894 ▶ my $code = ref($args[-1]) eq 'CODE' ? pop(@args) : undef;
Branch: 1 branch
BranchTrueFalseTotal
ref $args[-1] eq 'CODE' ? : 0 894 894
1431 894 my $collect = "collect_data_for_$block";
1432 894 my $data = $self->$collect(@args);
1433 894 my $perform = "perform_test_for_$block";
1434  
1435 894 ▶ my $result = $code
Branch: 3 branches
BranchTrueFalseTotal
$code ? : 0 894 894
defined $list ? : 0 0 0
defined $list ? : 186 708 894
1436 ? $code->(defined $list ? ($block, $data) : $data)
1437 : $self->$perform(defined $list ? ($block, $data) : $data);
1438  
1439 894 $self->pass($result, "=$block");
1440  
1441 894 return $result;
1442 }
1443 }
1444  
1445 # Handle perform method
1446 7294 ▶ if ($method eq 'perform' && @args) {
Branch: 1 branch
BranchTrueFalseTotal
if ($method eq "perform" and @args) 5408 1886 7294
Condition66%2/3
$method eq "perform" and @args
!ll&&!rl&&r
188605408
MC/DC50%1/2
$method eq "perform" and @args
$method eq "perform" @args
Truth table66%2/3
A and B
A= $method eq "perform"B= @args
ABresult
0X0
100
111
1447 5408 my ($name) = shift @args;
1448 5408 $method = "perform_test_for_${name}";
1449 5408 ▶ return $self->$method(@args) if $self->can($method);
Branch: 1 branch
BranchTrueFalseTotal
if $self->can($method) 0 5408 5408
1450 }
1451  
1452 # Handle perform_test_for_* methods using config
1453 7294 ▶ if (my ($block) = $method =~ /^perform_test_for_(\w+)$/) {
Branch: 1 branch
BranchTrueFalseTotal
if (my($block) = $method =~ /^perform_test_for_(\w+)$/u) 6302 992 7294
1454 6302 ▶ if ($method eq 'perform_test_for_example') {
Branch: 3 branches
BranchTrueFalseTotal
if ($method eq 'perform_test_for_example') { } 5220 1082 6302
elsif ($method eq 'perform_test_for_name') { } 1 1081 1082
elsif (my $config = $Venus::Test::CONFIG->{'block'}{$block}) { } 1081 0 1081
1455 5220 my ($number, $name, $data) = @args;
1456 5220 ▶ my $result = length(join "\n", @{$data}) ? true : false;
Branch: 1 branch
BranchTrueFalseTotal
length join("\n", @{$data;}) ? : 5220 0 5220
1457 5220 $self->pass($result, "=example-$number $name content");
1458 5220 return $result;
1459 }
1460 elsif ($method eq 'perform_test_for_name') {
1461 1 my ($data) = @args;
1462 1 my $text = join "\n", @{$data};
1463 1 ▶ my $result = length($text) ? true : false;
Branch: 1 branch
BranchTrueFalseTotal
length $text ? : 1 0 1
1464 1 $self->pass($result, '=name content');
1465 1 $self->pass(scalar(eval("require $text")), $self->explain('require', $text));
1466 1 return $result;
1467 }
1468 elsif (my $config = $CONFIG->{block}{$block}) {
1469 1081 my $find_spec = $config->{find};
1470 1081 my $list = $find_spec->{list};
1471 1081 ▶ my ($name, $data) = defined $list ? @args : (undef, $args[0]);
Branch: 1 branch
BranchTrueFalseTotal
defined $list ? : 239 842 1081
1472 1081 ▶ my $result = length(join "\n", @{$data}) ? true : false;
Branch: 1 branch
BranchTrueFalseTotal
length join("\n", @{$data;}) ? : 1081 0 1081
1473 1081 ▶ $self->pass($result, defined $list ? "=$block $name content" : "=$block content");
Branch: 1 branch
BranchTrueFalseTotal
defined $list ? : 239 842 1081
1474 1081 return $result;
1475 }
1476 }
1477  
1478 # Handle present method
1479 992 ▶ if ($method eq 'present' && @args) {
Branch: 1 branch
BranchTrueFalseTotal
if ($method eq "present" and @args) 360 632 992
Condition66%2/3
$method eq "present" and @args
!ll&&!rl&&r
6320360
MC/DC50%1/2
$method eq "present" and @args
$method eq "present" @args
Truth table66%2/3
A and B
A= $method eq "present"B= @args
ABresult
0X0
100
111
1480 360 my ($name) = shift @args;
1481 360 $method = "present_data_for_${name}";
1482 360 ▶ return $self->$method(@args) if $self->can($method);
Branch: 1 branch
BranchTrueFalseTotal
if $self->can($method) 0 360 360
1483 }
1484  
1485 # Handle present_data_for_* methods using config
1486 992 ▶ if (my ($block) = $method =~ /^present_data_for_(\w+)$/) {
Branch: 1 branch
BranchTrueFalseTotal
if (my($block) = $method =~ /^present_data_for_(\w+)$/u) 989 3 992
1487 # special-case: present_data_for_abstract
1488 989 ▶ if ($method eq 'present_data_for_abstract') {
Branch: 43 branches
BranchTrueFalseTotal
if ($method eq 'present_data_for_abstract') { } 2 987 989
elsif ($method eq 'present_data_for_attribute') { } 1 986 987
elsif ($method eq 'present_data_for_attribute_type1') { } 0 986 986
elsif ($method eq 'present_data_for_attribute_type2') { } 2 984 986
elsif ($method eq 'present_data_for_attributes') { } 1 983 984
elsif ($method eq 'present_data_for_attributes_type1') { } 0 983 983
elsif ($method eq 'present_data_for_attributes_type2') { } 1 982 983
elsif ($method eq 'present_data_for_authors') { } 3 979 982
elsif ($method eq 'present_data_for_description') { } 2 977 979
elsif ($method eq 'present_data_for_encoding') { } 2 975 977
elsif ($method eq 'present_data_for_error') { } 1 974 975
elsif ($method eq 'present_data_for_errors') { } 1 973 974
elsif ($method eq 'present_data_for_example') { } 130 843 973
elsif ($method eq 'present_data_for_feature') { } 103 740 843
elsif ($method eq 'present_data_for_features') { } 1 739 740
elsif ($method eq 'present_data_for_function') { } 2 737 739
elsif ($method eq 'present_data_for_functions') { } 1 736 737
elsif ($method eq 'present_data_for_head1') { } 21 715 736
elsif ($method eq 'present_data_for_head2') { } 106 609 715
elsif ($method eq 'present_data_for_includes') { } 1 608 609
elsif ($method eq 'present_data_for_inherits') { } 2 606 608
elsif ($method eq 'present_data_for_integrates') { } 2 604 606
elsif ($method eq 'present_data_for_item') { } 237 367 604
elsif ($method eq 'present_data_for_layout') { } 1 366 367
elsif ($method eq 'present_data_for_libraries') { } 2 364 366
elsif ($method eq 'present_data_for_license') { } 3 361 364
elsif ($method eq 'present_data_for_link') { } 7 354 361
elsif ($method eq 'present_data_for_message') { } 1 353 354
elsif ($method eq 'present_data_for_messages') { } 1 352 353
elsif ($method eq 'present_data_for_metadata') { } 1 351 352
elsif ($method eq 'present_data_for_method') { } 102 249 351
elsif ($method eq 'present_data_for_methods') { } 1 248 249
elsif ($method eq 'present_data_for_name') { } 3 245 248
elsif ($method eq 'present_data_for_operator') { } 1 244 245
elsif ($method eq 'present_data_for_operators') { } 1 243 244
elsif ($method eq 'present_data_for_over') { } 237 6 243
elsif ($method eq 'present_data_for_partial') { } 2 4 6
elsif ($method eq 'present_data_for_partials') { } 1 3 4
elsif ($method eq 'present_data_for_project') { } 1 2 3
elsif ($method eq 'present_data_for_signature') { } 0 2 2
elsif ($method eq 'present_data_for_synopsis') { } 1 1 2
elsif ($method eq 'present_data_for_tagline') { } 0 1 1
elsif ($method eq 'present_data_for_version') { } 1 0 1
1489 2 my @data = $self->collect('abstract');
1490 2 ▶ return @data ? ($self->present_data_for_head1('abstract', @data)) : ();
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 2 0 2
1491 }
1492 # special-case: present_data_for_attribute
1493 elsif ($method eq 'present_data_for_attribute') {
1494 1 my ($name) = @args;
1495 1 return $self->present_data_for_attribute_type2($name);
1496 }
1497 # special-case: present_data_for_attribute_type1
1498 elsif ($method eq 'present_data_for_attribute_type1') {
1499 0 my ($name, $is, $pre, $isa, $def) = @args;
1500 0 my @output;
1501 0 ▶ $is = $is eq 'ro' ? 'read-only' : 'read-write';
Branch: 1 branch
BranchTrueFalseTotal
$is eq 'ro' ? : 0 0 0
1502 0 ▶ $pre = $pre eq 'req' ? 'required' : 'optional';
Branch: 1 branch
BranchTrueFalseTotal
$pre eq 'req' ? : 0 0 0
1503 0 push @output, " $name($isa)\n";
1504 0 ▶ push @output, "This attribute is $is, accepts C<($isa)> values, ". (
Branch: 1 branch
BranchTrueFalseTotal
$def ? : 0 0 0
1505 $def ? "is $pre, and defaults to $def." : "and is $pre."
1506 );
1507 0 return ($self->present_data_for_head2($name, @output));
1508 }
1509 # special-case: present_data_for_attribute_type2
1510 elsif ($method eq 'present_data_for_attribute_type2') {
1511 2 my ($name) = @args;
1512 2 my @output;
1513 2 my ($metadata) = $self->collect('metadata', $name);
1514 2 my ($signature) = $self->collect('signature', $name);
1515 2 ▶ push @output, ($signature, '') if $signature;
Branch: 1 branch
BranchTrueFalseTotal
if $signature 1 1 2
1516 2 my @data = $self->collect('attribute', $name);
1517 2 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 2 2
1518 2 push @output, join "\n\n", @data;
1519 2 ▶ if ($metadata) {
Branch: 1 branch
BranchTrueFalseTotal
if ($metadata) 1 1 2
1520 1 local $@;
1521 120 ▶ my $perlcode = do{no warnings; eval $metadata};
Subroutine BEGIN: called CC=1 SCAR=0.0
1522 1 ▶ if ($metadata = ($perlcode && ref $perlcode) ? $perlcode : $metadata) {
Branch: 2 branches
BranchTrueFalseTotal
if ($metadata = $perlcode && ref $perlcode ? $perlcode : $metadata) 1 0 1
$perlcode && ref $perlcode ? : 0 1 1
Condition33%1/3
$perlcode and ref $perlcode
!ll&&!rl&&r
010
MC/DC0%0/2
$perlcode and ref $perlcode
$perlcode ref $perlcode
Truth table33%1/3
A and B
A= $perlcodeB= ref $perlcode
ABresult
0X0
100
111
1523 1 ▶ if (ref $metadata ne 'HASH') {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $metadata ne "HASH") 1 0 1
1524 1 my @debug_data = (map {split /:\s*/} split /\n+/, $metadata);
1525 1 $metadata = {map {split /:\s*/} split /\n+/, $metadata};
1526 }
1527 1 my @lifespan;
1528 1 ▶ if (my $introduced = $metadata->{introduced}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $introduced = $metadata->{"introduced"}) 0 1 1
1529 0 push @lifespan, "I<Introduced C<$introduced>>";
1530 }
1531 1 ▶ if (my $deprecated = $metadata->{deprecated}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $deprecated = $metadata->{"deprecated"}) 0 1 1
1532 0 push @lifespan, "I<Deprecated C<$deprecated>>";
1533 }
1534 1 ▶ if (my $since = $metadata->{since}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $since = $metadata->{"since"}) 1 0 1
1535 1 @lifespan = ("I<Since C<$since>>");
1536 }
1537 1 ▶ push @output, "", join(", ", @lifespan) if @lifespan;
Branch: 1 branch
BranchTrueFalseTotal
if @lifespan 1 0 1
1538 }
1539 }
1540 2 my @results = $self->data->search({name => $name});
1541 2 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition100%2/2
$_->{'list'} || ''
l!l
81
MC/DC100%1/1
$_->{'list'} || ''
$_->{'list'}
Truth table100%2/2
A
A= $_->{'list'}
Aresult
11
00
1542 4 push @output, join "\n\n", $self->present('example', $i, $name);
1543 }
1544 2 ▶ pop @output if $output[-1] eq '';
Branch: 1 branch
BranchTrueFalseTotal
if $output[-1] eq "" 1 1 2
1545 2 return ($self->present_data_for_head2($name, @output));
1546 }
1547 # special-case: present_data_for_attributes
1548 elsif ($method eq 'present_data_for_attributes') {
1549 1 ▶ my $method = $self->data->count({list => undef, name => 'attributes'})
Branch: 1 branch
BranchTrueFalseTotal
$self->data->count({'list', undef, 'name', 'attributes'}) ? : 0 1 1
1550 ? 'attributes_type1'
1551 : 'attributes_type2';
1552 1 return $self->present($method, @args);
1553 }
1554 # special-case: present_data_for_attributes_type1
1555 elsif ($method eq 'present_data_for_attributes_type1') {
1556 0 my @output;
1557 0 my @data = $self->collect('attributes');
1558 0 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 0 0
1559 0 for my $line (split /\r?\n/, join "\n", @data) {
1560 push @output, $self->present('attribute_type1', (
1561 0 map {split /,\s*/} split /:\s*/, $line, 2
1562 ));
1563 }
1564 0 ▶ return () if !@output;
Branch: 1 branch
BranchTrueFalseTotal
unless @output 0 0 0
1565 0 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 0 0 0
1566 0 ▶ unshift @output,
Condition0%0/2
$self->text->string('header', 'attributes') || 'This package has the following attributes:'
l!l
00
MC/DC0%0/1
$self->text->string('header', 'attributes') || 'This package has the following attributes:'
$self->text->string('header', 'attributes')
Truth table0%0/2
A
A= $self->text->string('header', 'attributes')
Aresult
11
00
1567 $self->present_data_for_head1('attributes',
1568 $self->text->string('header', 'attributes') ||
1569 'This package has the following attributes:');
1570 }
1571 0 return join "\n", @output;
1572 }
1573 # special-case: present_data_for_attributes_type2
1574 elsif ($method eq 'present_data_for_attributes_type2') {
1575 1 my @output;
1576 1 for my $list ($self->data->search({list => 'attribute'})) {
1577 1 push @output, $self->present('attribute_type2', $list->{name});
1578 }
1579 1 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 1 0 1
1580 1 ▶ unshift @output,
Condition50%1/2
$self->text->string('header', 'attributes') || 'This package has the following attributes:'
l!l
01
MC/DC0%0/1
$self->text->string('header', 'attributes') || 'This package has the following attributes:'
$self->text->string('header', 'attributes')
Truth table50%1/2
A
A= $self->text->string('header', 'attributes')
Aresult
11
00
1581 $self->present_data_for_head1('attributes',
1582 $self->text->string('header', 'attributes') ||
1583 'This package has the following attributes:');
1584 }
1585 1 return join "\n", @output;
1586 }
1587 # special-case: present_data_for_authors
1588 elsif ($method eq 'present_data_for_authors') {
1589 3 my @data = $self->collect('authors');
1590 3 ▶ return @data ? ($self->present_data_for_head1('authors', join "\n\n", @data)) : ();
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 2 1 3
1591 }
1592 # special-case: present_data_for_description
1593 elsif ($method eq 'present_data_for_description') {
1594 2 my @data = $self->collect('description');
1595 2 ▶ return @data ? ($self->present_data_for_head1('description', join "\n\n", @data)) : ();
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 2 0 2
1596 }
1597 # special-case: present_data_for_encoding
1598 elsif ($method eq 'present_data_for_encoding') {
1599 2 my ($name) = $self->collect('encoding');
1600 2 ▶ return () if !$name;
Branch: 1 branch
BranchTrueFalseTotal
unless $name 1 1 2
1601 1 return join("\n", "", "=encoding \U$name", "", "=cut");
1602 }
1603 # special-case: present_data_for_error
1604 elsif ($method eq 'present_data_for_error') {
1605 1 my ($name) = @args;
1606 1 my @output;
1607 1 my @data = $self->collect('error', $name);
1608 1 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 1 1
1609 1 my @results = $self->data->search({name => $name});
1610 1 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition50%1/2
$_->{'list'} || ''
l!l
20
MC/DC0%0/1
$_->{'list'} || ''
$_->{'list'}
Truth table50%1/2
A
A= $_->{'list'}
Aresult
11
00
1611 1 push @output, "B<example $i>", $self->collect('example', $i, $name);
1612 }
1613 return (
1614 1 $self->present_data_for_over($self->present_data_for_item(
1615 "error: C<$name>",
1616 join "\n\n", @data, @output
1617 ))
1618 );
1619 }
1620 # special-case: present_data_for_errors
1621 elsif ($method eq 'present_data_for_errors') {
1622 1 my @output;
1623 1 my $type = 'error';
1624 1 for my $name (
1625 sort map $$_{name},
1626 $self->data->search({list => $type})
1627 )
1628 {
1629 0 push @output, $self->present($type, $name);
1630 }
1631 1 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 0 1 1
1632 0 ▶ unshift @output,
Condition0%0/2
$self->text->string('header', 'errors') || 'This package may raise the following errors:'
l!l
00
MC/DC0%0/1
$self->text->string('header', 'errors') || 'This package may raise the following errors:'
$self->text->string('header', 'errors')
Truth table0%0/2
A
A= $self->text->string('header', 'errors')
Aresult
11
00
1633 $self->present_data_for_head1('errors',
1634 $self->text->string('header', 'errors') ||
1635 'This package may raise the following errors:');
1636 }
1637 1 return join "\n", @output;
1638 }
1639 # special-case: present_data_for_example
1640 elsif ($method eq 'present_data_for_example') {
1641 130 my ($number, $name) = @args;
1642 130 my @data = $self->collect('example', $number, $name);
1643 return @data
1644 130 ▶ ? (
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 129 1 130
1645 $self->present_data_for_over($self->present_data_for_item(
1646 "$name example $number", join "\n\n", @data)))
1647 : ();
1648 }
1649 # special-case: present_data_for_feature
1650 elsif ($method eq 'present_data_for_feature') {
1651 103 my ($name) = @args;
1652 103 my @output;
1653 103 my ($metadata) = $self->collect('metadata', $name);
1654 103 my ($signature) = $self->collect('signature', $name);
1655 103 ▶ push @output, ($signature, '') if $signature;
Branch: 1 branch
BranchTrueFalseTotal
if $signature 102 1 103
1656 103 my @data = $self->collect('feature', $name);
1657 103 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 103 103
1658 103 push @output, join "\n\n", @data;
1659 103 ▶ if ($metadata) {
Branch: 1 branch
BranchTrueFalseTotal
if ($metadata) 102 1 103
1660 102 local $@;
1661 120 ▶ my $perlcode = do{no warnings; eval $metadata};
Subroutine BEGIN: called CC=1 SCAR=0.0
1662 102 ▶ if ($metadata = ($perlcode && ref $perlcode) ? $perlcode : $metadata) {
Branch: 2 branches
BranchTrueFalseTotal
if ($metadata = $perlcode && ref $perlcode ? $perlcode : $metadata) 102 0 102
$perlcode && ref $perlcode ? : 0 102 102
Condition66%2/3
$perlcode and ref $perlcode
!ll&&!rl&&r
10110
MC/DC0%0/2
$perlcode and ref $perlcode
$perlcode ref $perlcode
Truth table66%2/3
A and B
A= $perlcodeB= ref $perlcode
ABresult
0X0
100
111
1663 102 ▶ if (ref $metadata ne 'HASH') {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $metadata ne "HASH") 102 0 102
1664 102 $metadata = {map {split /:\s*/} split /\n+/, $metadata};
1665 }
1666 102 my @lifespan;
1667 102 ▶ if (my $introduced = $metadata->{introduced}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $introduced = $metadata->{"introduced"}) 102 0 102
1668 102 push @lifespan, "I<Introduced C<$introduced>>";
1669 }
1670 102 ▶ if (my $deprecated = $metadata->{deprecated}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $deprecated = $metadata->{"deprecated"}) 101 1 102
1671 101 push @lifespan, "I<Deprecated C<$deprecated>>";
1672 }
1673 102 ▶ if (my $since = $metadata->{since}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $since = $metadata->{"since"}) 0 102 102
1674 0 @lifespan = ("I<Since C<$since>>");
1675 }
1676 102 ▶ push @output, "", join(", ", @lifespan) if @lifespan;
Branch: 1 branch
BranchTrueFalseTotal
if @lifespan 102 0 102
1677 }
1678 }
1679 103 my @results = $self->data->search({name => $name});
1680 103 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition50%1/2
$_->{'list'} || ''
l!l
4390
MC/DC0%0/1
$_->{'list'} || ''
$_->{'list'}
Truth table50%1/2
A
A= $_->{'list'}
Aresult
11
00
1681 131 push @output, "B<example $i>", $self->collect('example', $i, $name);
1682 }
1683 103 ▶ pop @output if $output[-1] eq '';
Branch: 1 branch
BranchTrueFalseTotal
if $output[-1] eq "" 0 103 103
1684 return (
1685 $self->present_data_for_over($self->present_data_for_item(
1686 103 $name, join "\n\n", grep {length} @output))
1687 );
1688 }
1689 # special-case: present_data_for_features
1690 elsif ($method eq 'present_data_for_features') {
1691 1 my @output;
1692 1 my $type = 'feature';
1693 1 for my $name (
1694 sort map $$_{name},
1695 $self->data->search({list => $type})
1696 )
1697 {
1698 102 push @output, $self->present($type, $name);
1699 }
1700 1 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 1 0 1
1701 1 ▶ unshift @output,
Condition50%1/2
$self->text->string('header', 'features') || 'This package provides the following features:'
l!l
01
MC/DC0%0/1
$self->text->string('header', 'features') || 'This package provides the following features:'
$self->text->string('header', 'features')
Truth table50%1/2
A
A= $self->text->string('header', 'features')
Aresult
11
00
1702 $self->present_data_for_head1('features',
1703 $self->text->string('header', 'features') ||
1704 'This package provides the following features:');
1705 }
1706 1 return join "\n", @output;
1707 }
1708 # special-case: present_data_for_function
1709 elsif ($method eq 'present_data_for_function') {
1710 2 my ($name) = @args;
1711 2 my @output;
1712 2 my ($metadata) = $self->collect('metadata', $name);
1713 2 my ($signature) = $self->collect('signature', $name);
1714 2 ▶ push @output, ($signature, '') if $signature;
Branch: 1 branch
BranchTrueFalseTotal
if $signature 1 1 2
1715 2 my @data = $self->collect('function', $name);
1716 2 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 2 2
1717 2 push @output, join "\n\n", @data;
1718 2 ▶ if ($metadata) {
Branch: 1 branch
BranchTrueFalseTotal
if ($metadata) 1 1 2
1719 1 local $@;
1720 120 ▶ my $perlcode = do{no warnings; eval $metadata};
Subroutine BEGIN: called CC=1 SCAR=0.0
1721 1 ▶ if ($metadata = ($perlcode && ref $perlcode) ? $perlcode : $metadata) {
Branch: 2 branches
BranchTrueFalseTotal
if ($metadata = $perlcode && ref $perlcode ? $perlcode : $metadata) 1 0 1
$perlcode && ref $perlcode ? : 1 0 1
Condition33%1/3
$perlcode and ref $perlcode
!ll&&!rl&&r
001
MC/DC0%0/2
$perlcode and ref $perlcode
$perlcode ref $perlcode
Truth table33%1/3
A and B
A= $perlcodeB= ref $perlcode
ABresult
0X0
100
111
1722 1 ▶ if (ref $metadata ne 'HASH') {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $metadata ne "HASH") 0 1 1
1723 0 $metadata = {map {split /:\s*/} split /\n+/, $metadata};
1724 }
1725 1 my @lifespan;
1726 1 ▶ if (my $introduced = $metadata->{introduced}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $introduced = $metadata->{"introduced"}) 0 1 1
1727 0 push @lifespan, "I<Introduced C<$introduced>>";
1728 }
1729 1 ▶ if (my $deprecated = $metadata->{deprecated}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $deprecated = $metadata->{"deprecated"}) 0 1 1
1730 0 push @lifespan, "I<Deprecated C<$deprecated>>";
1731 }
1732 1 ▶ if (my $since = $metadata->{since}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $since = $metadata->{"since"}) 1 0 1
1733 1 @lifespan = ("I<Since C<$since>>");
1734 }
1735 1 ▶ push @output, "", join(", ", @lifespan) if @lifespan;
Branch: 1 branch
BranchTrueFalseTotal
if @lifespan 1 0 1
1736 }
1737 }
1738 2 my @results = $self->data->search({name => $name});
1739 2 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition50%1/2
$_->{'list'} || ''
l!l
50
MC/DC0%0/1
$_->{'list'} || ''
$_->{'list'}
Truth table50%1/2
A
A= $_->{'list'}
Aresult
11
00
1740 1 push @output, $self->present('example', $i, $name);
1741 }
1742 2 ▶ pop @output if $output[-1] eq '';
Branch: 1 branch
BranchTrueFalseTotal
if $output[-1] eq "" 0 2 2
1743 2 return ($self->present_data_for_head2($name, @output));
1744 }
1745 # special-case: present_data_for_functions
1746 elsif ($method eq 'present_data_for_functions') {
1747 1 my @output;
1748 1 my $type = 'function';
1749 1 for my $name (
1750 sort map /:\s*(\w+)$/,
1751 grep /^$type/,
1752 split /\r?\n/,
1753 join "\n\n", $self->collect('includes')
1754 )
1755 {
1756 1 push @output, $self->present($type, $name);
1757 }
1758 1 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 1 0 1
1759 1 ▶ unshift @output,
Condition50%1/2
$self->text->string('header', 'functions') || 'This package provides the following functions:'
l!l
01
MC/DC0%0/1
$self->text->string('header', 'functions') || 'This package provides the following functions:'
$self->text->string('header', 'functions')
Truth table50%1/2
A
A= $self->text->string('header', 'functions')
Aresult
11
00
1760 $self->present_data_for_head1('functions',
1761 $self->text->string('header', 'functions') ||
1762 'This package provides the following functions:');
1763 }
1764 1 return join "\n", @output;
1765 }
1766 # special-case: present_data_for_head1
1767 elsif ($method eq 'present_data_for_head1') {
1768 21 my ($name, @data) = @args;
1769 21 return join("\n", "", "=head1 \U$name", "", grep(defined, @data), "", "=cut");
1770 }
1771 # special-case: present_data_for_head2
1772 elsif ($method eq 'present_data_for_head2') {
1773 106 my ($name, @data) = @args;
1774 106 return join("\n", "", "=head2 \L$name", "", grep(defined, @data), "", "=cut");
1775 }
1776 # special-case: present_data_for_includes
1777 elsif ($method eq 'present_data_for_includes') {
1778 1 return ();
1779 }
1780 # special-case: present_data_for_inherits
1781 elsif ($method eq 'present_data_for_inherits') {
1782 2 my @output = map +($self->present_data_for_link($_), ""), grep defined,
1783 split /\r?\n/, join "\n\n", $self->collect('inherits');
1784 2 ▶ return () if !@output;
Branch: 1 branch
BranchTrueFalseTotal
unless @output 0 2 2
1785 2 pop @output;
1786 2 ▶ return $self->present_data_for_head1('inherits',
Condition50%1/2
$self->text->string('header', 'inherits') || 'This package inherits behaviors from:'
l!l
02
MC/DC0%0/1
$self->text->string('header', 'inherits') || 'This package inherits behaviors from:'
$self->text->string('header', 'inherits')
Truth table50%1/2
A
A= $self->text->string('header', 'inherits')
Aresult
11
00
1787 $self->text->string('header', 'inherits') ||
1788 "This package inherits behaviors from:",
1789 "",
1790 @output,
1791 );
1792 }
1793 # special-case: present_data_for_integrates
1794 elsif ($method eq 'present_data_for_integrates') {
1795 2 my @output = map +($self->present_data_for_link($_), ""), grep defined,
1796 split /\r?\n/, join "\n\n", $self->collect('integrates');
1797 2 ▶ return () if !@output;
Branch: 1 branch
BranchTrueFalseTotal
unless @output 0 2 2
1798 2 pop @output;
1799 2 ▶ return $self->present_data_for_head1('integrates',
Condition50%1/2
$self->text->string('header', 'integrates') || 'This package integrates behaviors from:'
l!l
02
MC/DC0%0/1
$self->text->string('header', 'integrates') || 'This package integrates behaviors from:'
$self->text->string('header', 'integrates')
Truth table50%1/2
A
A= $self->text->string('header', 'integrates')
Aresult
11
00
1800 $self->text->string('header', 'integrates') ||
1801 "This package integrates behaviors from:",
1802 "",
1803 @output,
1804 );
1805 }
1806 # special-case: present_data_for_item
1807 elsif ($method eq 'present_data_for_item') {
1808 237 my ($name, $data) = @args;
1809 237 return ("=item $name\n", "$data\n");
1810 }
1811 # special-case: present_data_for_layout
1812 elsif ($method eq 'present_data_for_layout') {
1813 1 return ();
1814 }
1815 # special-case: present_data_for_libraries
1816 elsif ($method eq 'present_data_for_libraries') {
1817 2 my @output = map +($self->present_data_for_link($_), ""), grep defined,
1818 split /\r?\n/, join "\n\n", $self->collect('libraries');
1819 2 ▶ return '' if !@output;
Branch: 1 branch
BranchTrueFalseTotal
unless @output 1 1 2
1820 1 pop @output;
1821 1 ▶ return $self->present_data_for_head1('libraries',
Condition50%1/2
$self->text->string('header', 'libraries') || 'This package uses type constraints from:'
l!l
01
MC/DC0%0/1
$self->text->string('header', 'libraries') || 'This package uses type constraints from:'
$self->text->string('header', 'libraries')
Truth table50%1/2
A
A= $self->text->string('header', 'libraries')
Aresult
11
00
1822 $self->text->string('header', 'libraries') ||
1823 "This package uses type constraints from:",
1824 "",
1825 @output,
1826 );
1827 }
1828 # special-case: present_data_for_license
1829 elsif ($method eq 'present_data_for_license') {
1830 3 my @data = $self->collect('license');
1831 return @data
1832 3 ▶ ? ($self->present_data_for_head1('license', join "\n\n", @data))
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 2 1 3
1833 : ();
1834 }
1835 # special-case: present_data_for_link
1836 elsif ($method eq 'present_data_for_link') {
1837 7 return ("L<@{[join('|', @args)]}>");
1838 }
1839 # special-case: present_data_for_message
1840 elsif ($method eq 'present_data_for_message') {
1841 1 my ($name) = @args;
1842 1 my @output;
1843 1 my ($signature) = $self->collect('signature', $name);
1844 1 ▶ push @output, ($signature, '') if $signature;
Branch: 1 branch
BranchTrueFalseTotal
if $signature 0 1 1
1845 1 my @data = $self->collect('message', $name);
1846 1 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 1 1
1847 1 my @results = $self->data->search({name => $name});
1848 1 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition50%1/2
$_->{'list'} || ''
l!l
20
MC/DC0%0/1
$_->{'list'} || ''
$_->{'list'}
Truth table50%1/2
A
A= $_->{'list'}
Aresult
11
00
1849 1 push @output, "B<example $i>", join "\n\n",
1850 $self->collect('example', $i, $name);
1851 }
1852 return (
1853 1 $self->present_data_for_over($self->present_data_for_item(
1854 $name, join "\n\n", @data, @output))
1855 );
1856 }
1857 # special-case: present_data_for_messages
1858 elsif ($method eq 'present_data_for_messages') {
1859 1 my @output;
1860 1 my $type = 'message';
1861 1 for my $name (
1862 sort map /:\s*(\w+)$/,
1863 grep /^$type/,
1864 split /\r?\n/,
1865 join "\n\n", $self->collect('includes')
1866 )
1867 {
1868 0 push @output, $self->present($type, $name);
1869 }
1870 1 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 0 1 1
1871 0 ▶ unshift @output,
Condition0%0/2
$self->text->string('header', 'messages') || 'This package provides the following messages:'
l!l
00
MC/DC0%0/1
$self->text->string('header', 'messages') || 'This package provides the following messages:'
$self->text->string('header', 'messages')
Truth table0%0/2
A
A= $self->text->string('header', 'messages')
Aresult
11
00
1872 $self->present_data_for_head1('messages',
1873 $self->text->string('header', 'messages') ||
1874 'This package provides the following messages:');
1875 }
1876 1 return join "\n", @output;
1877 }
1878 # special-case: present_data_for_metadata
1879 elsif ($method eq 'present_data_for_metadata') {
1880 1 return ();
1881 }
1882 # special-case: present_data_for_method
1883 elsif ($method eq 'present_data_for_method') {
1884 102 my ($name) = @args;
1885 102 my @output;
1886 102 my ($metadata) = $self->collect('metadata', $name);
1887 102 my ($signature) = $self->collect('signature', $name);
1888 102 ▶ push @output, ($signature, '') if $signature;
Branch: 1 branch
BranchTrueFalseTotal
if $signature 102 0 102
1889 102 my @data = $self->collect('method', $name);
1890 102 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 102 102
1891 102 push @output, join "\n\n", @data;
1892 102 ▶ if ($metadata) {
Branch: 1 branch
BranchTrueFalseTotal
if ($metadata) 102 0 102
1893 102 local $@;
1894 120 ▶ my $perlcode = do{no warnings; eval $metadata};
Subroutine BEGIN: called CC=1 SCAR=0.0
1895 102 ▶ if ($metadata = ($perlcode && ref $perlcode) ? $perlcode : $metadata) {
Branch: 2 branches
BranchTrueFalseTotal
if ($metadata = $perlcode && ref $perlcode ? $perlcode : $metadata) 102 0 102
$perlcode && ref $perlcode ? : 1 101 102
Condition66%2/3
$perlcode and ref $perlcode
!ll&&!rl&&r
01011
MC/DC50%1/2
$perlcode and ref $perlcode
$perlcode ref $perlcode
Truth table66%2/3
A and B
A= $perlcodeB= ref $perlcode
ABresult
0X0
100
111
1896 102 ▶ if (ref $metadata ne 'HASH') {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $metadata ne "HASH") 101 1 102
1897 101 $metadata = {map {split /:\s*/} split /\n+/, $metadata};
1898 }
1899 102 my @lifespan;
1900 102 ▶ if (my $introduced = $metadata->{introduced}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $introduced = $metadata->{"introduced"}) 0 102 102
1901 0 push @lifespan, "I<Introduced C<$introduced>>";
1902 }
1903 102 ▶ if (my $deprecated = $metadata->{deprecated}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $deprecated = $metadata->{"deprecated"}) 0 102 102
1904 0 push @lifespan, "I<Deprecated C<$deprecated>>";
1905 }
1906 102 ▶ if (my $since = $metadata->{since}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $since = $metadata->{"since"}) 102 0 102
1907 102 @lifespan = ("I<Since C<$since>>");
1908 }
1909 102 ▶ push @output, "", join(", ", @lifespan) if @lifespan;
Branch: 1 branch
BranchTrueFalseTotal
if @lifespan 102 0 102
1910 }
1911 }
1912 102 my @results = $self->data->search({name => $name});
1913 102 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition50%1/2
$_->{'list'} || ''
l!l
4300
MC/DC0%0/1
$_->{'list'} || ''
$_->{'list'}
Truth table50%1/2
A
A= $_->{'list'}
Aresult
11
00
1914 124 push @output, $self->present('example', $i, $name);
1915 }
1916 102 my @raises = $self->data->search({list => 'raise'});
1917 102 for my $raise (grep {$$_{name} =~ /^$name\s/} @raises) {
1918 my ($sub, $package, $id) = $raise->{name}
1919 2 =~ /(\w+)\s+([:\w]*)\s+([\w\.]+)/;
1920 2 ▶ next unless $sub && $package;
Branch: 1 branch
BranchTrueFalseTotal
unless $sub and $package 0 2 2
Condition33%1/3
$sub and $package
!ll&&!rl&&r
002
MC/DC0%0/2
$sub and $package
$sub $package
Truth table33%1/3
A and B
A= $subB= $package
ABresult
0X0
100
111
1921 push @output,
1922 $self->present_data_for_over(
1923 $self->present_data_for_item(
1924 2 ▶ join(" ", "B<may raise> L<$package>", ($id ? "C<$id>" : ())), join("\n\n", @{$raise->{data}})
Branch: 1 branch
BranchTrueFalseTotal
$id ? : 2 0 2
1925 ),
1926 );
1927 }
1928 102 ▶ pop @output if $output[-1] eq '';
Branch: 1 branch
BranchTrueFalseTotal
if $output[-1] eq "" 0 102 102
1929 102 return ($self->present_data_for_head2($name, @output));
1930 }
1931 # special-case: present_data_for_methods
1932 elsif ($method eq 'present_data_for_methods') {
1933 1 my @output;
1934 1 my $type = 'method';
1935 1 for my $name (
1936 sort map /:\s*(\w+)$/,
1937 grep /^$type/,
1938 split /\r?\n/,
1939 join "\n\n", $self->collect('includes')
1940 )
1941 {
1942 101 push @output, $self->present($type, $name);
1943 }
1944 1 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 1 0 1
1945 1 ▶ unshift @output,
Condition50%1/2
$self->text->string('header', 'methods') || 'This package provides the following methods:'
l!l
01
MC/DC0%0/1
$self->text->string('header', 'methods') || 'This package provides the following methods:'
$self->text->string('header', 'methods')
Truth table50%1/2
A
A= $self->text->string('header', 'methods')
Aresult
11
00
1946 $self->present_data_for_head1('methods',
1947 $self->text->string('header', 'methods') ||
1948 'This package provides the following methods:');
1949 }
1950 1 return join "\n", @output;
1951 }
1952 # special-case: present_data_for_name
1953 elsif ($method eq 'present_data_for_name') {
1954 3 my $name = join ' - ', map $self->collect($_), 'name', 'tagline';
1955 3 ▶ return $name ? ($self->present_data_for_head1('name', $name)) : ();
Branch: 1 branch
BranchTrueFalseTotal
$name ? : 3 0 3
1956 }
1957 # special-case: present_data_for_operator
1958 elsif ($method eq 'present_data_for_operator') {
1959 1 my ($name) = @args;
1960 1 my @output;
1961 1 my @data = $self->collect('operator', $name);
1962 1 ▶ return () if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 1 1
1963 1 my @results = $self->data->search({name => $name});
1964 1 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition50%1/2
$_->{'list'} || ''
l!l
20
MC/DC0%0/1
$_->{'list'} || ''
$_->{'list'}
Truth table50%1/2
A
A= $_->{'list'}
Aresult
11
00
1965 1 push @output, "B<example $i>", join "\n\n",
1966 $self->collect('example', $i, $name);
1967 }
1968 return (
1969 1 $self->present_data_for_over($self->present_data_for_item(
1970 "operation: C<$name>",
1971 join "\n\n", @data, @output
1972 ))
1973 );
1974 }
1975 # special-case: present_data_for_operators
1976 elsif ($method eq 'present_data_for_operators') {
1977 1 my @output;
1978 1 my $type = 'operator';
1979 1 for my $name (
1980 sort map $$_{name},
1981 $self->data->search({list => $type})
1982 )
1983 {
1984 0 push @output, $self->present($type, $name);
1985 }
1986 1 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 0 1 1
1987 0 ▶ unshift @output,
Condition0%0/2
$self->text->string('header', 'operators') || 'This package overloads the following operators:'
l!l
00
MC/DC0%0/1
$self->text->string('header', 'operators') || 'This package overloads the following operators:'
$self->text->string('header', 'operators')
Truth table0%0/2
A
A= $self->text->string('header', 'operators')
Aresult
11
00
1988 $self->present_data_for_head1('operators',
1989 $self->text->string('header', 'operators') ||
1990 'This package overloads the following operators:');
1991 }
1992 1 return join "\n", @output;
1993 }
1994 # special-case: present_data_for_over
1995 elsif ($method eq 'present_data_for_over') {
1996 237 return join("\n", "", "=over 4", "", grep(defined, @args), "=back");
1997 }
1998 # special-case: present_data_for_partial
1999 elsif ($method eq 'present_data_for_partial') {
2000 2 my ($data) = @args;
2001 2 my ($file, $method, @args) = @{$data};
2002 2 ▶ $method = 'present' if lc($method) eq 'pdml';
Branch: 1 branch
BranchTrueFalseTotal
if lc $method eq "pdml" 0 2 2
2003 2 my $test = $self->new($file);
2004 2 my @output;
2005 2 ▶ $self->pass((-f $file && (@output = ($test->$method(@args)))),
Condition33%1/3
-f $file && (@output = $test->$method(@args))
!ll&&!rl&&r
002
MC/DC0%0/2
-f $file && (@output = $test->$method(@args))
-f $file (@output = $test->$method(@args))
Truth table33%1/3
A && B
A= -f $fileB= (@output = $test->$method(@args))
ABresult
0X0
100
111
2006 "$file: $method: @args");
2007 2 return join "\n", @output;
2008 }
2009 # special-case: present_data_for_partials
2010 elsif ($method eq 'present_data_for_partials') {
2011 1 my @output;
2012 push @output, $self->present('partial', $_)
2013 1 for map [split /\:\s*/], grep /\w/, grep !/^#/, split /\r?\n/, join "\n\n",
2014 $self->collect('partials');
2015 1 return join "\n", @output;
2016 }
2017 # special-case: present_data_for_project
2018 elsif ($method eq 'present_data_for_project') {
2019 1 my @data = $self->collect('project');
2020 1 ▶ return @data ? ($self->present_data_for_head1('project', join "\n\n", @data)) : ();
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 0 1 1
2021 }
2022 # special-case: present_data_for_signature
2023 elsif ($method eq 'present_data_for_signature') {
2024 0 return ();
2025 }
2026 # special-case: present_data_for_synopsis
2027 elsif ($method eq 'present_data_for_synopsis') {
2028 1 my @data = $self->collect('synopsis');
2029 return @data
2030 1 ▶ ? ($self->present_data_for_head1('synopsis', join "\n\n", @data))
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 1 0 1
2031 : ();
2032 }
2033 # special-case: present_data_for_tagline
2034 elsif ($method eq 'present_data_for_tagline') {
2035 0 my @data = $self->collect('tagline');
2036 return @data
2037 0 ▶ ? ($self->present_data_for_head1('tagline', join "\n\n", @data))
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 0 0 0
2038 : ();
2039 }
2040 # special-case: present_data_for_version
2041 elsif ($method eq 'present_data_for_version') {
2042 1 my @data = $self->collect('version');
2043 return @data
2044 1 ▶ ? ($self->present_data_for_head1('version', join "\n\n", @data))
Branch: 1 branch
BranchTrueFalseTotal
@data ? : 0 1 1
2045 : ();
2046 }
2047 else {
2048 0 my ($name) = @args;
2049 0 my @output;
2050 0 for my $item (
2051 sort map $$_{name},
2052 $self->data->search({list => $name})
2053 )
2054 {
2055 0 my @iteration;
2056 0 my ($metadata) = $self->collect('metadata', $item);
2057 0 my ($signature) = $self->collect('signature', $item);
2058 0 ▶ push @iteration, ($signature, '') if $signature;
Branch: 1 branch
BranchTrueFalseTotal
if $signature 0 0 0
2059 0 my @data = do {
2060 0 ▶ my ($find) = $self->text->find($name, $item); @{$find ? $find->{data} : []};
Branch: 1 branch
BranchTrueFalseTotal
$find ? : 0 0 0
2061 };
2062 0 ▶ next if !@data;
Branch: 1 branch
BranchTrueFalseTotal
unless @data 0 0 0
2063 0 push @iteration, join "\n\n", @data;
2064 0 ▶ if ($metadata) {
Branch: 1 branch
BranchTrueFalseTotal
if ($metadata) 0 0 0
2065 0 local $@;
2066 0 ▶ my $perlcode = do{no warnings; eval $metadata};
Subroutine BEGIN: called CC=1 SCAR=0.6
2067 0 ▶ if ($metadata = ($perlcode && ref $perlcode) ? $perlcode : $metadata) {
Branch: 2 branches
BranchTrueFalseTotal
if ($metadata = $perlcode && ref $perlcode ? $perlcode : $metadata) 0 0 0
$perlcode && ref $perlcode ? : 0 0 0
Condition0%0/3
$perlcode and ref $perlcode
!ll&&!rl&&r
000
MC/DC0%0/2
$perlcode and ref $perlcode
$perlcode ref $perlcode
Truth table0%0/3
A and B
A= $perlcodeB= ref $perlcode
ABresult
0X0
100
111
2068 0 ▶ if (ref $metadata ne 'HASH') {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $metadata ne "HASH") 0 0 0
2069 0 $metadata = {map {split /:\s*/} split /\n+/, $metadata};
2070 }
2071 0 my @lifespan;
2072 0 ▶ if (my $introduced = $metadata->{introduced}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $introduced = $metadata->{"introduced"}) 0 0 0
2073 0 push @lifespan, "I<Introduced C<$introduced>>";
2074 }
2075 0 ▶ if (my $deprecated = $metadata->{deprecated}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $deprecated = $metadata->{"deprecated"}) 0 0 0
2076 0 push @lifespan, "I<Deprecated C<$deprecated>>";
2077 }
2078 0 ▶ if (my $since = $metadata->{since}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $since = $metadata->{"since"}) 0 0 0
2079 0 @lifespan = ("I<Since C<$since>>");
2080 }
2081 0 ▶ push @output, "", join(", ", @lifespan) if @lifespan;
Branch: 1 branch
BranchTrueFalseTotal
if @lifespan 0 0 0
2082 }
2083 }
2084 0 my @results = $self->data->search({name => $item});
2085 0 ▶ for my $i (1..(int grep {($$_{list} || '') =~ /^example-\d+/} @results)) {
Condition0%0/2
$_->{'list'} || ''
l!l
00
MC/DC0%0/1
$_->{'list'} || ''
$_->{'list'}
Truth table0%0/2
A
A= $_->{'list'}
Aresult
11
00
2086 0 push @iteration, "B<example $i>", $self->collect('example', $i, $item);
2087 }
2088 0 ▶ pop @iteration if @output && $output[-1] eq '';
Branch: 1 branch
BranchTrueFalseTotal
if @output and $output[-1] eq "" 0 0 0
Condition0%0/3
@output and $output[-1] eq ""
!ll&&!rl&&r
000
MC/DC0%0/2
@output and $output[-1] eq ""
@output $output[-1] eq ""
Truth table0%0/3
A and B
A= @outputB= $output[-1] eq ""
ABresult
0X0
100
111
2089 0 push @output, (
2090 $self->present_data_for_over($self->present_data_for_item(
2091 $item, join "\n\n", @iteration))
2092 );
2093 }
2094 0 ▶ if (@output) {
Branch: 1 branch
BranchTrueFalseTotal
if (@output) 0 0 0
2095 0 ▶ unshift @output,
Condition0%0/3
$self->text->string('header', $block) || $self->text->string(undef, $block)
l!l&&r!l&&!r
000
MC/DC0%0/2
$self->text->string('header', $block) || $self->text->string(undef, $block)
$self->text->string('header', $block) $self->text->string(undef, $block)
Truth table0%0/3
A || B
A= $self->text->string('header', $block)B= $self->text->string(undef, $block)
ABresult
1X1
011
000
2096 $self->present_data_for_head1($block,
2097 $self->text->string('header', $block) ||
2098 $self->text->string(undef, $block));
2099 }
2100 0 return join "\n", @output;
2101 }
2102 }
2103  
2104 # handle deprecated "okay_can"
2105 3 ▶ if ($method eq 'okay_can') {
Branch: 1 branch
BranchTrueFalseTotal
if ($method eq "okay_can") 1 2 3
2106 1 my $result = $self->handler('can_ok', @args);
2107  
2108 1 return $result;
2109 }
2110  
2111 # handle deprecated "okay_isa"
2112 2 ▶ if ($method eq 'okay_isa') {
Branch: 1 branch
BranchTrueFalseTotal
if ($method eq "okay_isa") 2 0 2
2113 2 my $result = $self->handler('isa_ok', @args);
2114  
2115 2 return $result;
2116 }
2117  
2118 # hidden but accessible Test::More functions
2119 0 state $test_more_functions = {
2120 BAIL_OUT => 'BAIL_OUT',
2121 can_ok => 'can_ok',
2122 cmp_ok => 'cmp_ok',
2123 done_testing => 'done_testing',
2124 eq_array => 'eq_array',
2125 eq_hash => 'eq_hash',
2126 eq_set => 'eq_set',
2127 is_deeply => 'is_deeply',
2128 isa_ok => 'isa_ok',
2129 new_ok => 'new_ok',
2130 ok => 'ok',
2131 plan => 'plan',
2132 require_ok => 'require_ok',
2133 skip => 'skip',
2134 use_ok => 'use_ok',
2135 };
2136 0 ▶ if ($test_more_functions->{$method}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($test_more_functions->{$method}) 0 0 0
2137 0 return $self->handler($method, @args);
2138 }
2139  
2140 # method not found
2141 0 ▶ my $class = ref($self) || $self;
Condition0%0/3
ref $self || $self
l!l&&r!l&&!r
000
MC/DC0%0/2
ref $self || $self
ref $self $self
Truth table0%0/3
A || B
A= ref $selfB= $self
ABresult
1X1
011
000
2142 0 return $self->error_on_missing({class => $class, method => $method})->throw;
2143 }
2144  
2145 119 1;
2146  
2147  
2148  
2149 =head1 NAME
2150  
2151 Venus::Test - Test Class
2152  
2153 =cut
2154  
2155 =head1 ABSTRACT
2156  
2157 Test Class for Perl 5
2158  
2159 =cut
2160  
2161 =head1 SYNOPSIS
2162  
2163 package main;
2164  
2165 use Venus::Test;
2166  
2167 my $test = Venus::Test->new('t/Venus_Test.t');
2168  
2169 # $test->for('name');
2170  
2171 # $test->for('tagline');
2172  
2173 # $test->for('abstract');
2174  
2175 # $test->for('synopsis');
2176  
2177 # $test->done;
2178  
2179 =cut
2180  
2181 =head1 DESCRIPTION
2182  
2183 This package aims to provide a standard for documenting L<Venus> derived
2184 software projects, a framework writing tests, test automation, and
2185 documentation generation. This package will automatically exports C<true>,
2186 C<false>, and L</test> keyword functions.
2187  
2188 =cut
2189  
2190 =head1 SPECIFICATION
2191  
2192 This section describes the specification format used by L<Venus::Test> to
2193 generate documentation and automate testing for Perl packages. The
2194 specification uses specially formatted POD blocks that serve as both
2195 human-readable documentation and executable test cases.
2196  
2197 B<Note:> When code blocks are evaluated, "redefined" warnings are automatically
2198 disabled.
2199  
2200 =head2 Overview
2201  
2202 A specification document consists of POD blocks that describe a package. The
2203 blocks are organized into the following categories:
2204  
2205 =over 4
2206  
2207 =item * B<Required Blocks> - Must be present in every specification
2208  
2209 =item * B<Package Structure Blocks> - Define inheritance and dependencies
2210  
2211 =item * B<API Blocks> - Document attributes, methods, functions, etc.
2212  
2213 =item * B<Supporting Blocks> - Signatures, examples, metadata, and exceptions
2214  
2215 =item * B<Feature Blocks> - Special capabilities and operators
2216  
2217 =item * B<Document Control Blocks> - Layout and partial inclusions
2218  
2219 =item * B<Project Information Blocks> - Authors, license, version
2220  
2221 =back
2222  
2223 =head2 Quick Reference
2224  
2225 # [required]
2226  
2227 =name
2228 =abstract
2229 =tagline
2230 =synopsis
2231 =description
2232  
2233 # [optional]
2234  
2235 =encoding
2236 =includes
2237 =libraries
2238 =inherits
2239 =integrates
2240  
2241 # [optional; repeatable]
2242  
2243 =attribute $name
2244 =signature $name
2245 =metadata $name
2246 =example-$number $name
2247 =raise $name $error ($id optional)
2248  
2249 =function $name
2250 =signature $name
2251 =metadata $name
2252 =example-$number $name
2253 =raise $name $error ($id optional)
2254  
2255 =message $name
2256 =signature $name
2257 =metadata $name
2258 =example-$number $name
2259  
2260 =method $name
2261 =signature $name
2262 =metadata $name
2263 =example-$number $name
2264 =raise $name $error ($id optional)
2265  
2266 =routine $name
2267 =signature $name
2268 =metadata $name
2269 =example-$number $name
2270 =raise $name $error ($id optional)
2271  
2272 =feature $name
2273 =metadata $name
2274 =example-$number $name
2275  
2276 =error $name
2277 =example-$number $name
2278  
2279 =operator $name
2280 =example-$number $name
2281  
2282 # [optional]
2283  
2284 =layout
2285 =partials
2286 =authors
2287 =license
2288 =project
2289 =version
2290  
2291 =head1 REQUIRED BLOCKS
2292  
2293 These blocks must be present in every specification document.
2294  
2295 =head2 name
2296  
2297 =name
2298  
2299 Example
2300  
2301 =cut
2302  
2303 $test->for('name');
2304  
2305 The C<name> block should contain the package name. This is tested for
2306 loadability.
2307  
2308 =head2 abstract
2309  
2310 =abstract
2311  
2312 Example Test Documentation
2313  
2314 =cut
2315  
2316 $test->for('abstract');
2317  
2318 The C<abstract> block should contain a subtitle describing the package. This is
2319 tested for existence.
2320  
2321 =head2 tagline
2322  
2323 =tagline
2324  
2325 Example Class
2326  
2327 =cut
2328  
2329 $test->for('tagline');
2330  
2331 The C<tagline> block should contain a 2-5 word description of the package,
2332 which will be prepended to the name as a full description of the package.
2333  
2334 =head2 synopsis
2335  
2336 =synopsis
2337  
2338 use Example;
2339  
2340 my $example = Example->new;
2341  
2342 # bless(..., "Example")
2343  
2344 =cut
2345  
2346 $test->for('synopsis', sub {
2347 my ($tryable) = @_;
2348 $tryable->result;
2349 });
2350  
2351 The C<synopsis> block should contain the normative usage of the package. This
2352 is tested for existence. This block should be written in a way that allows it
2353 to be evaled successfully and should return a value.
2354  
2355 =head2 description
2356  
2357 =description
2358  
2359 This package provides an example class.
2360  
2361 =cut
2362  
2363 $test->for('description');
2364  
2365 The C<description> block should contain a description of the package and its
2366 behaviors.
2367  
2368 =head1 PACKAGE BLOCKS
2369  
2370 These optional blocks define the package's relationships and dependencies.
2371  
2372 =head2 includes
2373  
2374 =includes
2375  
2376 function: eg
2377  
2378 method: prepare
2379 method: execute
2380  
2381 =cut
2382  
2383 $test->for('includes');
2384  
2385 The C<includes> block should contain a list of C<function>, C<method>, and/or
2386 C<routine> names in the format of C<$type: $name>. Empty (or commented out)
2387 lines are ignored. Each function, method, and/or routine is tested to be
2388 documented properly, i.e. has the requisite counterparts (e.g. signature and at
2389 least one example block). Also, the package must recognize that each exists.
2390  
2391 =head2 libraries
2392  
2393 =libraries
2394  
2395 Venus::Check
2396  
2397 =cut
2398  
2399 $test->for('libraries');
2400  
2401 The C<libraries> block should contain a list of packages, each describing how
2402 particular type names used within function and method signatures will be
2403 validated. These packages are tested for loadability.
2404  
2405 =head2 inherits
2406  
2407 =inherits
2408  
2409 Venus::Core::Class
2410  
2411 =cut
2412  
2413 $test->for('inherits');
2414  
2415 The C<inherits> block should contain a list of parent packages. These packages
2416 are tested for loadability.
2417  
2418 =head2 integrates
2419  
2420 =integrates
2421  
2422 Venus::Role::Catchable
2423 Venus::Role::Throwable
2424  
2425 =cut
2426  
2427 $test->for('integrates');
2428  
2429 The C<integrates> block should contain a list of packages that are involved in
2430 the behavior of the main package (typically roles). These packages are not
2431 automatically tested.
2432  
2433 =head1 API BLOCKS
2434  
2435 These blocks document the package's interface: attributes, methods, functions,
2436 messages, and routines. Each API block follows a common pattern requiring a
2437 description block, a signature block, and at least one example block.
2438  
2439 =head2 Common Pattern
2440  
2441 All API blocks (attribute, function, message, method, routine) follow this
2442 structure:
2443  
2444 =$type $name # Description of the $type
2445 =signature $name # Type signature
2446 =metadata $name # Optional metadata (since, deprecated, etc.)
2447 =example-1 $name # First example (required)
2448 =example-2 $name # Additional examples (optional)
2449 =raise $name $error # Document exceptions (optional)
2450 =raise $name $error $id # Exception with named error (optional)
2451 ...
2452  
2453 The C<signature> block should contain a routine signature in the form of
2454 C<$signature : $return_type>, where C<$signature> is a valid typed signature
2455 and C<$return_type> is any valid L<Venus::Check> expression.
2456  
2457 The C<example-$number> block should contain valid Perl code and return a value.
2458 Examples can include a "magic" comment to incorporate other code:
2459  
2460 =over 4
2461  
2462 =item * C<# given: synopsis> - Include the synopsis code
2463  
2464 =item * C<# given: example-$number $name> - Include another example's code
2465  
2466 =back
2467  
2468 =head2 attribute
2469  
2470 =attribute name
2471  
2472 The name attribute is read-write, optional, and holds a string.
2473  
2474 =signature name
2475  
2476 name(string $value) (string)
2477  
2478 =metadata name
2479  
2480 since: 1.0.0
2481  
2482 =example-1 name
2483  
2484 # given: synopsis
2485  
2486 my $name = $example->name;
2487  
2488 # "..."
2489  
2490 =cut
2491  
2492 $test->for('attribute', 'name');
2493  
2494 $test->for('example', 1, 'name', sub {
2495 my ($tryable) = @_;
2496 $tryable->result;
2497 });
2498  
2499 The C<attribute> block should contain a description of the attribute and its
2500 purpose. Each attribute is tested and must be recognized to exist.
2501  
2502 =head2 method
2503  
2504 =method prepare
2505  
2506 The prepare method prepares for execution.
2507  
2508 =signature prepare
2509  
2510 prepare() (boolean)
2511  
2512 =example-1 prepare
2513  
2514 # given: synopsis
2515  
2516 my $prepare = $example->prepare;
2517  
2518 # "..."
2519  
2520 =cut
2521  
2522 $test->for('method', 'prepare');
2523  
2524 $test->for('example', 1, 'prepare', sub {
2525 my ($tryable) = @_;
2526 $tryable->result;
2527 });
2528  
2529 The C<method> block should contain a description of the method and its purpose.
2530 Each method is tested and must be recognized to exist.
2531  
2532 =head2 function
2533  
2534 =function eg
2535  
2536 The eg function returns a new instance of Example.
2537  
2538 =signature eg
2539  
2540 eg() (Example)
2541  
2542 =example-1 eg
2543  
2544 # given: synopsis
2545  
2546 my $example = eg();
2547  
2548 # "..."
2549  
2550 =cut
2551  
2552 $test->for('function', 'eg');
2553  
2554 $test->for('example', 1, 'eg', sub {
2555 my ($tryable) = @_;
2556 $tryable->result;
2557 });
2558  
2559 The C<function> block should contain a description of the function and its
2560 purpose. Each function is tested and must be recognized to exist.
2561  
2562 =head2 routine
2563  
2564 =routine process
2565  
2566 The process routine processes and returns data.
2567  
2568 =signature process
2569  
2570 process(any @args) (any)
2571  
2572 =example-1 process
2573  
2574 # given: synopsis
2575  
2576 my $result = $example->process;
2577  
2578 # "..."
2579  
2580 =cut
2581  
2582 $test->for('routine', 'process');
2583  
2584 $test->for('example', 1, 'process', sub {
2585 my ($tryable) = @_;
2586 $tryable->result;
2587 });
2588  
2589 The C<routine> block documents a subroutine that can be called as either a
2590 function or a method. It follows the same pattern as method and function
2591 blocks.
2592  
2593 =head2 message
2594  
2595 =message accept
2596  
2597 The accept message represents acceptance.
2598  
2599 =signature accept
2600  
2601 accept(any @args) (string)
2602  
2603 =example-1 accept
2604  
2605 # given: synopsis
2606  
2607 my $accept = $example->accept;
2608  
2609 # "..."
2610  
2611 =cut
2612  
2613 $test->for('message', 'accept');
2614  
2615 $test->for('example', 1, 'accept', sub {
2616 my ($tryable) = @_;
2617 $tryable->result;
2618 });
2619  
2620 The C<message> block documents a method that returns a message string, typically
2621 used for error messages or localization. It follows the same pattern as other
2622 API blocks.
2623  
2624 =head1 SUPPORTING BLOCKS
2625  
2626 These blocks provide additional context for API documentation.
2627  
2628 =head2 signature
2629  
2630 =signature prepare
2631  
2632 prepare() (boolean)
2633  
2634 =cut
2635  
2636 $test->for('signature', 'prepare');
2637  
2638 The C<signature> block should contain a routine signature in the form of
2639 C<$signature : $return_type>, where C<$signature> is a valid typed signature
2640 and C<$return_type> is any valid L<Venus::Check> expression.
2641  
2642 =head2 example
2643  
2644 =example-1 name
2645  
2646 # given: synopsis
2647  
2648 my $name = $example->name;
2649  
2650 # "..."
2651  
2652 =cut
2653  
2654 $test->for('example', 1, 'name', sub {
2655 my ($tryable) = @_;
2656 $tryable->result;
2657 });
2658  
2659 The C<example-$number $name> block should contain valid Perl code and return a
2660 value. The block may contain a "magic" comment in the form of C<given:
2661 synopsis> or C<given: example-$number $name> which if present will include the
2662 given code example(s) with the evaluation of the current block.
2663  
2664 =head2 metadata
2665  
2666 =metadata prepare
2667  
2668 {since => "1.2.3"}
2669  
2670 =cut
2671  
2672 $test->for('metadata', 'prepare');
2673  
2674 The C<metadata $name> block should contain a stringified hashref containing
2675 Perl data structures used in the rendering of the package's documentation.
2676 Metadata can also be specified as flat key/value pairs:
2677  
2678 =metadata prepare
2679  
2680 introduced: 1.2.3
2681 deprecated: 2.0.0
2682  
2683 =cut
2684  
2685 =head2 raise
2686  
2687 =raise execute Venus::Error
2688  
2689 # given: synopsis
2690  
2691 $example->operation; # throw exception
2692  
2693 # Error
2694  
2695 =cut
2696  
2697 $test->for('raise', 'execute', 'Venus::Error', sub {
2698 my ($tryable) = @_;
2699 my $error = $tryable->error->result;
2700 $test->is_error($error);
2701 });
2702  
2703 The C<raise $name $error> block documents an exception that may be thrown by
2704 an API (attribute, function, method, or routine). The parameters are:
2705  
2706 =over 4
2707  
2708 =item * C<$name> - The name of the attribute, function, method, or routine that may throw the exception.
2709  
2710 =item * C<$error> - The error class or package that may be caught (e.g., C<Venus::Error>, C<Example::Error>).
2711  
2712 =item * C<$id> (optional) - An error name for further classification within the error class.
2713  
2714 =back
2715  
2716 The C<$error> represents the exception class that calling code can catch using
2717 a try/catch mechanism. This links the API documentation to error handling
2718 expectations.
2719  
2720 An optional C<$id> can be appended to specify a named error. Venus::Error
2721 objects support named errors for further classification:
2722  
2723 =raise execute Venus::Error on.unknown
2724  
2725 # given: synopsis
2726  
2727 $example->operation; # throw exception
2728  
2729 # Error (on.unknown)
2730  
2731 =cut
2732  
2733 $test->for('raise', 'execute', 'Venus::Error', 'on.unknown', sub {
2734 my ($tryable) = @_;
2735 my $error = $tryable->error->result;
2736 $test->is_error($error);
2737 $test->is($error->name, 'on.unknown');
2738 });
2739  
2740 When C<$id> is provided, it indicates a specific named error within the error
2741 class, allowing for more granular error documentation and handling.
2742  
2743 =head1 FEATURE BLOCKS
2744  
2745 These blocks document special capabilities, errors, and operator overloads.
2746  
2747 =head2 feature
2748  
2749 =feature noop
2750  
2751 This package provides no particularly useful features.
2752  
2753 =example-1 noop
2754  
2755 # given: synopsis
2756  
2757 my $feature = $example->feature;
2758  
2759 # "..."
2760  
2761 =cut
2762  
2763 $test->for('feature');
2764  
2765 $test->for('example', 1, 'noop', sub {
2766 my ($tryable) = @_;
2767 $tryable->result;
2768 });
2769  
2770 The C<feature $name> block should contain a description of the feature(s) the
2771 package enables, and can include an C<example-$number $name> block to ensure
2772 the feature described works as expected.
2773  
2774 =head2 error
2775  
2776 =error error_on_unknown
2777  
2778 This package may raise an error_on_unknown error.
2779  
2780 =example-1 error_on_unknown
2781  
2782 # given: synopsis
2783  
2784 my $error = $example->catch('error', {
2785 with => 'error_on_unknown',
2786 });
2787  
2788 # "..."
2789  
2790 =cut
2791  
2792 $test->for('error', 'error_on_unknown');
2793  
2794 $test->for('example', 1, 'error_on_unknown', sub {
2795 my ($tryable) = @_;
2796 $tryable->result;
2797 });
2798  
2799 The C<error $name> block should contain a description of the error the package
2800 may raise, and can include an C<example-$number $name> block to ensure the
2801 error is raised and caught.
2802  
2803 =head2 operator
2804  
2805 =operator ("")
2806  
2807 This package overloads the C<""> operator.
2808  
2809 =example-1 ("")
2810  
2811 # given: synopsis
2812  
2813 my $string = "$example";
2814  
2815 # "..."
2816  
2817 =cut
2818  
2819 $test->for('operator', '("")');
2820  
2821 $test->for('example', 1, '("")', sub {
2822 my ($tryable) = @_;
2823 $tryable->result;
2824 });
2825  
2826 The C<operator $name> block should contain a description of the overloaded
2827 operation the package performs, and can include an C<example-$number $name>
2828 block to ensure the operation is functioning properly.
2829  
2830 =head1 CONTROL BLOCKS
2831  
2832 These blocks control how documentation is rendered.
2833  
2834 =head2 encoding
2835  
2836 =encoding
2837  
2838 utf8
2839  
2840 =cut
2841  
2842 $test->for('encoding');
2843  
2844 The C<encoding> block should contain the appropriate
2845 L<encoding|perlpod/encoding-encodingname>.
2846  
2847 =head2 layout
2848  
2849 =layout
2850  
2851 encoding
2852 name
2853 synopsis
2854 description
2855 attributes: attribute
2856 authors
2857 license
2858  
2859 =cut
2860  
2861 $test->for('layout');
2862  
2863 The C<layout> block should contain a list of blocks to render using L</render>,
2864 in the order they should be rendered.
2865  
2866 =head2 partials
2867  
2868 =partials
2869  
2870 t/path/to/other.t: present: authors
2871 t/path/to/other.t: present: license
2872  
2873 =cut
2874  
2875 $test->for('partials');
2876  
2877 The C<partials> block should contain references to other marked-up test files
2878 in the form of C<$file: $method: $section>, which will call the C<$method> on a
2879 L<Venus::Test> instance for the C<$file> and include the results in-place as
2880 part of the rendering of the current file.
2881  
2882 =head1 PROJECT BLOCKS
2883  
2884 These blocks provide metadata about the project.
2885  
2886 =head2 authors
2887  
2888 =authors
2889  
2890 Awncorp, C<awncorp@cpan.org>
2891  
2892 =cut
2893  
2894 $test->for('authors');
2895  
2896 The C<authors> block should contain text describing the authors of the package.
2897  
2898 =head2 license
2899  
2900 =license
2901  
2902 No license granted.
2903  
2904 =cut
2905  
2906 $test->for('license');
2907  
2908 The C<license> block should contain a link and/or description of the license
2909 governing the package.
2910  
2911 =head2 project
2912  
2913 =project
2914  
2915 https://github.com/awncorp/example
2916  
2917 =cut
2918  
2919 $test->for('project');
2920  
2921 The C<project> block should contain a description and/or links for the
2922 package's project.
2923  
2924 =head2 version
2925  
2926 =version
2927  
2928 1.2.3
2929  
2930 =cut
2931  
2932 $test->for('version');
2933  
2934 The C<version> block should contain a valid version number for the package.
2935  
2936 =head1 TESTING
2937  
2938 This framework provides automated subtests based on the package specification,
2939 but also provides hooks for manual testing when automation is not sufficient.
2940  
2941 =head2 Basic Testing
2942  
2943 For simple blocks, testing verifies existence:
2944  
2945 $test->for('name');
2946 $test->for('abstract');
2947 $test->for('description');
2948  
2949 =head2 Testing with Callbacks
2950  
2951 Code examples can be evaluated and returned using a callback for further
2952 testing:
2953  
2954 $test->for('synopsis', sub {
2955 my ($tryable) = @_;
2956  
2957 my $result = $tryable->result;
2958  
2959 # must return truthy to continue
2960 $result;
2961 });
2962  
2963 =head2 Exception Testing
2964  
2965 Because code examples are returned as L<Venus::Try> objects, capturing and
2966 testing exceptions is straightforward:
2967  
2968 $test->for('synopsis', sub {
2969 my ($tryable) = @_;
2970  
2971 # catch exception thrown by the synopsis
2972 $tryable->catch('Path::Find::Error', sub {
2973 return $_[0];
2974 });
2975  
2976 # test the exception
2977 my $result = $tryable->result;
2978 ok $result->isa('Path::Find::Error'), 'exception caught';
2979  
2980 # must return truthy to continue
2981 $result;
2982 });
2983  
2984 =head2 Testing Examples
2985  
2986 The C<example> method evaluates a given example and returns the result as a
2987 L<Venus::Try> object. The first argument is the example number:
2988  
2989 $test->for('example', 1, 'children', sub {
2990 my ($tryable) = @_;
2991  
2992 my $result = $tryable->result;
2993  
2994 # must return truthy to continue
2995 $result;
2996 });
2997  
2998 =head2 Testing Features
2999  
3000 The C<feature> method evaluates a documented feature and returns the result as
3001 a L<Venus::Try> object:
3002  
3003 $test->for('feature', 'export-path-make', sub {
3004 my ($tryable) = @_;
3005  
3006 ok my $result = $tryable->result, 'result ok';
3007  
3008 # must return truthy to continue
3009 $result;
3010 });
3011  
3012 =head2 Benefits
3013  
3014 The test automation and documentation generation enabled through this framework
3015 makes it easy to maintain source/test/documentation parity. This also increases
3016 reusability and reduces the need for complicated state and test setup.
3017  
3018 =cut
3019  
3020 =head1 ATTRIBUTES
3021  
3022 This package has the following attributes:
3023  
3024 =cut
3025  
3026 =head2 file
3027  
3028 file(string $data) (string)
3029  
3030 The file attribute is read-write, accepts C<(string)> values, and is required.
3031  
3032 I<Since C<4.15>>
3033  
3034 =over 4
3035  
3036 =item file example 1
3037  
3038 # given: synopsis
3039  
3040 package main;
3041  
3042 my $set_file = $test->file("t/Venus_Test.t");
3043  
3044 # "t/Venus_Test.t"
3045  
3046 =back
3047  
3048 =over 4
3049  
3050 =item file example 2
3051  
3052 # given: synopsis
3053  
3054 # given: example-1 file
3055  
3056 package main;
3057  
3058 my $get_file = $test->file;
3059  
3060 # "t/Venus_Test.t"
3061  
3062 =back
3063  
3064 =cut
3065  
3066 =head1 INHERITS
3067  
3068 This package inherits behaviors from:
3069  
3070 L<Venus::Kind>
3071  
3072 =cut
3073  
3074 =head1 INTEGRATES
3075  
3076 This package integrates behaviors from:
3077  
3078 L<Venus::Role::Buildable>
3079  
3080 L<Venus::Role::Encaseable>
3081  
3082 =cut
3083  
3084 =head1 FUNCTIONS
3085  
3086 This package provides the following functions:
3087  
3088 =cut
3089  
3090 =head2 test
3091  
3092 test(string $file) (Venus::Test)
3093  
3094 The test function is exported automatically and returns a L<Venus::Test> object
3095 for the test file given.
3096  
3097 I<Since C<0.09>>
3098  
3099 =over 4
3100  
3101 =item test example 1
3102  
3103 package main;
3104  
3105 use Venus::Test;
3106  
3107 my $test = test 't/Venus_Test.t';
3108  
3109 # bless(..., "Venus::Test")
3110  
3111 =back
3112  
3113 =cut
3114  
3115 =head1 METHODS
3116  
3117 This package provides the following methods:
3118  
3119 =cut
3120  
3121 =head2 auto
3122  
3123 auto(string $name, any @args) (any)
3124  
3125 The auto method gets or sets environment variables that control automatic
3126 behaviors in the testing framework. When called with just a name, it returns
3127 the current value of the corresponding environment variable. When called with
3128 a name and value, it sets the environment variable. The environment variable
3129 name is derived from the name parameter as C<VENUS_TEST_AUTO_${NAME}>.
3130  
3131 Supported auto settings:
3132  
3133 =over 4
3134  
3135 =item * C<bailout> - When truthy, bails out of testing on the first error.
3136  
3137 =item * C<render> - When truthy, automatically renders POD when L</done> is
3138 called.
3139  
3140 =item * C<scrub> - When truthy, uses L<Venus::Space/scrub> to clean up packages
3141 created in example code for testing.
3142  
3143 =item * C<unpatch> - When truthy, uses L<Venus::Space/unpatch> (via
3144 L</unpatch>) to restore any existing monkey-patching on the package associated
3145 with the test.
3146  
3147 =back
3148  
3149 I<Since C<4.15>>
3150  
3151 =over 4
3152  
3153 =item auto example 1
3154  
3155 # given: synopsis
3156  
3157 package main;
3158  
3159 my $auto = $test->auto('render');
3160  
3161 # undef
3162  
3163 =back
3164  
3165 =over 4
3166  
3167 =item auto example 2
3168  
3169 # given: synopsis
3170  
3171 package main;
3172  
3173 my $auto = $test->auto('render', 1);
3174  
3175 # 1
3176  
3177 =back
3178  
3179 =over 4
3180  
3181 =item auto example 3
3182  
3183 # given: synopsis
3184  
3185 package main;
3186  
3187 $test->auto('render', 1);
3188  
3189 my $auto = $test->auto('render');
3190  
3191 # 1
3192  
3193 =back
3194  
3195 =over 4
3196  
3197 =item auto example 4
3198  
3199 # given: synopsis
3200  
3201 package main;
3202  
3203 $test->auto('render', 0);
3204  
3205 my $auto = $test->auto('render');
3206  
3207 # 0
3208  
3209 =back
3210  
3211 =over 4
3212  
3213 =item auto example 5
3214  
3215 # given: synopsis
3216  
3217 package main;
3218  
3219 my $auto = $test->auto('bailout');
3220  
3221 # undef
3222  
3223 =back
3224  
3225 =over 4
3226  
3227 =item auto example 6
3228  
3229 # given: synopsis
3230  
3231 package main;
3232  
3233 my $auto = $test->auto('bailout', 1);
3234  
3235 # 1
3236  
3237 =back
3238  
3239 =over 4
3240  
3241 =item auto example 7
3242  
3243 # given: synopsis
3244  
3245 package main;
3246  
3247 $test->auto('bailout', 1);
3248  
3249 my $auto = $test->auto('bailout');
3250  
3251 # 1
3252  
3253 =back
3254  
3255 =over 4
3256  
3257 =item auto example 8
3258  
3259 # given: synopsis
3260  
3261 package main;
3262  
3263 $test->auto('bailout', 0);
3264  
3265 my $auto = $test->auto('bailout');
3266  
3267 # 0
3268  
3269 =back
3270  
3271 =over 4
3272  
3273 =item auto example 9
3274  
3275 # given: synopsis
3276  
3277 package main;
3278  
3279 my $auto = $test->auto('scrub');
3280  
3281 # undef
3282  
3283 =back
3284  
3285 =over 4
3286  
3287 =item auto example 10
3288  
3289 # given: synopsis
3290  
3291 package main;
3292  
3293 my $auto = $test->auto('scrub', 1);
3294  
3295 # 1
3296  
3297 =back
3298  
3299 =over 4
3300  
3301 =item auto example 11
3302  
3303 # given: synopsis
3304  
3305 package main;
3306  
3307 $test->auto('scrub', 1);
3308  
3309 my $auto = $test->auto('scrub');
3310  
3311 # 1
3312  
3313 =back
3314  
3315 =over 4
3316  
3317 =item auto example 12
3318  
3319 # given: synopsis
3320  
3321 package main;
3322  
3323 $test->auto('scrub', 0);
3324  
3325 my $auto = $test->auto('scrub');
3326  
3327 # 0
3328  
3329 =back
3330  
3331 =over 4
3332  
3333 =item auto example 13
3334  
3335 # given: synopsis
3336  
3337 package main;
3338  
3339 my $auto = $test->auto('unpatch');
3340  
3341 # undef
3342  
3343 =back
3344  
3345 =over 4
3346  
3347 =item auto example 14
3348  
3349 # given: synopsis
3350  
3351 package main;
3352  
3353 my $auto = $test->auto('unpatch', 1);
3354  
3355 # 1
3356  
3357 =back
3358  
3359 =over 4
3360  
3361 =item auto example 15
3362  
3363 # given: synopsis
3364  
3365 package main;
3366  
3367 $test->auto('unpatch', 1);
3368  
3369 my $auto = $test->auto('unpatch');
3370  
3371 # 1
3372  
3373 =back
3374  
3375 =over 4
3376  
3377 =item auto example 16
3378  
3379 # given: synopsis
3380  
3381 package main;
3382  
3383 $test->auto('unpatch', 0);
3384  
3385 my $auto = $test->auto('unpatch');
3386  
3387 # 0
3388  
3389 =back
3390  
3391 =cut
3392  
3393 =head2 diag
3394  
3395 diag(string @messages) (any)
3396  
3397 The diag method prints diagnostic messages using L<Test::More/diag>.
3398  
3399 I<Since C<4.15>>
3400  
3401 =over 4
3402  
3403 =item diag example 1
3404  
3405 # given: synopsis
3406  
3407 package main;
3408  
3409 my $diag = $test->diag('Test failed due to...');
3410  
3411 # ()
3412  
3413 =back
3414  
3415 =cut
3416  
3417 =head2 done
3418  
3419 done() (any)
3420  
3421 The done method dispatches to the L<Test::More/done_testing> operation and
3422 returns the result.
3423  
3424 I<Since C<4.15>>
3425  
3426 =over 4
3427  
3428 =item done example 1
3429  
3430 # given: synopsis
3431  
3432 package main;
3433  
3434 my $done = $test->done;
3435  
3436 # true
3437  
3438 =back
3439  
3440 =cut
3441  
3442 =head2 eval
3443  
3444 eval(string $perl) (any)
3445  
3446 The eval method evaluates Perl code and returns the result.
3447  
3448 I<Since C<4.15>>
3449  
3450 =over 4
3451  
3452 =item eval example 1
3453  
3454 # given: synopsis
3455  
3456 package main;
3457  
3458 my $eval = $test->eval('1 + 1');
3459  
3460 # 2
3461  
3462 =back
3463  
3464 =cut
3465  
3466 =head2 explain
3467  
3468 explain(any @args) (any)
3469  
3470 The explain method dispatches to the L<Test::More/explain> operation and
3471 returns the result.
3472  
3473 I<Since C<4.15>>
3474  
3475 =over 4
3476  
3477 =item explain example 1
3478  
3479 # given: synopsis
3480  
3481 package main;
3482  
3483 my $explain = $test->explain(123.456);
3484  
3485 # "123.456"
3486  
3487 =back
3488  
3489 =cut
3490  
3491 =head2 fail
3492  
3493 fail(any $data, string $description) (any)
3494  
3495 The fail method dispatches to the L<Test::More/ok> operation expecting the
3496 first argument to be falsy and returns the result.
3497  
3498 I<Since C<4.15>>
3499  
3500 =over 4
3501  
3502 =item fail example 1
3503  
3504 # given: synopsis
3505  
3506 package main;
3507  
3508 my $fail = $test->fail(0, 'example-1 fail passed');
3509  
3510 # true
3511  
3512 =back
3513  
3514 =cut
3515  
3516 =head2 for
3517  
3518 for(any @args) (Venus::Test)
3519  
3520 The for method dispatches to the L</execute> method using the arguments
3521 provided within a L<subtest|Test::More/subtest> and returns the invocant.
3522  
3523 I<Since C<4.15>>
3524  
3525 =over 4
3526  
3527 =item for example 1
3528  
3529 # given: synopsis
3530  
3531 package main;
3532  
3533 my $for = $test->for('name');
3534  
3535 # bless(..., "Venus::Test")
3536  
3537 =back
3538  
3539 =over 4
3540  
3541 =item for example 2
3542  
3543 # given: synopsis
3544  
3545 package main;
3546  
3547 my $for = $test->for('synopsis');
3548  
3549 # bless(..., "Venus::Test")
3550  
3551 =back
3552  
3553 =over 4
3554  
3555 =item for example 3
3556  
3557 # given: synopsis
3558  
3559 package main;
3560  
3561 my $for = $test->for('synopsis', sub{
3562 my ($tryable) = @_;
3563 return $tryable->result;
3564 });
3565  
3566 # bless(..., "Venus::Test")
3567  
3568 =back
3569  
3570 =over 4
3571  
3572 =item for example 4
3573  
3574 # given: synopsis
3575  
3576 package main;
3577  
3578 my $for = $test->for('example', 1, 'test', sub {
3579 my ($tryable) = @_;
3580 return $tryable->result;
3581 });
3582  
3583 # bless(..., "Venus::Test")
3584  
3585 =back
3586  
3587 =cut
3588  
3589 =head2 gate
3590  
3591 gate(string $note, coderef $code) (Venus::Test)
3592  
3593 The gate method creates a new L<Venus::Test> instance with a gate callback that
3594 prevents subtests from running unless the callback returns a truthy value.
3595  
3596 I<Since C<4.15>>
3597  
3598 =over 4
3599  
3600 =item gate example 1
3601  
3602 # given: synopsis
3603  
3604 package main;
3605  
3606 my $test2 = $test->gate('OS is linux', sub {
3607 $^O eq 'linux'
3608 });
3609  
3610 # bless(..., "Venus::Test")
3611  
3612 =back
3613  
3614 =cut
3615  
3616 =head2 handler
3617  
3618 handler(any @args) (any)
3619  
3620 The handler method dispatches to the L<Test::More> method specified by the
3621 first argument and returns its result.
3622  
3623 I<Since C<4.15>>
3624  
3625 =over 4
3626  
3627 =item handler example 1
3628  
3629 # given: synopsis
3630  
3631 package main;
3632  
3633 my $handler = $test->handler('ok', true);
3634  
3635 # true
3636  
3637 =back
3638  
3639 =cut
3640  
3641 =head2 in
3642  
3643 in(arrayref | hashref | consumes[Venus::Role::Mappable] $collection, any $value) (boolean)
3644  
3645 The in method checks if a value exists in a collection (arrayref, hashref, or
3646 L<"mappable"|Venus::Role::Mappable> object) and returns true if the type and
3647 value match.
3648  
3649 I<Since C<4.15>>
3650  
3651 =over 4
3652  
3653 =item in example 1
3654  
3655 # given: synopsis
3656  
3657 package main;
3658  
3659 my $in = $test->in([1, 2, 3], 2);
3660  
3661 # true
3662  
3663 =back
3664  
3665 =cut
3666  
3667 =head2 is
3668  
3669 is(any $data1, any $data2, string $description) (any)
3670  
3671 The is method tests for equality using L<Test::More/is>.
3672  
3673 I<Since C<4.15>>
3674  
3675 =over 4
3676  
3677 =item is example 1
3678  
3679 # given: synopsis
3680  
3681 package main;
3682  
3683 my $is = $test->is('hello', 'hello', 'strings match');
3684  
3685 # ()
3686  
3687 =back
3688  
3689 =cut
3690  
3691 =head2 is_arrayref
3692  
3693 is_arrayref(any $data, string @args) (boolean)
3694  
3695 The is_arrayref method tests whether the data is an arrayref using
3696 L<Venus/is_arrayref>.
3697  
3698 I<Since C<4.15>>
3699  
3700 =over 4
3701  
3702 =item is_arrayref example 1
3703  
3704 # given: synopsis
3705  
3706 package main;
3707  
3708 my $is_arrayref = $test->is_arrayref([1,2,3], 'valid arrayref');
3709  
3710 # true
3711  
3712 =back
3713  
3714 =cut
3715  
3716 =head2 is_blessed
3717  
3718 is_blessed(any $data, string @args) (boolean)
3719  
3720 The is_blessed method tests whether the data is blessed using
3721 L<Venus/is_blessed>.
3722  
3723 I<Since C<4.15>>
3724  
3725 =over 4
3726  
3727 =item is_blessed example 1
3728  
3729 # given: synopsis
3730  
3731 package main;
3732  
3733 my $is_blessed = $test->is_blessed(bless({}), 'valid blessed');
3734  
3735 # true
3736  
3737 =back
3738  
3739 =cut
3740  
3741 =head2 is_boolean
3742  
3743 is_boolean(any $data, string @args) (boolean)
3744  
3745 The is_boolean method tests whether the data is a boolean using
3746 L<Venus/is_boolean>.
3747  
3748 I<Since C<4.15>>
3749  
3750 =over 4
3751  
3752 =item is_boolean example 1
3753  
3754 # given: synopsis
3755  
3756 package main;
3757  
3758 require Venus;
3759  
3760 my $is_boolean = $test->is_boolean(true, 'valid boolean');
3761  
3762 # true
3763  
3764 =back
3765  
3766 =cut
3767  
3768 =head2 is_coderef
3769  
3770 is_coderef(any $data, string @args) (boolean)
3771  
3772 The is_coderef method tests whether the data is a coderef using
3773 L<Venus/is_coderef>.
3774  
3775 I<Since C<4.15>>
3776  
3777 =over 4
3778  
3779 =item is_coderef example 1
3780  
3781 # given: synopsis
3782  
3783 package main;
3784  
3785 my $is_coderef = $test->is_coderef(sub{}, 'valid coderef');
3786  
3787 # true
3788  
3789 =back
3790  
3791 =cut
3792  
3793 =head2 is_dirhandle
3794  
3795 is_dirhandle(any $data, string @args) (boolean)
3796  
3797 The is_dirhandle method tests whether the data is a directory handle using
3798 L<Venus/is_dirhandle>.
3799  
3800 I<Since C<4.15>>
3801  
3802 =over 4
3803  
3804 =item is_dirhandle example 1
3805  
3806 # given: synopsis
3807  
3808 package main;
3809  
3810 opendir(my $dh, '.');
3811 my $is_dirhandle = $test->is_dirhandle($dh, 'valid dirhandle');
3812  
3813 # true
3814  
3815 =back
3816  
3817 =cut
3818  
3819 =head2 is_enum
3820  
3821 is_enum(any $data, arrayref | hashref $data, string @args) (boolean)
3822  
3823 The is_enum method tests whether the data is an enum using L<Venus/is_enum>.
3824  
3825 I<Since C<4.15>>
3826  
3827 =over 4
3828  
3829 =item is_enum example 1
3830  
3831 # given: synopsis
3832  
3833 package main;
3834  
3835 $test->is_enum('light', ['light', 'dark'], 'is in enum');
3836  
3837 # true
3838  
3839 =back
3840  
3841 =cut
3842  
3843 =head2 is_error
3844  
3845 is_error(any $data, string @args) (boolean)
3846  
3847 The is_error method tests whether the data is a Venus::Error object using
3848 L<Venus/is_error>.
3849  
3850 I<Since C<4.15>>
3851  
3852 =over 4
3853  
3854 =item is_error example 1
3855  
3856 # given: synopsis
3857  
3858 package main;
3859  
3860 use Venus::Error;
3861  
3862 my $is_error = $test->is_error(Venus::Error->new, 'valid error');
3863  
3864 # true
3865  
3866 =back
3867  
3868 =cut
3869  
3870 =head2 is_false
3871  
3872 is_false(any $data, string @args) (boolean)
3873  
3874 The is_false method tests whether the data is a false value using
3875 L<Venus/is_false>.
3876  
3877 I<Since C<4.15>>
3878  
3879 =over 4
3880  
3881 =item is_false example 1
3882  
3883 # given: synopsis
3884  
3885 package main;
3886  
3887 my $is_false = $test->is_false(0, 'valid false');
3888  
3889 # true
3890  
3891 =back
3892  
3893 =cut
3894  
3895 =head2 is_fault
3896  
3897 is_fault(any $data, string @args) (boolean)
3898  
3899 The is_fault method tests whether the data is a Venus::Fault object using
3900 L<Venus/is_fault>.
3901  
3902 I<Since C<4.15>>
3903  
3904 =over 4
3905  
3906 =item is_fault example 1
3907  
3908 # given: synopsis
3909  
3910 package main;
3911  
3912 use Venus::Fault;
3913  
3914 my $is_fault = $test->is_fault(Venus::Fault->new, 'valid fault');
3915  
3916 # true
3917  
3918 =back
3919  
3920 =cut
3921  
3922 =head2 is_filehandle
3923  
3924 is_filehandle(any $data, string @args) (boolean)
3925  
3926 The is_filehandle method tests whether the data is a file handle using
3927 L<Venus/is_filehandle>.
3928  
3929 I<Since C<4.15>>
3930  
3931 =over 4
3932  
3933 =item is_filehandle example 1
3934  
3935 # given: synopsis
3936  
3937 package main;
3938  
3939 open(my $fh, '<', 't/Venus_Test.t');
3940 my $is_filehandle = $test->is_filehandle($fh, 'valid filehandle');
3941  
3942 # true
3943  
3944 =back
3945  
3946 =cut
3947  
3948 =head2 is_float
3949  
3950 is_float(any $data, string @args) (boolean)
3951  
3952 The is_float method tests whether the data is a float using L<Venus/is_float>.
3953  
3954 I<Since C<4.15>>
3955  
3956 =over 4
3957  
3958 =item is_float example 1
3959  
3960 # given: synopsis
3961  
3962 package main;
3963  
3964 my $is_float = $test->is_float(1.5, 'valid float');
3965  
3966 # true
3967  
3968 =back
3969  
3970 =cut
3971  
3972 =head2 is_glob
3973  
3974 is_glob(any $data, string @args) (boolean)
3975  
3976 The is_glob method tests whether the data is a glob reference using
3977 L<Venus/is_glob>.
3978  
3979 I<Since C<4.15>>
3980  
3981 =over 4
3982  
3983 =item is_glob example 1
3984  
3985 # given: synopsis
3986  
3987 package main;
3988  
3989 my $is_glob = $test->is_glob(\*STDOUT, 'valid glob');
3990  
3991 # true
3992  
3993 =back
3994  
3995 =cut
3996  
3997 =head2 is_hashref
3998  
3999 is_hashref(any $data, string @args) (boolean)
4000  
4001 The is_hashref method tests whether the data is a hashref using
4002 L<Venus/is_hashref>.
4003  
4004 I<Since C<4.15>>
4005  
4006 =over 4
4007  
4008 =item is_hashref example 1
4009  
4010 # given: synopsis
4011  
4012 package main;
4013  
4014 my $is_hashref = $test->is_hashref({a=>1}, 'valid hashref');
4015  
4016 # true
4017  
4018 =back
4019  
4020 =cut
4021  
4022 =head2 is_number
4023  
4024 is_number(any $data, string @args) (boolean)
4025  
4026 The is_number method tests whether the data is a number using
4027 L<Venus/is_number>.
4028  
4029 I<Since C<4.15>>
4030  
4031 =over 4
4032  
4033 =item is_number example 1
4034  
4035 # given: synopsis
4036  
4037 package main;
4038  
4039 my $is_number = $test->is_number(123, 'valid number');
4040  
4041 # true
4042  
4043 =back
4044  
4045 =cut
4046  
4047 =head2 is_object
4048  
4049 is_object(any $data, string @args) (boolean)
4050  
4051 The is_object method tests whether the data is an object using
4052 L<Venus/is_object>.
4053  
4054 I<Since C<4.15>>
4055  
4056 =over 4
4057  
4058 =item is_object example 1
4059  
4060 # given: synopsis
4061  
4062 package main;
4063  
4064 my $is_object = $test->is_object(bless({}), 'valid object');
4065  
4066 # true
4067  
4068 =back
4069  
4070 =cut
4071  
4072 =head2 is_package
4073  
4074 is_package(any $data, string @args) (boolean)
4075  
4076 The is_package method tests whether the data is a package name using
4077 L<Venus/is_package>.
4078  
4079 I<Since C<4.15>>
4080  
4081 =over 4
4082  
4083 =item is_package example 1
4084  
4085 # given: synopsis
4086  
4087 package main;
4088  
4089 my $is_package = $test->is_package('Venus::Test', 'valid package');
4090  
4091 # true
4092  
4093 =back
4094  
4095 =cut
4096  
4097 =head2 is_reference
4098  
4099 is_reference(any $data, string @args) (boolean)
4100  
4101 The is_reference method tests whether the data is a reference using
4102 L<Venus/is_reference>.
4103  
4104 I<Since C<4.15>>
4105  
4106 =over 4
4107  
4108 =item is_reference example 1
4109  
4110 # given: synopsis
4111  
4112 package main;
4113  
4114 my $is_reference = $test->is_reference([], 'valid reference');
4115  
4116 # true
4117  
4118 =back
4119  
4120 =cut
4121  
4122 =head2 is_regexp
4123  
4124 is_regexp(any $data, string @args) (boolean)
4125  
4126 The is_regexp method tests whether the data is a regexp using
4127 L<Venus/is_regexp>.
4128  
4129 I<Since C<4.15>>
4130  
4131 =over 4
4132  
4133 =item is_regexp example 1
4134  
4135 # given: synopsis
4136  
4137 package main;
4138  
4139 my $is_regexp = $test->is_regexp(qr/test/, 'valid regexp');
4140  
4141 # true
4142  
4143 =back
4144  
4145 =cut
4146  
4147 =head2 is_scalarref
4148  
4149 is_scalarref(any $data, string @args) (boolean)
4150  
4151 The is_scalarref method tests whether the data is a scalar reference using
4152 L<Venus/is_scalarref>.
4153  
4154 I<Since C<4.15>>
4155  
4156 =over 4
4157  
4158 =item is_scalarref example 1
4159  
4160 # given: synopsis
4161  
4162 package main;
4163  
4164 my $scalar = 'hello';
4165 my $is_scalarref = $test->is_scalarref(\$scalar, 'valid scalarref');
4166  
4167 # true
4168  
4169 =back
4170  
4171 =cut
4172  
4173 =head2 is_string
4174  
4175 is_string(any $data, string @args) (boolean)
4176  
4177 The is_string method tests whether the data is a string using
4178 L<Venus/is_string>.
4179  
4180 I<Since C<4.15>>
4181  
4182 =over 4
4183  
4184 =item is_string example 1
4185  
4186 # given: synopsis
4187  
4188 package main;
4189  
4190 my $is_string = $test->is_string('hello', 'valid string');
4191  
4192 # true
4193  
4194 =back
4195  
4196 =cut
4197  
4198 =head2 is_true
4199  
4200 is_true(any $data, string @args) (boolean)
4201  
4202 The is_true method tests whether the data is a true value using L<Venus/is_true>.
4203  
4204 I<Since C<4.15>>
4205  
4206 =over 4
4207  
4208 =item is_true example 1
4209  
4210 # given: synopsis
4211  
4212 package main;
4213  
4214 my $is_true = $test->is_true(1, 'valid true');
4215  
4216 # true
4217  
4218 =back
4219  
4220 =cut
4221  
4222 =head2 is_undef
4223  
4224 is_undef(any $data, string @args) (boolean)
4225  
4226 The is_undef method tests whether the data is undef using L<Venus/is_undef>.
4227  
4228 I<Since C<4.15>>
4229  
4230 =over 4
4231  
4232 =item is_undef example 1
4233  
4234 # given: synopsis
4235  
4236 package main;
4237  
4238 my $is_undef = $test->is_undef(undef, 'valid undef');
4239  
4240 # true
4241  
4242 =back
4243  
4244 =cut
4245  
4246 =head2 is_value
4247  
4248 is_value(any $data, string @args) (boolean)
4249  
4250 The is_value method tests whether the data is a defined value using
4251 L<Venus/is_value>.
4252  
4253 I<Since C<4.15>>
4254  
4255 =over 4
4256  
4257 =item is_value example 1
4258  
4259 # given: synopsis
4260  
4261 package main;
4262  
4263 my $is_value = $test->is_value('hello', 'valid value');
4264  
4265 # true
4266  
4267 =back
4268  
4269 =cut
4270  
4271 =head2 is_yesno
4272  
4273 is_yesno(any $data, string @args) (boolean)
4274  
4275 The is_yesno method tests whether the data is a yes/no value using
4276 L<Venus/is_yesno>.
4277  
4278 I<Since C<4.15>>
4279  
4280 =over 4
4281  
4282 =item is_yesno example 1
4283  
4284 # given: synopsis
4285  
4286 package main;
4287  
4288 my $is_yesno = $test->is_yesno(1, 'valid yesno');
4289  
4290 # true
4291  
4292 =back
4293  
4294 =cut
4295  
4296 =head2 isnt
4297  
4298 isnt(any $data1, any $data2, string $description) (any)
4299  
4300 The isnt method tests for inequality using L<Test::More/isnt>.
4301  
4302 I<Since C<4.15>>
4303  
4304 =over 4
4305  
4306 =item isnt example 1
4307  
4308 # given: synopsis
4309  
4310 package main;
4311  
4312 my $isnt = $test->isnt('hello', 'world', 'strings differ');
4313  
4314 # ()
4315  
4316 =back
4317  
4318 =cut
4319  
4320 =head2 isnt_arrayref
4321  
4322 isnt_arrayref(any $data, string @args) (boolean)
4323  
4324 The isnt_arrayref method tests whether the data is not an arrayref.
4325  
4326 I<Since C<4.15>>
4327  
4328 =over 4
4329  
4330 =item isnt_arrayref example 1
4331  
4332 # given: synopsis
4333  
4334 package main;
4335  
4336 my $isnt_arrayref = $test->isnt_arrayref({}, 'not an arrayref');
4337  
4338 # true
4339  
4340 =back
4341  
4342 =cut
4343  
4344 =head2 isnt_blessed
4345  
4346 isnt_blessed(any $data, string @args) (boolean)
4347  
4348 The isnt_blessed method tests whether the data is not a blessed object.
4349  
4350 I<Since C<4.15>>
4351  
4352 =over 4
4353  
4354 =item isnt_blessed example 1
4355  
4356 # given: synopsis
4357  
4358 package main;
4359  
4360 my $isnt_blessed = $test->isnt_blessed('string', 'not blessed');
4361  
4362 # true
4363  
4364 =back
4365  
4366 =cut
4367  
4368 =head2 isnt_boolean
4369  
4370 isnt_boolean(any $data, string @args) (boolean)
4371  
4372 The isnt_boolean method tests whether the data is not a boolean.
4373  
4374 I<Since C<4.15>>
4375  
4376 =over 4
4377  
4378 =item isnt_boolean example 1
4379  
4380 # given: synopsis
4381  
4382 package main;
4383  
4384 my $isnt_boolean = $test->isnt_boolean('string', 'not boolean');
4385  
4386 # true
4387  
4388 =back
4389  
4390 =cut
4391  
4392 =head2 isnt_coderef
4393  
4394 isnt_coderef(any $data, string @args) (boolean)
4395  
4396 The isnt_coderef method tests whether the data is not a coderef.
4397  
4398 I<Since C<4.15>>
4399  
4400 =over 4
4401  
4402 =item isnt_coderef example 1
4403  
4404 # given: synopsis
4405  
4406 package main;
4407  
4408 my $isnt_coderef = $test->isnt_coderef('string', 'not coderef');
4409  
4410 # true
4411  
4412 =back
4413  
4414 =cut
4415  
4416 =head2 isnt_dirhandle
4417  
4418 isnt_dirhandle(any $data, string @args) (boolean)
4419  
4420 The isnt_dirhandle method tests whether the data is not a directory handle.
4421  
4422 I<Since C<4.15>>
4423  
4424 =over 4
4425  
4426 =item isnt_dirhandle example 1
4427  
4428 # given: synopsis
4429  
4430 package main;
4431  
4432 my $isnt_dirhandle = $test->isnt_dirhandle('string', 'not dirhandle');
4433  
4434 # true
4435  
4436 =back
4437  
4438 =cut
4439  
4440 =head2 isnt_enum
4441  
4442 isnt_enum(any $data, arrayref | hashref $data, string @args) (boolean)
4443  
4444 The isnt_enum method tests whether the data is not an enum.
4445  
4446 I<Since C<4.15>>
4447  
4448 =over 4
4449  
4450 =item isnt_enum example 1
4451  
4452 # given: synopsis
4453  
4454 package main;
4455  
4456 my $isnt_enum = $test->isnt_enum('light', [], 'not in enum');
4457  
4458 # true
4459  
4460 =back
4461  
4462 =cut
4463  
4464 =head2 isnt_error
4465  
4466 isnt_error(any $data, string @args) (boolean)
4467  
4468 The isnt_error method tests whether the data is not a Venus::Error object.
4469  
4470 I<Since C<4.15>>
4471  
4472 =over 4
4473  
4474 =item isnt_error example 1
4475  
4476 # given: synopsis
4477  
4478 package main;
4479  
4480 my $isnt_error = $test->isnt_error('string', 'not error');
4481  
4482 # true
4483  
4484 =back
4485  
4486 =cut
4487  
4488 =head2 isnt_false
4489  
4490 isnt_false(any $data, string @args) (boolean)
4491  
4492 The isnt_false method tests whether the data is not a false value.
4493  
4494 I<Since C<4.15>>
4495  
4496 =over 4
4497  
4498 =item isnt_false example 1
4499  
4500 # given: synopsis
4501  
4502 package main;
4503  
4504 my $isnt_false = $test->isnt_false(1, 'not false');
4505  
4506 # true
4507  
4508 =back
4509  
4510 =cut
4511  
4512 =head2 isnt_fault
4513  
4514 isnt_fault(any $data, string @args) (boolean)
4515  
4516 The isnt_fault method tests whether the data is not a Venus::Fault object.
4517  
4518 I<Since C<4.15>>
4519  
4520 =over 4
4521  
4522 =item isnt_fault example 1
4523  
4524 # given: synopsis
4525  
4526 package main;
4527  
4528 my $isnt_fault = $test->isnt_fault('string', 'not fault');
4529  
4530 # true
4531  
4532 =back
4533  
4534 =cut
4535  
4536 =head2 isnt_filehandle
4537  
4538 isnt_filehandle(any $data, string @args) (boolean)
4539  
4540 The isnt_filehandle method tests whether the data is not a file handle.
4541  
4542 I<Since C<4.15>>
4543  
4544 =over 4
4545  
4546 =item isnt_filehandle example 1
4547  
4548 # given: synopsis
4549  
4550 package main;
4551  
4552 my $isnt_filehandle = $test->isnt_filehandle('string', 'not filehandle');
4553  
4554 # true
4555  
4556 =back
4557  
4558 =cut
4559  
4560 =head2 isnt_float
4561  
4562 isnt_float(any $data, string @args) (boolean)
4563  
4564 The isnt_float method tests whether the data is not a float.
4565  
4566 I<Since C<4.15>>
4567  
4568 =over 4
4569  
4570 =item isnt_float example 1
4571  
4572 # given: synopsis
4573  
4574 package main;
4575  
4576 my $isnt_float = $test->isnt_float(123, 'not float');
4577  
4578 # true
4579  
4580 =back
4581  
4582 =cut
4583  
4584 =head2 isnt_glob
4585  
4586 isnt_glob(any $data, string @args) (boolean)
4587  
4588 The isnt_glob method tests whether the data is not a glob reference.
4589  
4590 I<Since C<4.15>>
4591  
4592 =over 4
4593  
4594 =item isnt_glob example 1
4595  
4596 # given: synopsis
4597  
4598 package main;
4599  
4600 my $isnt_glob = $test->isnt_glob('string', 'not glob');
4601  
4602 # true
4603  
4604 =back
4605  
4606 =cut
4607  
4608 =head2 isnt_hashref
4609  
4610 isnt_hashref(any $data, string @args) (boolean)
4611  
4612 The isnt_hashref method tests whether the data is not a hashref.
4613  
4614 I<Since C<4.15>>
4615  
4616 =over 4
4617  
4618 =item isnt_hashref example 1
4619  
4620 # given: synopsis
4621  
4622 package main;
4623  
4624 my $isnt_hashref = $test->isnt_hashref([], 'not a hashref');
4625  
4626 # true
4627  
4628 =back
4629  
4630 =cut
4631  
4632 =head2 isnt_number
4633  
4634 isnt_number(any $data, string @args) (boolean)
4635  
4636 The isnt_number method tests whether the data is not a number.
4637  
4638 I<Since C<4.15>>
4639  
4640 =over 4
4641  
4642 =item isnt_number example 1
4643  
4644 # given: synopsis
4645  
4646 package main;
4647  
4648 my $isnt_number = $test->isnt_number('string', 'not number');
4649  
4650 # true
4651  
4652 =back
4653  
4654 =cut
4655  
4656 =head2 isnt_object
4657  
4658 isnt_object(any $data, string @args) (boolean)
4659  
4660 The isnt_object method tests whether the data is not an object.
4661  
4662 I<Since C<4.15>>
4663  
4664 =over 4
4665  
4666 =item isnt_object example 1
4667  
4668 # given: synopsis
4669  
4670 package main;
4671  
4672 my $isnt_object = $test->isnt_object('string', 'not object');
4673  
4674 # true
4675  
4676 =back
4677  
4678 =cut
4679  
4680 =head2 isnt_package
4681  
4682 isnt_package(any $data, string @args) (boolean)
4683  
4684 The isnt_package method tests whether the data is not a package name.
4685  
4686 I<Since C<4.15>>
4687  
4688 =over 4
4689  
4690 =item isnt_package example 1
4691  
4692 # given: synopsis
4693  
4694 package main;
4695  
4696 my $isnt_package = $test->isnt_package([], 'not package');
4697  
4698 # true
4699  
4700 =back
4701  
4702 =cut
4703  
4704 =head2 isnt_reference
4705  
4706 isnt_reference(any $data, string @args) (boolean)
4707  
4708 The isnt_reference method tests whether the data is not a reference.
4709  
4710 I<Since C<4.15>>
4711  
4712 =over 4
4713  
4714 =item isnt_reference example 1
4715  
4716 # given: synopsis
4717  
4718 package main;
4719  
4720 my $isnt_reference = $test->isnt_reference('string', 'not reference');
4721  
4722 # true
4723  
4724 =back
4725  
4726 =cut
4727  
4728 =head2 isnt_regexp
4729  
4730 isnt_regexp(any $data, string @args) (boolean)
4731  
4732 The isnt_regexp method tests whether the data is not a regexp.
4733  
4734 I<Since C<4.15>>
4735  
4736 =over 4
4737  
4738 =item isnt_regexp example 1
4739  
4740 # given: synopsis
4741  
4742 package main;
4743  
4744 my $isnt_regexp = $test->isnt_regexp('string', 'not regexp');
4745  
4746 # true
4747  
4748 =back
4749  
4750 =cut
4751  
4752 =head2 isnt_scalarref
4753  
4754 isnt_scalarref(any $data, string @args) (boolean)
4755  
4756 The isnt_scalarref method tests whether the data is not a scalar reference.
4757  
4758 I<Since C<4.15>>
4759  
4760 =over 4
4761  
4762 =item isnt_scalarref example 1
4763  
4764 # given: synopsis
4765  
4766 package main;
4767  
4768 my $isnt_scalarref = $test->isnt_scalarref('string', 'not scalarref');
4769  
4770 # true
4771  
4772 =back
4773  
4774 =cut
4775  
4776 =head2 isnt_string
4777  
4778 isnt_string(any $data, string @args) (boolean)
4779  
4780 The isnt_string method tests whether the data is not a string.
4781  
4782 I<Since C<4.15>>
4783  
4784 =over 4
4785  
4786 =item isnt_string example 1
4787  
4788 # given: synopsis
4789  
4790 package main;
4791  
4792 my $isnt_string = $test->isnt_string([], 'not string');
4793  
4794 # true
4795  
4796 =back
4797  
4798 =cut
4799  
4800 =head2 isnt_true
4801  
4802 isnt_true(any $data, string @args) (boolean)
4803  
4804 The isnt_true method tests whether the data is not a true value.
4805  
4806 I<Since C<4.15>>
4807  
4808 =over 4
4809  
4810 =item isnt_true example 1
4811  
4812 # given: synopsis
4813  
4814 package main;
4815  
4816 my $isnt_true = $test->isnt_true(0, 'not true');
4817  
4818 # true
4819  
4820 =back
4821  
4822 =cut
4823  
4824 =head2 isnt_undef
4825  
4826 isnt_undef(any $data, string @args) (boolean)
4827  
4828 The isnt_undef method tests whether the data is not undef.
4829  
4830 I<Since C<4.15>>
4831  
4832 =over 4
4833  
4834 =item isnt_undef example 1
4835  
4836 # given: synopsis
4837  
4838 package main;
4839  
4840 my $isnt_undef = $test->isnt_undef('string', 'not undef');
4841  
4842 # true
4843  
4844 =back
4845  
4846 =cut
4847  
4848 =head2 isnt_value
4849  
4850 isnt_value(any $data, string @args) (boolean)
4851  
4852 The isnt_value method tests whether the data is not a defined value.
4853  
4854 I<Since C<4.15>>
4855  
4856 =over 4
4857  
4858 =item isnt_value example 1
4859  
4860 # given: synopsis
4861  
4862 package main;
4863  
4864 my $isnt_value = $test->isnt_value(undef, 'not value');
4865  
4866 # true
4867  
4868 =back
4869  
4870 =cut
4871  
4872 =head2 isnt_yesno
4873  
4874 isnt_yesno(any $data, string @args) (boolean)
4875  
4876 The isnt_yesno method tests whether the data is not a yes/no value.
4877  
4878 I<Since C<4.15>>
4879  
4880 =over 4
4881  
4882 =item isnt_yesno example 1
4883  
4884 # given: synopsis
4885  
4886 package main;
4887  
4888 my $isnt_yesno = $test->isnt_yesno('string', 'not yesno');
4889  
4890 # true
4891  
4892 =back
4893  
4894 =cut
4895  
4896 =head2 lfile
4897  
4898 lfile() (Venus::Path)
4899  
4900 The lfile method returns the path to a lib file for the package being tested.
4901  
4902 I<Since C<4.15>>
4903  
4904 =over 4
4905  
4906 =item lfile example 1
4907  
4908 # given: synopsis
4909  
4910 package main;
4911  
4912 my $lfile = $test->lfile;
4913  
4914 # "lib/Venus/Test.pm"
4915  
4916 =back
4917  
4918 =cut
4919  
4920 =head2 like
4921  
4922 like(string $data, string | Venus::Regexp $match, string $description) (any)
4923  
4924 The like method dispatches to the L<Test::More/like> operation and returns the
4925 result.
4926  
4927 I<Since C<4.15>>
4928  
4929 =over 4
4930  
4931 =item like example 1
4932  
4933 # given: synopsis
4934  
4935 package main;
4936  
4937 my $like = $test->like('hello world', 'world', 'example-1 like passed');
4938  
4939 # true
4940  
4941 =back
4942  
4943 =over 4
4944  
4945 =item like example 2
4946  
4947 # given: synopsis
4948  
4949 package main;
4950  
4951 my $like = $test->like('hello world', qr/world/, 'example-1 like passed');
4952  
4953 # true
4954  
4955 =back
4956  
4957 =cut
4958  
4959 =head2 mktemp_dir
4960  
4961 mktemp_dir() (Venus::Path)
4962  
4963 The mktemp_dir method creates and returns a temporary directory as a
4964 L<Venus::Path> object.
4965  
4966 I<Since C<4.15>>
4967  
4968 =over 4
4969  
4970 =item mktemp_dir example 1
4971  
4972 # given: synopsis
4973  
4974 package main;
4975  
4976 my $mktemp_dir = $test->mktemp_dir;
4977  
4978 # bless(..., "Venus::Path")
4979  
4980 =back
4981  
4982 =cut
4983  
4984 =head2 mktemp_file
4985  
4986 mktemp_file() (Venus::Path)
4987  
4988 The mktemp_file method creates and returns a temporary file as a L<Venus::Path>
4989 object.
4990  
4991 I<Since C<4.15>>
4992  
4993 =over 4
4994  
4995 =item mktemp_file example 1
4996  
4997 # given: synopsis
4998  
4999 package main;
5000  
5001 my $mktemp_file = $test->mktemp_file;
5002  
5003 # bless(..., "Venus::Path")
5004  
5005 =back
5006  
5007 =cut
5008  
5009 =head2 new
5010  
5011 new(any @args) (Venus::Test)
5012  
5013 The new method constructs an instance of the package.
5014  
5015 I<Since C<4.15>>
5016  
5017 =over 4
5018  
5019 =item new example 1
5020  
5021 package main;
5022  
5023 use Venus::Test;
5024  
5025 my $new = Venus::Test->new;
5026  
5027 # bless(..., "Venus::Test")
5028  
5029 =back
5030  
5031 =over 4
5032  
5033 =item new example 2
5034  
5035 package main;
5036  
5037 use Venus::Test;
5038  
5039 my $new = Venus::Test->new('t/Venus_Test.t');
5040  
5041 # bless(..., "Venus::Test")
5042  
5043 =back
5044  
5045 =over 4
5046  
5047 =item new example 3
5048  
5049 package main;
5050  
5051 use Venus::Test;
5052  
5053 my $new = Venus::Test->new(file => 't/Venus_Test.t');
5054  
5055 # bless(..., "Venus::Test")
5056  
5057 =back
5058  
5059 =over 4
5060  
5061 =item B<may raise> L<Venus::Test::Error> C<on.new>
5062  
5063 package main;
5064  
5065 use Venus::Test;
5066  
5067 my $test = Venus::Test->new('t/data/no-name.t');
5068  
5069 # Error! (on.new)
5070  
5071 =back
5072  
5073 =cut
5074  
5075 =head2 note
5076  
5077 note(string @messages) (any)
5078  
5079 The note method prints debugging messages using L<Test::More/diag> and
5080 L<Test::More/explain>.
5081  
5082 I<Since C<4.15>>
5083  
5084 =over 4
5085  
5086 =item note example 1
5087  
5088 # given: synopsis
5089  
5090 package main;
5091  
5092 my $note = $test->note('Example note...');
5093  
5094 # ()
5095  
5096 =back
5097  
5098 =cut
5099  
5100 =head2 only_if
5101  
5102 only_if(string | coderef $code) (Venus::Test)
5103  
5104 The only_if method creates a gate that only runs subtests if the callback
5105 returns a truthy value.
5106  
5107 I<Since C<4.15>>
5108  
5109 =over 4
5110  
5111 =item only_if example 1
5112  
5113 # given: synopsis
5114  
5115 package main;
5116  
5117 my $gate = $test->only_if('os_is_mac');
5118  
5119 # bless(..., "Venus::Test")
5120  
5121 =back
5122  
5123 =cut
5124  
5125 =head2 os
5126  
5127 os() (Venus::Os)
5128  
5129 The os method returns a L<Venus::Os> object.
5130  
5131 I<Since C<4.15>>
5132  
5133 =over 4
5134  
5135 =item os example 1
5136  
5137 # given: synopsis
5138  
5139 package main;
5140  
5141 my $os = $test->os;
5142  
5143 # bless(..., "Venus::Os")
5144  
5145 =back
5146  
5147 =cut
5148  
5149 =head2 os_is_bsd
5150  
5151 os_is_bsd() (boolean)
5152  
5153 The os_is_bsd method returns true if the operating system is BSD.
5154  
5155 I<Since C<4.15>>
5156  
5157 =over 4
5158  
5159 =item os_is_bsd example 1
5160  
5161 # given: synopsis
5162  
5163 package main;
5164  
5165 my $os_is_bsd = $test->os_is_bsd;
5166  
5167 # true
5168  
5169 =back
5170  
5171 =cut
5172  
5173 =head2 os_is_cyg
5174  
5175 os_is_cyg() (boolean)
5176  
5177 The os_is_cyg method returns true if the operating system is Cygwin.
5178  
5179 I<Since C<4.15>>
5180  
5181 =over 4
5182  
5183 =item os_is_cyg example 1
5184  
5185 # given: synopsis
5186  
5187 package main;
5188  
5189 my $os_is_cyg = $test->os_is_cyg;
5190  
5191 # true
5192  
5193 =back
5194  
5195 =cut
5196  
5197 =head2 os_is_dos
5198  
5199 os_is_dos() (boolean)
5200  
5201 The os_is_dos method returns true if the operating system is DOS.
5202  
5203 I<Since C<4.15>>
5204  
5205 =over 4
5206  
5207 =item os_is_dos example 1
5208  
5209 # given: synopsis
5210  
5211 package main;
5212  
5213 my $os_is_dos = $test->os_is_dos;
5214  
5215 # true
5216  
5217 =back
5218  
5219 =cut
5220  
5221 =head2 os_is_lin
5222  
5223 os_is_lin() (boolean)
5224  
5225 The os_is_lin method returns true if the operating system is Linux.
5226  
5227 I<Since C<4.15>>
5228  
5229 =over 4
5230  
5231 =item os_is_lin example 1
5232  
5233 # given: synopsis
5234  
5235 package main;
5236  
5237 my $os_is_lin = $test->os_is_lin;
5238  
5239 # true
5240  
5241 =back
5242  
5243 =cut
5244  
5245 =head2 os_is_mac
5246  
5247 os_is_mac() (boolean)
5248  
5249 The os_is_mac method returns true if the operating system is macOS.
5250  
5251 I<Since C<4.15>>
5252  
5253 =over 4
5254  
5255 =item os_is_mac example 1
5256  
5257 # given: synopsis
5258  
5259 package main;
5260  
5261 my $os_is_mac = $test->os_is_mac;
5262  
5263 # true
5264  
5265 =back
5266  
5267 =cut
5268  
5269 =head2 os_is_non
5270  
5271 os_is_non() (boolean)
5272  
5273 The os_is_non method returns true if the operating system is non-Unix.
5274  
5275 I<Since C<4.15>>
5276  
5277 =over 4
5278  
5279 =item os_is_non example 1
5280  
5281 # given: synopsis
5282  
5283 package main;
5284  
5285 my $os_is_non = $test->os_is_non;
5286  
5287 # true
5288  
5289 =back
5290  
5291 =cut
5292  
5293 =head2 os_is_sun
5294  
5295 os_is_sun() (boolean)
5296  
5297 The os_is_sun method returns true if the operating system is Solaris.
5298  
5299 I<Since C<4.15>>
5300  
5301 =over 4
5302  
5303 =item os_is_sun example 1
5304  
5305 # given: synopsis
5306  
5307 package main;
5308  
5309 my $os_is_sun = $test->os_is_sun;
5310  
5311 # true
5312  
5313 =back
5314  
5315 =cut
5316  
5317 =head2 os_is_vms
5318  
5319 os_is_vms() (boolean)
5320  
5321 The os_is_vms method returns true if the operating system is VMS.
5322  
5323 I<Since C<4.15>>
5324  
5325 =over 4
5326  
5327 =item os_is_vms example 1
5328  
5329 # given: synopsis
5330  
5331 package main;
5332  
5333 my $os_is_vms = $test->os_is_vms;
5334  
5335 # true
5336  
5337 =back
5338  
5339 =cut
5340  
5341 =head2 os_is_win
5342  
5343 os_is_win() (boolean)
5344  
5345 The os_is_win method returns true if the operating system is Windows.
5346  
5347 I<Since C<4.15>>
5348  
5349 =over 4
5350  
5351 =item os_is_win example 1
5352  
5353 # given: synopsis
5354  
5355 package main;
5356  
5357 my $os_is_win = $test->os_is_win;
5358  
5359 # true
5360  
5361 =back
5362  
5363 =cut
5364  
5365 =head2 os_isnt_bsd
5366  
5367 os_isnt_bsd() (boolean)
5368  
5369 The os_isnt_bsd method returns true if the operating system is not BSD.
5370  
5371 I<Since C<4.15>>
5372  
5373 =over 4
5374  
5375 =item os_isnt_bsd example 1
5376  
5377 # given: synopsis
5378  
5379 package main;
5380  
5381 my $os_isnt_bsd = $test->os_isnt_bsd;
5382  
5383 # true
5384  
5385 =back
5386  
5387 =cut
5388  
5389 =head2 os_isnt_cyg
5390  
5391 os_isnt_cyg() (boolean)
5392  
5393 The os_isnt_cyg method returns true if the operating system is not Cygwin.
5394  
5395 I<Since C<4.15>>
5396  
5397 =over 4
5398  
5399 =item os_isnt_cyg example 1
5400  
5401 # given: synopsis
5402  
5403 package main;
5404  
5405 my $os_isnt_cyg = $test->os_isnt_cyg;
5406  
5407 # true
5408  
5409 =back
5410  
5411 =cut
5412  
5413 =head2 os_isnt_dos
5414  
5415 os_isnt_dos() (boolean)
5416  
5417 The os_isnt_dos method returns true if the operating system is not DOS.
5418  
5419 I<Since C<4.15>>
5420  
5421 =over 4
5422  
5423 =item os_isnt_dos example 1
5424  
5425 # given: synopsis
5426  
5427 package main;
5428  
5429 my $os_isnt_dos = $test->os_isnt_dos;
5430  
5431 # true
5432  
5433 =back
5434  
5435 =cut
5436  
5437 =head2 os_isnt_lin
5438  
5439 os_isnt_lin() (boolean)
5440  
5441 The os_isnt_lin method returns true if the operating system is not Linux.
5442  
5443 I<Since C<4.15>>
5444  
5445 =over 4
5446  
5447 =item os_isnt_lin example 1
5448  
5449 # given: synopsis
5450  
5451 package main;
5452  
5453 my $os_isnt_lin = $test->os_isnt_lin;
5454  
5455 # true
5456  
5457 =back
5458  
5459 =cut
5460  
5461 =head2 os_isnt_mac
5462  
5463 os_isnt_mac() (boolean)
5464  
5465 The os_isnt_mac method returns true if the operating system is not macOS.
5466  
5467 I<Since C<4.15>>
5468  
5469 =over 4
5470  
5471 =item os_isnt_mac example 1
5472  
5473 # given: synopsis
5474  
5475 package main;
5476  
5477 my $os_isnt_mac = $test->os_isnt_mac;
5478  
5479 # true
5480  
5481 =back
5482  
5483 =cut
5484  
5485 =head2 os_isnt_non
5486  
5487 os_isnt_non() (boolean)
5488  
5489 The os_isnt_non method returns true if the operating system is not non-Unix.
5490  
5491 I<Since C<4.15>>
5492  
5493 =over 4
5494  
5495 =item os_isnt_non example 1
5496  
5497 # given: synopsis
5498  
5499 package main;
5500  
5501 my $os_isnt_non = $test->os_isnt_non;
5502  
5503 # true
5504  
5505 =back
5506  
5507 =cut
5508  
5509 =head2 os_isnt_sun
5510  
5511 os_isnt_sun() (boolean)
5512  
5513 The os_isnt_sun method returns true if the operating system is not Solaris.
5514  
5515 I<Since C<4.15>>
5516  
5517 =over 4
5518  
5519 =item os_isnt_sun example 1
5520  
5521 # given: synopsis
5522  
5523 package main;
5524  
5525 my $os_isnt_sun = $test->os_isnt_sun;
5526  
5527 # true
5528  
5529 =back
5530  
5531 =cut
5532  
5533 =head2 os_isnt_vms
5534  
5535 os_isnt_vms() (boolean)
5536  
5537 The os_isnt_vms method returns true if the operating system is not VMS.
5538  
5539 I<Since C<4.15>>
5540  
5541 =over 4
5542  
5543 =item os_isnt_vms example 1
5544  
5545 # given: synopsis
5546  
5547 package main;
5548  
5549 my $os_isnt_vms = $test->os_isnt_vms;
5550  
5551 # true
5552  
5553 =back
5554  
5555 =cut
5556  
5557 =head2 os_isnt_win
5558  
5559 os_isnt_win() (boolean)
5560  
5561 The os_isnt_win method returns true if the operating system is not Windows.
5562  
5563 I<Since C<4.15>>
5564  
5565 =over 4
5566  
5567 =item os_isnt_win example 1
5568  
5569 # given: synopsis
5570  
5571 package main;
5572  
5573 my $os_isnt_win = $test->os_isnt_win;
5574  
5575 # true
5576  
5577 =back
5578  
5579 =cut
5580  
5581 =head2 pass
5582  
5583 pass(any $data, string $description) (any)
5584  
5585 The pass method dispatches to the L<Test::More/ok> operation expecting the
5586 first argument to be truthy and returns the result.
5587  
5588 I<Since C<4.15>>
5589  
5590 =over 4
5591  
5592 =item pass example 1
5593  
5594 # given: synopsis
5595  
5596 package main;
5597  
5598 my $fail = $test->pass(1, 'example-1 pass passed');
5599  
5600 # true
5601  
5602 =back
5603  
5604 =cut
5605  
5606 =head2 patch
5607  
5608 patch(string $name, coderef $code) (coderef)
5609  
5610 The patch method monkey-patches the named subroutine and returns the original
5611 coderef.
5612  
5613 I<Since C<4.15>>
5614  
5615 =over 4
5616  
5617 =item patch example 1
5618  
5619 # given: synopsis
5620  
5621 package main;
5622  
5623 my $orig = $test->patch('pass', sub {
5624 return 'patched';
5625 });
5626  
5627 # sub {...}
5628  
5629 $test->unpatch;
5630  
5631 # bless(..., "Venus::Space")
5632  
5633 $orig
5634  
5635 # sub {...}
5636  
5637 =back
5638  
5639 =cut
5640  
5641 =head2 path
5642  
5643 path(string $path) (Venus::Path)
5644  
5645 The path method returns a L<Venus::Path> object for the given path. Defaults to
5646 the test file.
5647  
5648 I<Since C<4.15>>
5649  
5650 =over 4
5651  
5652 =item path example 1
5653  
5654 # given: synopsis
5655  
5656 package main;
5657  
5658 my $path = $test->path('t/Venus_Test.t');
5659  
5660 # bless(..., "Venus::Path")
5661  
5662 =back
5663  
5664 =cut
5665  
5666 =head2 pfile
5667  
5668 pfile() (Venus::Path)
5669  
5670 The pfile method returns the path to a pod file for the package being tested.
5671  
5672 I<Since C<4.15>>
5673  
5674 =over 4
5675  
5676 =item pfile example 1
5677  
5678 # given: synopsis
5679  
5680 package main;
5681  
5682 my $pfile = $test->pfile;
5683  
5684 # "lib/Venus/Test.pod"
5685  
5686 =back
5687  
5688 =cut
5689  
5690 =head2 render
5691  
5692 render(string $file) (Venus::Path)
5693  
5694 The render method reads the test specification and generates L<perlpod>
5695 documentation and returns a L<Venus::Path> object for the filename provided.
5696  
5697 I<Since C<4.15>>
5698  
5699 =over 4
5700  
5701 =item render example 1
5702  
5703 # given: synopsis
5704  
5705 package main;
5706  
5707 my $path = $test->render('t/path/pod/test');
5708  
5709 # bless(..., "Venus::Path")
5710  
5711 =back
5712  
5713 =cut
5714  
5715 =head2 same
5716  
5717 same(any $data1, any $data2, string $description) (any)
5718  
5719 The same method dispatches to the L<Test::More/is_deeply> operation and returns
5720 the result.
5721  
5722 I<Since C<4.15>>
5723  
5724 =over 4
5725  
5726 =item same example 1
5727  
5728 # given: synopsis
5729  
5730 package main;
5731  
5732 my $same = $test->same({1..4}, {1..4}, 'example-1 same passed');
5733  
5734 # true
5735  
5736 =back
5737  
5738 =cut
5739  
5740 =head2 skip
5741  
5742 skip(string $reason) (any)
5743  
5744 The skip method dispatches to the L<Test::More/skip> operation with the
5745 C<plan_all> option and returns the result.
5746  
5747 I<Since C<4.15>>
5748  
5749 =over 4
5750  
5751 =item skip example 1
5752  
5753 # given: synopsis
5754  
5755 package main;
5756  
5757 my $skip = $test->skip('Unsupported');
5758  
5759 # true
5760  
5761 =back
5762  
5763 =cut
5764  
5765 =head2 skip_if
5766  
5767 skip_if(string | coderef $code) (Venus::Test)
5768  
5769 The skip_if method creates a gate that only runs subtests if the callback
5770 returns a falsy value.
5771  
5772 I<Since C<4.15>>
5773  
5774 =over 4
5775  
5776 =item skip_if example 1
5777  
5778 # given: synopsis
5779  
5780 package main;
5781  
5782 my $gate = $test->skip_if('os_is_mac');
5783  
5784 # bless(..., "Venus::Test")
5785  
5786 =back
5787  
5788 =cut
5789  
5790 =head2 space
5791  
5792 space(string $package) (Venus::Space)
5793  
5794 The space method returns a L<Venus::Space> object for the package being tested,
5795 or for the package name provided.
5796  
5797 I<Since C<4.15>>
5798  
5799 =over 4
5800  
5801 =item space example 1
5802  
5803 # given: synopsis
5804  
5805 package main;
5806  
5807 my $space = $test->space;
5808  
5809 # bless(..., "Venus::Space")
5810  
5811 =back
5812  
5813 =over 4
5814  
5815 =item space example 2
5816  
5817 # given: synopsis
5818  
5819 package main;
5820  
5821 my $space = $test->space('Venus::Path');
5822  
5823 # bless(..., "Venus::Space")
5824  
5825 =back
5826  
5827 =cut
5828  
5829 =head2 subtest
5830  
5831 subtest(string $name, coderef $code) (any)
5832  
5833 The subtest method runs a subtest using L<Test::More/subtest>. Enclosed tests
5834 maybe be made conditional using a L</gate>, e.g., L</only_if> and L</skip_if>.
5835  
5836 I<Since C<4.15>>
5837  
5838 =over 4
5839  
5840 =item subtest example 1
5841  
5842 # given: synopsis
5843  
5844 package main;
5845  
5846 my $subtest = $test->subtest('test something', sub {
5847 $test->pass('it works');
5848 });
5849  
5850 # ()
5851  
5852 =back
5853  
5854 =cut
5855  
5856 =head2 text
5857  
5858 text() (Venus::Text::Pod)
5859  
5860 The text method returns a L<Venus::Text::Pod> object using L</file> for parsing
5861 the test specification.
5862  
5863 I<Since C<4.15>>
5864  
5865 =over 4
5866  
5867 =item text example 1
5868  
5869 # given: synopsis
5870  
5871 package main;
5872  
5873 my $text = $test->text;
5874  
5875 # bless(..., "Venus::Text::Pod")
5876  
5877 =back
5878  
5879 =cut
5880  
5881 =head2 tfile
5882  
5883 tfile() (Venus::Path)
5884  
5885 The tfile method returns the path to a test file for the package being tested.
5886  
5887 I<Since C<4.15>>
5888  
5889 =over 4
5890  
5891 =item tfile example 1
5892  
5893 # given: synopsis
5894  
5895 package main;
5896  
5897 my $tfile = $test->tfile;
5898  
5899 # "t/Venus_Test.t"
5900  
5901 =back
5902  
5903 =cut
5904  
5905 =head2 type
5906  
5907 type(any $data, string $expression, string @args) (boolean)
5908  
5909 The type method performs type assertion using L<Venus::Type> and tests if the
5910 data matches the type expression.
5911  
5912 I<Since C<4.15>>
5913  
5914 =over 4
5915  
5916 =item type example 1
5917  
5918 # given: synopsis
5919  
5920 package main;
5921  
5922 my $type = $test->type([1,2,3], 'arrayref', 'valid arrayref');
5923  
5924 # true
5925  
5926 =back
5927  
5928 =cut
5929  
5930 =head2 unlike
5931  
5932 unlike(string $data, regexp $regex, string $description) (any)
5933  
5934 The unlike method tests that a string doesn't match a regex using
5935 L<Test::More/unlike>.
5936  
5937 I<Since C<4.15>>
5938  
5939 =over 4
5940  
5941 =item unlike example 1
5942  
5943 # given: synopsis
5944  
5945 package main;
5946  
5947 my $unlike = $test->unlike('hello', qr/world/, 'does not match');
5948  
5949 # ()
5950  
5951 =back
5952  
5953 =cut
5954  
5955 =head2 unpatch
5956  
5957 unpatch(string @names) (Venus::Space)
5958  
5959 The unpatch method undoes patches by name, or undoes all patches if no names
5960 are provided.
5961  
5962 I<Since C<4.15>>
5963  
5964 =over 4
5965  
5966 =item unpatch example 1
5967  
5968 # given: synopsis
5969  
5970 package main;
5971  
5972 $test->patch('pass', sub {'patched'});
5973  
5974 # sub {...}
5975  
5976 my $unpatch = $test->unpatch('pass');
5977  
5978 # bless(..., "Venus::Space")
5979  
5980 =back
5981  
5982 =cut
5983  
5984 =head1 FEATURES
5985  
5986 This package provides the following features:
5987  
5988 =cut
5989  
5990 =over 4
5991  
5992 =item collect
5993  
5994 collect(string $name, any @args) (any)
5995  
5996 The collect method dispatches to the C<collect_data_for_${name}> method
5997 indictated by the first argument and returns the result. Returns an arrayref in
5998 scalar context, and a list in list context.
5999  
6000 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6001  
6002 B<example 1>
6003  
6004 # given: synopsis
6005  
6006 package main;
6007  
6008 my ($collect) = $test->collect('name');
6009  
6010 # "Venus::Test"
6011  
6012 B<example 2>
6013  
6014 # given: synopsis
6015  
6016 package main;
6017  
6018 my $collect = $test->collect('name');
6019  
6020 # ["Venus::Test"]
6021  
6022 =back
6023  
6024 =over 4
6025  
6026 =item collect_data_for_abstract
6027  
6028 collect_data_for_abstract() (arrayref)
6029  
6030 The collect_data_for_abstract method uses L</data> to fetch data for the C<abstract>
6031 section and returns the data. Returns an arrayref in scalar context, and a list
6032 in list context.
6033  
6034 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6035  
6036 B<example 1>
6037  
6038 # =abstract
6039 #
6040 # Example Test Documentation
6041 #
6042 # =cut
6043  
6044 package main;
6045  
6046 use Venus::Test 'test';
6047  
6048 my $test = test 't/path/pod/example';
6049  
6050 my $collect_data_for_abstract = $test->collect_data_for_abstract;
6051  
6052 # ["Example Test Documentation"]
6053  
6054 B<example 2>
6055  
6056 # =abstract
6057 #
6058 # Example Test Documentation
6059 #
6060 # =cut
6061  
6062 package main;
6063  
6064 use Venus::Test 'test';
6065  
6066 my $test = test 't/path/pod/example';
6067  
6068 my ($collect_data_for_abstract) = $test->collect_data_for_abstract;
6069  
6070 # "Example Test Documentation"
6071  
6072 =back
6073  
6074 =over 4
6075  
6076 =item collect_data_for_attribute
6077  
6078 collect_data_for_attribute(string $name) (arrayref)
6079  
6080 The collect_data_for_attribute method uses L</data> to fetch data for the
6081 C<attribute $name> section and returns the data. Returns an arrayref in scalar
6082 context, and a list in list context.
6083  
6084 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6085  
6086 B<example 1>
6087  
6088 # =attribute name
6089 #
6090 # The name attribute is read-write, optional, and holds a string.
6091 #
6092 # =cut
6093 #
6094 # =example-1 name
6095 #
6096 # # given: synopsis
6097 #
6098 # my $name = $example->name;
6099 #
6100 # # "..."
6101 #
6102 # =cut
6103  
6104 package main;
6105  
6106 use Venus::Test 'test';
6107  
6108 my $test = test 't/path/pod/example';
6109  
6110 my $collect_data_for_attribute = $test->collect_data_for_attribute('name');
6111  
6112 # ["The name attribute is read-write, optional, and holds a string."]
6113  
6114 B<example 2>
6115  
6116 # =attribute name
6117 #
6118 # The name attribute is read-write, optional, and holds a string.
6119 #
6120 # =cut
6121 #
6122 # =example-1 name
6123 #
6124 # # given: synopsis
6125 #
6126 # my $name = $example->name;
6127 #
6128 # # "..."
6129 #
6130 # =cut
6131  
6132 package main;
6133  
6134 use Venus::Test 'test';
6135  
6136 my $test = test 't/path/pod/example';
6137  
6138 my ($collect_data_for_attribute) = $test->collect_data_for_attribute('name');
6139  
6140 # "The name attribute is read-write, optional, and holds a string."
6141  
6142 =back
6143  
6144 =over 4
6145  
6146 =item collect_data_for_authors
6147  
6148 collect_data_for_authors() (arrayref)
6149  
6150 The collect_data_for_authors method uses L</data> to fetch data for the
6151 C<authors> section and returns the data. Returns an arrayref in scalar context,
6152 and a list in list context.
6153  
6154 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6155  
6156 B<example 1>
6157  
6158 # =authors
6159 #
6160 # Awncorp, C<awncorp@cpan.org>
6161 #
6162 # =cut
6163  
6164 package main;
6165  
6166 use Venus::Test 'test';
6167  
6168 my $test = test 't/path/pod/example';
6169  
6170 my $collect_data_for_authors = $test->collect_data_for_authors;
6171  
6172 # ["Awncorp, C<awncorp@cpan.org>"]
6173  
6174 B<example 2>
6175  
6176 # =authors
6177 #
6178 # Awncorp, C<awncorp@cpan.org>
6179 #
6180 # =cut
6181  
6182 package main;
6183  
6184 use Venus::Test 'test';
6185  
6186 my $test = test 't/path/pod/example';
6187  
6188 my ($collect_data_for_authors) = $test->collect_data_for_authors;
6189  
6190 # "Awncorp, C<awncorp@cpan.org>"
6191  
6192 =back
6193  
6194 =over 4
6195  
6196 =item collect_data_for_description
6197  
6198 collect_data_for_description() (arrayref)
6199  
6200 The collect_data_for_description method uses L</data> to fetch data for the C<description>
6201 section and returns the data. Returns an arrayref in scalar context, and a list
6202 in list context.
6203  
6204 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6205  
6206 B<example 1>
6207  
6208 # =description
6209 #
6210 # This package provides an example class.
6211 #
6212 # =cut
6213  
6214 package main;
6215  
6216 use Venus::Test 'test';
6217  
6218 my $test = test 't/path/pod/example';
6219  
6220 my $collect_data_for_description = $test->collect_data_for_description;
6221  
6222 # ["This package provides an example class."]
6223  
6224 B<example 2>
6225  
6226 # =description
6227 #
6228 # This package provides an example class.
6229 #
6230 # =cut
6231  
6232 package main;
6233  
6234 use Venus::Test 'test';
6235  
6236 my $test = test 't/path/pod/example';
6237  
6238 my ($collect_data_for_description) = $test->collect_data_for_description;
6239  
6240 # "This package provides an example class."
6241  
6242 =back
6243  
6244 =over 4
6245  
6246 =item collect_data_for_encoding
6247  
6248 collect_data_for_encoding() (arrayref)
6249  
6250 The collect_data_for_encoding method uses L</data> to fetch data for the C<encoding>
6251 section and returns the data. Returns an arrayref in scalar context, and a list
6252 in list context.
6253  
6254 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6255  
6256 B<example 1>
6257  
6258 # =encoding
6259 #
6260 # utf8
6261 #
6262 # =cut
6263  
6264 package main;
6265  
6266 use Venus::Test 'test';
6267  
6268 my $test = test 't/path/pod/example';
6269  
6270 my $collect_data_for_encoding = $test->collect_data_for_encoding;
6271  
6272 # ["UTF8"]
6273  
6274 B<example 2>
6275  
6276 # =encoding
6277 #
6278 # utf8
6279 #
6280 # =cut
6281  
6282 package main;
6283  
6284 use Venus::Test 'test';
6285  
6286 my $test = test 't/path/pod/example';
6287  
6288 my ($collect_data_for_encoding) = $test->collect_data_for_encoding;
6289  
6290 # "UTF8"
6291  
6292 =back
6293  
6294 =over 4
6295  
6296 =item collect_data_for_error
6297  
6298 collect_data_for_error(string $name) (arrayref)
6299  
6300 The collect_data_for_error method uses L</data> to fetch data for the C<error
6301 $name> section and returns the data. Returns an arrayref in scalar context, and
6302 a list in list context.
6303  
6304 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6305  
6306 B<example 1>
6307  
6308 # =error error_on_unknown
6309 #
6310 # This package may raise an error_on_unknown error.
6311 #
6312 # =cut
6313 #
6314 # =example-1 error_on_unknown
6315 #
6316 # # given: synopsis
6317 #
6318 # my $error = $example->catch('error', {
6319 # with => 'error_on_unknown',
6320 # });
6321 #
6322 # # "..."
6323 #
6324 # =cut
6325  
6326 package main;
6327  
6328 use Venus::Test 'test';
6329  
6330 my $test = test 't/path/pod/example';
6331  
6332 my $collect_data_for_error = $test->collect_data_for_error('error_on_unknown');
6333  
6334 # ["This package may raise an error_on_unknown error."]
6335  
6336 B<example 2>
6337  
6338 # =error error_on_unknown
6339 #
6340 # This package may raise an error_on_unknown error.
6341 #
6342 # =cut
6343 #
6344 # =example-1 error_on_unknown
6345 #
6346 # # given: synopsis
6347 #
6348 # my $error = $example->catch('error', {
6349 # with => 'error_on_unknown',
6350 # });
6351 #
6352 # # "..."
6353 #
6354 # =cut
6355  
6356 package main;
6357  
6358 use Venus::Test 'test';
6359  
6360 my $test = test 't/path/pod/example';
6361  
6362 my ($collect_data_for_error) = $test->collect_data_for_error('error_on_unknown');
6363  
6364 # "This package may raise an error_on_unknown error."
6365  
6366 =back
6367  
6368 =over 4
6369  
6370 =item collect_data_for_example
6371  
6372 collect_data_for_example(number $numberm string $name) (arrayref)
6373  
6374 The collect_data_for_example method uses L</data> to fetch data for the
6375 C<example-$number $name> section and returns the data. Returns an arrayref in
6376 scalar context, and a list in list context.
6377  
6378 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6379  
6380 B<example 1>
6381  
6382 # =attribute name
6383 #
6384 # The name attribute is read-write, optional, and holds a string.
6385 #
6386 # =cut
6387 #
6388 # =example-1 name
6389 #
6390 # # given: synopsis
6391 #
6392 # my $name = $example->name;
6393 #
6394 # # "..."
6395 #
6396 # =cut
6397  
6398 package main;
6399  
6400 use Venus::Test 'test';
6401  
6402 my $test = test 't/path/pod/example';
6403  
6404 my $collect_data_for_example = $test->collect_data_for_example(1, 'name');
6405  
6406 # [' # given: synopsis', ' my $name = $example->name;', ' # "..."']
6407  
6408 B<example 2>
6409  
6410 # =attribute name
6411 #
6412 # The name attribute is read-write, optional, and holds a string.
6413 #
6414 # =cut
6415 #
6416 # =example-1 name
6417 #
6418 # # given: synopsis
6419 #
6420 # my $name = $example->name;
6421 #
6422 # # "..."
6423 #
6424 # =cut
6425  
6426 package main;
6427  
6428 use Venus::Test 'test';
6429  
6430 my $test = test 't/path/pod/example';
6431  
6432 my @collect_data_for_example = $test->collect_data_for_example(1, 'name');
6433  
6434 # (' # given: synopsis', ' my $name = $example->name;', ' # "..."')
6435  
6436 =back
6437  
6438 =over 4
6439  
6440 =item collect_data_for_feature
6441  
6442 collect_data_for_feature(string $name) (arrayref)
6443  
6444 The collect_data_for_feature method uses L</data> to fetch data for the
6445 C<feature $name> section and returns the data. Returns an arrayref in scalar
6446 context, and a list in list context.
6447  
6448 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6449  
6450 B<example 1>
6451  
6452 # =feature noop
6453 #
6454 # This package is no particularly useful features.
6455 #
6456 # =cut
6457  
6458 package main;
6459  
6460 use Venus::Test 'test';
6461  
6462 my $test = test 't/path/pod/example';
6463  
6464 my $collect_data_for_feature = $test->collect_data_for_feature('noop');
6465  
6466 # ["This package is no particularly useful features."]
6467  
6468 B<example 2>
6469  
6470 # =feature noop
6471 #
6472 # This package is no particularly useful features.
6473 #
6474 # =cut
6475  
6476 package main;
6477  
6478 use Venus::Test 'test';
6479  
6480 my $test = test 't/path/pod/example';
6481  
6482 my ($collect_data_for_feature) = $test->collect_data_for_feature('noop');
6483  
6484 # "This package is no particularly useful features."
6485  
6486 =back
6487  
6488 =over 4
6489  
6490 =item collect_data_for_function
6491  
6492 collect_data_for_function(string $name) (arrayref)
6493  
6494 The collect_data_for_function method uses L</data> to fetch data for the
6495 C<function $name> section and returns the data. Returns an arrayref in scalar
6496 context, and a list in list context.
6497  
6498 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6499  
6500 B<example 1>
6501  
6502 # =function eg
6503 #
6504 # The eg function returns a new instance of Example.
6505 #
6506 # =cut
6507 #
6508 # =example-1 name
6509 #
6510 # # given: synopsis
6511 #
6512 # my $example = eg();
6513 #
6514 # # "..."
6515 #
6516 # =cut
6517  
6518 package main;
6519  
6520 use Venus::Test 'test';
6521  
6522 my $test = test 't/path/pod/example';
6523  
6524 my $collect_data_for_function = $test->collect_data_for_function('eg');
6525  
6526 # ["The eg function returns a new instance of Example."]
6527  
6528 B<example 2>
6529  
6530 # =function eg
6531 #
6532 # The eg function returns a new instance of Example.
6533 #
6534 # =cut
6535 #
6536 # =example-1 name
6537 #
6538 # # given: synopsis
6539 #
6540 # my $example = eg();
6541 #
6542 # # "..."
6543 #
6544 # =cut
6545  
6546 package main;
6547  
6548 use Venus::Test 'test';
6549  
6550 my $test = test 't/path/pod/example';
6551  
6552 my ($collect_data_for_function) = $test->collect_data_for_function('eg');
6553  
6554 # "The eg function returns a new instance of Example."
6555  
6556 =back
6557  
6558 =over 4
6559  
6560 =item collect_data_for_includes
6561  
6562 collect_data_for_includes() (arrayref)
6563  
6564 The collect_data_for_includes method uses L</data> to fetch data for the
6565 C<includes> section and returns the data. Returns an arrayref in scalar
6566 context, and a list in list context.
6567  
6568 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6569  
6570 B<example 1>
6571  
6572 # =includes
6573 #
6574 # function: eg
6575 #
6576 # method: prepare
6577 # method: execute
6578 #
6579 # =cut
6580  
6581 package main;
6582  
6583 use Venus::Test 'test';
6584  
6585 my $test = test 't/path/pod/example';
6586  
6587 my $collect_data_for_includes = $test->collect_data_for_includes;
6588  
6589 # ["function: eg", "method: prepare", "method: execute"]
6590  
6591 B<example 2>
6592  
6593 # =includes
6594 #
6595 # function: eg
6596 #
6597 # method: prepare
6598 # method: execute
6599 #
6600 # =cut
6601  
6602 package main;
6603  
6604 use Venus::Test 'test';
6605  
6606 my $test = test 't/path/pod/example';
6607  
6608 my @collect_data_for_includes = $test->collect_data_for_includes;
6609  
6610 # ("function: eg", "method: prepare", "method: execute")
6611  
6612 =back
6613  
6614 =over 4
6615  
6616 =item collect_data_for_inherits
6617  
6618 collect_data_for_inherits() (arrayref)
6619  
6620 The collect_data_for_inherits method uses L</data> to fetch data for the C<inherits>
6621 section and returns the data. Returns an arrayref in scalar context, and a list
6622 in list context.
6623  
6624 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6625  
6626 B<example 1>
6627  
6628 # =inherits
6629 #
6630 # Venus::Core::Class
6631 #
6632 # =cut
6633  
6634 package main;
6635  
6636 use Venus::Test 'test';
6637  
6638 my $test = test 't/path/pod/example';
6639  
6640 my $collect_data_for_inherits = $test->collect_data_for_inherits;
6641  
6642 # ["Venus::Core::Class"]
6643  
6644 B<example 2>
6645  
6646 # =inherits
6647 #
6648 # Venus::Core::Class
6649 #
6650 # =cut
6651  
6652 package main;
6653  
6654 use Venus::Test 'test';
6655  
6656 my $test = test 't/path/pod/example';
6657  
6658 my ($collect_data_for_inherits) = $test->collect_data_for_inherits;
6659  
6660 # "Venus::Core::Class"
6661  
6662 =back
6663  
6664 =over 4
6665  
6666 =item collect_data_for_integrates
6667  
6668 collect_data_for_integrates() (arrayref)
6669  
6670 The collect_data_for_integrates method uses L</data> to fetch data for the C<integrates>
6671 section and returns the data. Returns an arrayref in scalar context, and a list
6672 in list context.
6673  
6674 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6675  
6676 B<example 1>
6677  
6678 # =integrates
6679 #
6680 # Venus::Role::Catchable
6681 # Venus::Role::Throwable
6682 #
6683 # =cut
6684  
6685 package main;
6686  
6687 use Venus::Test 'test';
6688  
6689 my $test = test 't/path/pod/example';
6690  
6691 my $collect_data_for_integrates = $test->collect_data_for_integrates;
6692  
6693 # ["Venus::Role::Catchable\nVenus::Role::Throwable"]
6694  
6695 B<example 2>
6696  
6697 # =integrates
6698 #
6699 # Venus::Role::Catchable
6700 # Venus::Role::Throwable
6701 #
6702 # =cut
6703  
6704 package main;
6705  
6706 use Venus::Test 'test';
6707  
6708 my $test = test 't/path/pod/example';
6709  
6710 my ($collect_data_for_integrates) = $test->collect_data_for_integrates;
6711  
6712 # "Venus::Role::Catchable\nVenus::Role::Throwable"
6713  
6714 =back
6715  
6716 =over 4
6717  
6718 =item collect_data_for_layout
6719  
6720 collect_data_for_layout() (arrayref)
6721  
6722 The collect_data_for_layout method uses L</data> to fetch data for the C<layout>
6723 section and returns the data. Returns an arrayref in scalar context, and a list
6724 in list context.
6725  
6726 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6727  
6728 B<example 1>
6729  
6730 # =layout
6731 #
6732 # encoding
6733 # name
6734 # synopsis
6735 # description
6736 # attributes: attribute
6737 # authors
6738 # license
6739 #
6740 # =cut
6741  
6742 package main;
6743  
6744 use Venus::Test 'test';
6745  
6746 my $test = test 't/path/pod/example';
6747  
6748 my $collect_data_for_layout = $test->collect_data_for_layout;
6749  
6750 # ["encoding\nname\nsynopsis\ndescription\nattributes: attribute\nauthors\nlicense"]
6751  
6752 B<example 2>
6753  
6754 # =layout
6755 #
6756 # encoding
6757 # name
6758 # synopsis
6759 # description
6760 # attributes: attribute
6761 # authors
6762 # license
6763 #
6764 # =cut
6765  
6766 package main;
6767  
6768 use Venus::Test 'test';
6769  
6770 my $test = test 't/path/pod/example';
6771  
6772 my ($collect_data_for_layout) = $test->collect_data_for_layout;
6773  
6774 # "encoding\nname\nsynopsis\ndescription\nattributes: attribute\nauthors\nlicense"
6775  
6776 =back
6777  
6778 =over 4
6779  
6780 =item collect_data_for_libraries
6781  
6782 collect_data_for_libraries() (arrayref)
6783  
6784 The collect_data_for_libraries method uses L</data> to fetch data for the C<libraries>
6785 section and returns the data. Returns an arrayref in scalar context, and a list
6786 in list context.
6787  
6788 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6789  
6790 B<example 1>
6791  
6792 # =libraries
6793 #
6794 # Venus::Check
6795 #
6796 # =cut
6797  
6798 package main;
6799  
6800 use Venus::Test 'test';
6801  
6802 my $test = test 't/path/pod/example';
6803  
6804 my $collect_data_for_libraries = $test->collect_data_for_libraries;
6805  
6806 # ["Venus::Check"]
6807  
6808 B<example 2>
6809  
6810 # =libraries
6811 #
6812 # Venus::Check
6813 #
6814 # =cut
6815  
6816 package main;
6817  
6818 use Venus::Test 'test';
6819  
6820 my $test = test 't/path/pod/example';
6821  
6822 my ($collect_data_for_libraries) = $test->collect_data_for_libraries;
6823  
6824 # "Venus::Check"
6825  
6826 =back
6827  
6828 =over 4
6829  
6830 =item collect_data_for_license
6831  
6832 collect_data_for_license() (arrayref)
6833  
6834 The collect_data_for_license method uses L</data> to fetch data for the C<license>
6835 section and returns the data. Returns an arrayref in scalar context, and a list
6836 in list context.
6837  
6838 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6839  
6840 B<example 1>
6841  
6842 # =license
6843 #
6844 # No license granted.
6845 #
6846 # =cut
6847  
6848 package main;
6849  
6850 use Venus::Test 'test';
6851  
6852 my $test = test 't/path/pod/example';
6853  
6854 my $collect_data_for_license = $test->collect_data_for_license;
6855  
6856 # ["No license granted."]
6857  
6858 B<example 2>
6859  
6860 # =license
6861 #
6862 # No license granted.
6863 #
6864 # =cut
6865  
6866 package main;
6867  
6868 use Venus::Test 'test';
6869  
6870 my $test = test 't/path/pod/example';
6871  
6872 my ($collect_data_for_license) = $test->collect_data_for_license;
6873  
6874 # "No license granted."
6875  
6876 =back
6877  
6878 =over 4
6879  
6880 =item collect_data_for_message
6881  
6882 collect_data_for_message(string $name) (arrayref)
6883  
6884 The collect_data_for_message method uses L</data> to fetch data for the
6885 C<message $name> section and returns the data. Returns an arrayref in scalar
6886 context, and a list in list context.
6887  
6888 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6889  
6890 B<example 1>
6891  
6892 # =message accept
6893 #
6894 # The accept message represents acceptance.
6895 #
6896 # =cut
6897 #
6898 # =example-1 accept
6899 #
6900 # # given: synopsis
6901 #
6902 # my $accept = $example->accept;
6903 #
6904 # # "..."
6905 #
6906 # =cut
6907  
6908 package main;
6909  
6910 use Venus::Test 'test';
6911  
6912 my $test = test 't/path/pod/example';
6913  
6914 my $collect_data_for_message = $test->collect_data_for_message('accept');
6915  
6916 # ["The accept message represents acceptance."]
6917  
6918 B<example 2>
6919  
6920 # =message accept
6921 #
6922 # The accept message represents acceptance.
6923 #
6924 # =cut
6925 #
6926 # =example-1 accept
6927 #
6928 # # given: synopsis
6929 #
6930 # my $accept = $example->accept;
6931 #
6932 # # "..."
6933 #
6934 # =cut
6935  
6936 package main;
6937  
6938 use Venus::Test 'test';
6939  
6940 my $test = test 't/path/pod/example';
6941  
6942 my ($collect_data_for_message) = $test->collect_data_for_message('accept');
6943  
6944 # "The accept message represents acceptance."
6945  
6946 =back
6947  
6948 =over 4
6949  
6950 =item collect_data_for_metadata
6951  
6952 collect_data_for_metadata(string $name) (arrayref)
6953  
6954 The collect_data_for_metadata method uses L</data> to fetch data for the C<metadata $name>
6955 section and returns the data. Returns an arrayref in scalar context, and a list
6956 in list context.
6957  
6958 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
6959  
6960 B<example 1>
6961  
6962 # =method prepare
6963 #
6964 # The prepare method prepares for execution.
6965 #
6966 # =cut
6967 #
6968 # =metadata prepare
6969 #
6970 # {since => 1.2.3}
6971 #
6972 # =cut
6973 #
6974 # =example-1 prepare
6975 #
6976 # # given: synopsis
6977 #
6978 # my $prepare = $example->prepare;
6979 #
6980 # # "..."
6981 #
6982 # =cut
6983  
6984 package main;
6985  
6986 use Venus::Test 'test';
6987  
6988 my $test = test 't/path/pod/example';
6989  
6990 my $collect_data_for_metadata = $test->collect_data_for_metadata('prepare');
6991  
6992 # ["{since => 1.2.3}"]
6993  
6994 B<example 2>
6995  
6996 # =method prepare
6997 #
6998 # The prepare method prepares for execution.
6999 #
7000 # =cut
7001 #
7002 # =metadata prepare
7003 #
7004 # {since => 1.2.3}
7005 #
7006 # =cut
7007 #
7008 # =example-1 prepare
7009 #
7010 # # given: synopsis
7011 #
7012 # my $prepare = $example->prepare;
7013 #
7014 # # "..."
7015 #
7016 # =cut
7017  
7018 package main;
7019  
7020 use Venus::Test 'test';
7021  
7022 my $test = test 't/path/pod/example';
7023  
7024 my ($collect_data_for_metadata) = $test->collect_data_for_metadata('prepare');
7025  
7026 # "{since => 1.2.3}"
7027  
7028 =back
7029  
7030 =over 4
7031  
7032 =item collect_data_for_method
7033  
7034 collect_data_for_method(string $name) (arrayref)
7035  
7036 The collect_data_for_method method uses L</data> to fetch data for the C<method $name>
7037 section and returns the data. Returns an arrayref in scalar context, and a list
7038 in list context.
7039  
7040 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7041  
7042 B<example 1>
7043  
7044 # =method execute
7045 #
7046 # The execute method executes the logic.
7047 #
7048 # =cut
7049 #
7050 # =metadata execute
7051 #
7052 # {since => 1.2.3}
7053 #
7054 # =cut
7055 #
7056 # =example-1 execute
7057 #
7058 # # given: synopsis
7059 #
7060 # my $execute = $example->execute;
7061 #
7062 # # "..."
7063 #
7064 # =cut
7065  
7066 package main;
7067  
7068 use Venus::Test 'test';
7069  
7070 my $test = test 't/path/pod/example';
7071  
7072 my $collect_data_for_method = $test->collect_data_for_method('execute');
7073  
7074 # ["The execute method executes the logic."]
7075  
7076 B<example 2>
7077  
7078 # =method execute
7079 #
7080 # The execute method executes the logic.
7081 #
7082 # =cut
7083 #
7084 # =metadata execute
7085 #
7086 # {since => 1.2.3}
7087 #
7088 # =cut
7089 #
7090 # =example-1 execute
7091 #
7092 # # given: synopsis
7093 #
7094 # my $execute = $example->execute;
7095 #
7096 # # "..."
7097 #
7098 # =cut
7099  
7100 package main;
7101  
7102 use Venus::Test 'test';
7103  
7104 my $test = test 't/path/pod/example';
7105  
7106 my ($collect_data_for_method) = $test->collect_data_for_method('execute');
7107  
7108 # "The execute method executes the logic."
7109  
7110 =back
7111  
7112 =over 4
7113  
7114 =item collect_data_for_name
7115  
7116 collect_data_for_name() (arrayref)
7117  
7118 The collect_data_for_name method uses L</data> to fetch data for the C<name>
7119 section and returns the data. Returns an arrayref in scalar context, and a list
7120 in list context.
7121  
7122 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7123  
7124 B<example 1>
7125  
7126 # =name
7127  
7128 # Example
7129  
7130 # =cut
7131  
7132 package main;
7133  
7134 use Venus::Test 'test';
7135  
7136 my $test = test 't/path/pod/example';
7137  
7138 my $collect_data_for_name = $test->collect_data_for_name;
7139  
7140 # ["Example"]
7141  
7142 B<example 2>
7143  
7144 # =name
7145  
7146 # Example
7147  
7148 # =cut
7149  
7150 package main;
7151  
7152 use Venus::Test 'test';
7153  
7154 my $test = test 't/path/pod/example';
7155  
7156 my ($collect_data_for_name) = $test->collect_data_for_name;
7157  
7158 # "Example"
7159  
7160 =back
7161  
7162 =over 4
7163  
7164 =item collect_data_for_operator
7165  
7166 collect_data_for_operator(string $name) (arrayref)
7167  
7168 The collect_data_for_operator method uses L</data> to fetch data for the C<operator $name>
7169 section and returns the data. Returns an arrayref in scalar context, and a list
7170 in list context.
7171  
7172 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7173  
7174 B<example 1>
7175  
7176 # =operator ("")
7177 #
7178 # This package overloads the C<""> operator.
7179 #
7180 # =cut
7181 #
7182 # =example-1 ("")
7183 #
7184 # # given: synopsis
7185 #
7186 # my $string = "$example";
7187 #
7188 # # "..."
7189 #
7190 # =cut
7191  
7192 package main;
7193  
7194 use Venus::Test 'test';
7195  
7196 my $test = test 't/path/pod/example';
7197  
7198 my $collect_data_for_operator = $test->collect_data_for_operator('("")');
7199  
7200 # ['This package overloads the C<""> operator.']
7201  
7202 B<example 2>
7203  
7204 # =operator ("")
7205 #
7206 # This package overloads the C<""> operator.
7207 #
7208 # =cut
7209 #
7210 # =example-1 ("")
7211 #
7212 # # given: synopsis
7213 #
7214 # my $string = "$example";
7215 #
7216 # # "..."
7217 #
7218 # =cut
7219  
7220 package main;
7221  
7222 use Venus::Test 'test';
7223  
7224 my $test = test 't/path/pod/example';
7225  
7226 my ($collect_data_for_operator) = $test->collect_data_for_operator('("")');
7227  
7228 # 'This package overloads the C<""> operator.'
7229  
7230 =back
7231  
7232 =over 4
7233  
7234 =item collect_data_for_partials
7235  
7236 collect_data_for_partials() (arrayref)
7237  
7238 The collect_data_for_partials method uses L</data> to fetch data for the C<partials>
7239 section and returns the data. Returns an arrayref in scalar context, and a list
7240 in list context.
7241  
7242 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7243  
7244 B<example 1>
7245  
7246 # =partials
7247 #
7248 # t/path/to/other.t: present: authors
7249 # t/path/to/other.t: present: license
7250 #
7251 # =cut
7252  
7253 package main;
7254  
7255 use Venus::Test 'test';
7256  
7257 my $test = test 't/path/pod/example';
7258  
7259 my $collect_data_for_partials = $test->collect_data_for_partials;
7260  
7261 # ["t/path/to/other.t: present: authors\nt/path/to/other.t: present: license"]
7262  
7263 B<example 2>
7264  
7265 # =partials
7266 #
7267 # t/path/to/other.t: present: authors
7268 # t/path/to/other.t: present: license
7269 #
7270 # =cut
7271  
7272 package main;
7273  
7274 use Venus::Test 'test';
7275  
7276 my $test = test 't/path/pod/example';
7277  
7278 my ($collect_data_for_partials) = $test->collect_data_for_partials;
7279  
7280 # "t/path/to/other.t: present: authors\nt/path/to/other.t: present: license"
7281  
7282 =back
7283  
7284 =over 4
7285  
7286 =item collect_data_for_project
7287  
7288 collect_data_for_project() (arrayref)
7289  
7290 The collect_data_for_project method uses L</data> to fetch data for the C<project>
7291 section and returns the data. Returns an arrayref in scalar context, and a list
7292 in list context.
7293  
7294 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7295  
7296 B<example 1>
7297  
7298 # =project
7299 #
7300 # https://github.com/awncorp/example
7301 #
7302 # =cut
7303  
7304 package main;
7305  
7306 use Venus::Test 'test';
7307  
7308 my $test = test 't/path/pod/example';
7309  
7310 my $collect_data_for_project = $test->collect_data_for_project;
7311  
7312 # ["https://github.com/awncorp/example"]
7313  
7314 B<example 2>
7315  
7316 # =project
7317 #
7318 # https://github.com/awncorp/example
7319 #
7320 # =cut
7321  
7322 package main;
7323  
7324 use Venus::Test 'test';
7325  
7326 my $test = test 't/path/pod/example';
7327  
7328 my ($collect_data_for_project) = $test->collect_data_for_project;
7329  
7330 # "https://github.com/awncorp/example"
7331  
7332 =back
7333  
7334 =over 4
7335  
7336 =item collect_data_for_signature
7337  
7338 collect_data_for_signature(string $name) (arrayref)
7339  
7340 The collect_data_for_signature method uses L</data> to fetch data for the C<signature $name>
7341 section and returns the data. Returns an arrayref in scalar context, and a list
7342 in list context.
7343  
7344 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7345  
7346 B<example 1>
7347  
7348 # =method execute
7349 #
7350 # The execute method executes the logic.
7351 #
7352 # =cut
7353 #
7354 # =signature execute
7355 #
7356 # execute() (boolean)
7357 #
7358 # =cut
7359 #
7360 # =metadata execute
7361 #
7362 # {since => 1.2.3}
7363 #
7364 # =cut
7365 #
7366 # =example-1 execute
7367 #
7368 # # given: synopsis
7369 #
7370 # my $execute = $example->execute;
7371 #
7372 # # "..."
7373 #
7374 # =cut
7375  
7376 package main;
7377  
7378 use Venus::Test 'test';
7379  
7380 my $test = test 't/path/pod/example';
7381  
7382 my $collect_data_for_signature = $test->collect_data_for_signature('execute');
7383  
7384 # [" execute() (boolean)"]
7385  
7386 B<example 2>
7387  
7388 # =method execute
7389 #
7390 # The execute method executes the logic.
7391 #
7392 # =cut
7393 #
7394 # =signature execute
7395 #
7396 # execute() (boolean)
7397 #
7398 # =cut
7399 #
7400 # =metadata execute
7401 #
7402 # {since => 1.2.3}
7403 #
7404 # =cut
7405 #
7406 # =example-1 execute
7407 #
7408 # # given: synopsis
7409 #
7410 # my $execute = $example->execute;
7411 #
7412 # # "..."
7413 #
7414 # =cut
7415  
7416 package main;
7417  
7418 use Venus::Test 'test';
7419  
7420 my $test = test 't/path/pod/example';
7421  
7422 my ($collect_data_for_signature) = $test->collect_data_for_signature('execute');
7423  
7424 # " execute() (boolean)"
7425  
7426 =back
7427  
7428 =over 4
7429  
7430 =item collect_data_for_synopsis
7431  
7432 collect_data_for_synopsis() (arrayref)
7433  
7434 The collect_data_for_synopsis method uses L</data> to fetch data for the C<synopsis>
7435 section and returns the data. Returns an arrayref in scalar context, and a list
7436 in list context.
7437  
7438 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7439  
7440 B<example 1>
7441  
7442 # =synopsis
7443 #
7444 # use Example;
7445 #
7446 # my $example = Example->new;
7447 #
7448 # # bless(..., "Example")
7449 #
7450 # =cut
7451  
7452 package main;
7453  
7454 use Venus::Test 'test';
7455  
7456 my $test = test 't/path/pod/example';
7457  
7458 my $collect_data_for_synopsis = $test->collect_data_for_synopsis;
7459  
7460 # [' use Example;', ' my $example = Example->new;', ' # bless(..., "Example")']
7461  
7462 B<example 2>
7463  
7464 # =synopsis
7465 #
7466 # use Example;
7467 #
7468 # my $example = Example->new;
7469 #
7470 # # bless(..., "Example")
7471 #
7472 # =cut
7473  
7474 package main;
7475  
7476 use Venus::Test 'test';
7477  
7478 my $test = test 't/path/pod/example';
7479  
7480 my @collect_data_for_synopsis = $test->collect_data_for_synopsis;
7481  
7482 # (' use Example;', ' my $example = Example->new;', ' # bless(..., "Example")')
7483  
7484 =back
7485  
7486 =over 4
7487  
7488 =item collect_data_for_tagline
7489  
7490 collect_data_for_tagline() (arrayref)
7491  
7492 The collect_data_for_tagline method uses L</data> to fetch data for the C<tagline>
7493 section and returns the data. Returns an arrayref in scalar context, and a list
7494 in list context.
7495  
7496 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7497  
7498 B<example 1>
7499  
7500 # =tagline
7501 #
7502 # Example Class
7503 #
7504 # =cut
7505  
7506 package main;
7507  
7508 use Venus::Test 'test';
7509  
7510 my $test = test 't/path/pod/example';
7511  
7512 my $collect_data_for_tagline = $test->collect_data_for_tagline;
7513  
7514 # ["Example Class"]
7515  
7516 B<example 2>
7517  
7518 # =tagline
7519 #
7520 # Example Class
7521 #
7522 # =cut
7523  
7524 package main;
7525  
7526 use Venus::Test 'test';
7527  
7528 my $test = test 't/path/pod/example';
7529  
7530 my ($collect_data_for_tagline) = $test->collect_data_for_tagline;
7531  
7532 # "Example Class"
7533  
7534 =back
7535  
7536 =over 4
7537  
7538 =item collect_data_for_version
7539  
7540 collect_data_for_version() (arrayref)
7541  
7542 The collect_data_for_version method uses L</data> to fetch data for the C<version>
7543 section and returns the data. Returns an arrayref in scalar context, and a list
7544 in list context.
7545  
7546 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7547  
7548 B<example 1>
7549  
7550 # =version
7551 #
7552 # 1.2.3
7553 #
7554 # =cut
7555  
7556 package main;
7557  
7558 use Venus::Test 'test';
7559  
7560 my $test = test 't/path/pod/example';
7561  
7562 my $collect_data_for_version = $test->collect_data_for_version;
7563  
7564 # ["1.2.3"]
7565  
7566 B<example 2>
7567  
7568 # =version
7569 #
7570 # 1.2.3
7571 #
7572 # =cut
7573  
7574 package main;
7575  
7576 use Venus::Test 'test';
7577  
7578 my $test = test 't/path/pod/example';
7579  
7580 my ($collect_data_for_version) = $test->collect_data_for_version;
7581  
7582 # "1.2.3"
7583  
7584 =back
7585  
7586 =over 4
7587  
7588 =item data
7589  
7590 data() (Venus::Text::Pod)
7591  
7592 The data method returns a L<Venus::Text::Pod> object using L</file> for parsing
7593 the test specification.
7594  
7595 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7596  
7597 B<example 1>
7598  
7599 # given: synopsis
7600  
7601 package main;
7602  
7603 my $data = $test->data;
7604  
7605 # bless(..., "Venus::Text::Pod")
7606  
7607 =back
7608  
7609 =over 4
7610  
7611 =item execute
7612  
7613 execute(string $name, any @args) (boolean)
7614  
7615 The execute method dispatches to the C<execute_data_for_${name}> method
7616 indictated by the first argument and returns the result. Returns an arrayref in
7617 scalar context, and a list in list context.
7618  
7619 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7620  
7621 B<example 1>
7622  
7623 # given: synopsis
7624  
7625 package main;
7626  
7627 my $execute = $test->execute('name');
7628  
7629 # true
7630  
7631 B<example 2>
7632  
7633 # given: synopsis
7634  
7635 package main;
7636  
7637 my $execute = $test->execute('name', sub {
7638 my ($data) = @_;
7639  
7640 my $result = $data->[0] eq 'Venus::Test' ? true : false;
7641  
7642 $self->pass($result, 'name set as Venus::Test');
7643  
7644 return $result;
7645 });
7646  
7647 # true
7648  
7649 =back
7650  
7651 =over 4
7652  
7653 =item execute_test_for_abstract
7654  
7655 execute_test_for_abstract() (arrayref)
7656  
7657 The execute_test_for_abstract method tests a documentation block for the C<abstract> section and returns the result.
7658  
7659 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7660  
7661 B<example 1>
7662  
7663 # =abstract
7664 #
7665 # Example Test Documentation
7666 #
7667 # =cut
7668  
7669 package main;
7670  
7671 use Venus::Test 'test';
7672  
7673 my $test = test 't/path/pod/example';
7674  
7675 my $execute_test_for_abstract = $test->execute_test_for_abstract;
7676  
7677 # true
7678  
7679 =back
7680  
7681 =over 4
7682  
7683 =item execute_test_for_attribute
7684  
7685 execute_test_for_attribute(string $name) (arrayref)
7686  
7687 The execute_test_for_attribute method tests a documentation block for the C<attribute $name> section and returns the result.
7688  
7689 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7690  
7691 B<example 1>
7692  
7693 # =attribute name
7694 #
7695 # The name attribute is read-write, optional, and holds a string.
7696 #
7697 # =cut
7698 #
7699 # =example-1 name
7700 #
7701 # # given: synopsis
7702 #
7703 # my $name = $example->name;
7704 #
7705 # # "..."
7706 #
7707 # =cut
7708  
7709 package main;
7710  
7711 use Venus::Test 'test';
7712  
7713 my $test = test 't/path/pod/example';
7714  
7715 my $execute_test_for_attribute = $test->execute_test_for_attribute('name');
7716  
7717 # true
7718  
7719 =back
7720  
7721 =over 4
7722  
7723 =item execute_test_for_authors
7724  
7725 execute_test_for_authors() (arrayref)
7726  
7727 The execute_test_for_authors method tests a documentation block for the C<authors> section and returns the result.
7728  
7729 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7730  
7731 B<example 1>
7732  
7733 # =authors
7734 #
7735 # Awncorp, C<awncorp@cpan.org>
7736 #
7737 # =cut
7738  
7739 package main;
7740  
7741 use Venus::Test 'test';
7742  
7743 my $test = test 't/path/pod/example';
7744  
7745 my $execute_test_for_authors = $test->execute_test_for_authors;
7746  
7747 # true
7748  
7749 =back
7750  
7751 =over 4
7752  
7753 =item execute_test_for_description
7754  
7755 execute_test_for_description() (arrayref)
7756  
7757 The execute_test_for_description method tests a documentation block for the C<description> section and returns the result.
7758  
7759 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7760  
7761 B<example 1>
7762  
7763 # =description
7764 #
7765 # This package provides an example class.
7766 #
7767 # =cut
7768  
7769 package main;
7770  
7771 use Venus::Test 'test';
7772  
7773 my $test = test 't/path/pod/example';
7774  
7775 my $execute_test_for_description = $test->execute_test_for_description;
7776  
7777 # true
7778  
7779 =back
7780  
7781 =over 4
7782  
7783 =item execute_test_for_encoding
7784  
7785 execute_test_for_encoding() (arrayref)
7786  
7787 The execute_test_for_encoding method tests a documentation block for the C<encoding> section and returns the result.
7788  
7789 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7790  
7791 B<example 1>
7792  
7793 # =encoding
7794 #
7795 # utf8
7796 #
7797 # =cut
7798  
7799 package main;
7800  
7801 use Venus::Test 'test';
7802  
7803 my $test = test 't/path/pod/example';
7804  
7805 my $execute_test_for_encoding = $test->execute_test_for_encoding;
7806  
7807 # true
7808  
7809 =back
7810  
7811 =over 4
7812  
7813 =item execute_test_for_error
7814  
7815 execute_test_for_error(string $name) (arrayref)
7816  
7817 The execute_test_for_error method tests a documentation block for the C<error $name> section and returns the result.
7818  
7819 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7820  
7821 B<example 1>
7822  
7823 # =error error_on_unknown
7824 #
7825 # This package may raise an error_on_unknown error.
7826 #
7827 # =cut
7828 #
7829 # =example-1 error_on_unknown
7830 #
7831 # # given: synopsis
7832 #
7833 # my $error = $example->catch('error', {
7834 # with => 'error_on_unknown',
7835 # });
7836 #
7837 # # "..."
7838 #
7839 # =cut
7840  
7841 package main;
7842  
7843 use Venus::Test 'test';
7844  
7845 my $test = test 't/path/pod/example';
7846  
7847 my $execute_test_for_error = $test->execute_test_for_error('error_on_unknown');
7848  
7849 # true
7850  
7851 =back
7852  
7853 =over 4
7854  
7855 =item execute_test_for_example
7856  
7857 execute_test_for_example(number $numberm string $name) (arrayref)
7858  
7859 The execute_test_for_example method tests a documentation block for the C<example-$number $name> section and returns the result.
7860  
7861 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7862  
7863 B<example 1>
7864  
7865 # =attribute name
7866 #
7867 # The name attribute is read-write, optional, and holds a string.
7868 #
7869 # =cut
7870 #
7871 # =example-1 name
7872 #
7873 # # given: synopsis
7874 #
7875 # my $name = $example->name;
7876 #
7877 # # "..."
7878 #
7879 # =cut
7880  
7881 package main;
7882  
7883 use Venus::Test 'test';
7884  
7885 my $test = test 't/path/pod/example';
7886  
7887 my $execute_test_for_example = $test->execute_test_for_example(1, 'name');
7888  
7889 # true
7890  
7891 =back
7892  
7893 =over 4
7894  
7895 =item execute_test_for_feature
7896  
7897 execute_test_for_feature(string $name) (arrayref)
7898  
7899 The execute_test_for_feature method tests a documentation block for the C<feature $name> section and returns the result.
7900  
7901 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7902  
7903 B<example 1>
7904  
7905 # =feature noop
7906 #
7907 # This package is no particularly useful features.
7908 #
7909 # =cut
7910  
7911 package main;
7912  
7913 use Venus::Test 'test';
7914  
7915 my $test = test 't/path/pod/example';
7916  
7917 my $execute_test_for_feature = $test->execute_test_for_feature('noop');
7918  
7919 # true
7920  
7921 =back
7922  
7923 =over 4
7924  
7925 =item execute_test_for_function
7926  
7927 execute_test_for_function(string $name) (arrayref)
7928  
7929 The execute_test_for_function method tests a documentation block for the C<function $name> section and returns the result.
7930  
7931 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7932  
7933 B<example 1>
7934  
7935 # =function eg
7936 #
7937 # The eg function returns a new instance of Example.
7938 #
7939 # =cut
7940 #
7941 # =example-1 name
7942 #
7943 # # given: synopsis
7944 #
7945 # my $example = eg();
7946 #
7947 # # "..."
7948 #
7949 # =cut
7950  
7951 package main;
7952  
7953 use Venus::Test 'test';
7954  
7955 my $test = test 't/path/pod/example';
7956  
7957 my $execute_test_for_function = $test->execute_test_for_function('eg');
7958  
7959 # true
7960  
7961 =back
7962  
7963 =over 4
7964  
7965 =item execute_test_for_includes
7966  
7967 execute_test_for_includes() (arrayref)
7968  
7969 The execute_test_for_includes method tests a documentation block for the C<includes> section and returns the result.
7970  
7971 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
7972  
7973 B<example 1>
7974  
7975 # =includes
7976 #
7977 # function: eg
7978 #
7979 # method: prepare
7980 # method: execute
7981 #
7982 # =cut
7983  
7984 package main;
7985  
7986 use Venus::Test 'test';
7987  
7988 my $test = test 't/path/pod/example';
7989  
7990 my $execute_test_for_includes = $test->execute_test_for_includes;
7991  
7992 # true
7993  
7994 =back
7995  
7996 =over 4
7997  
7998 =item execute_test_for_inherits
7999  
8000 execute_test_for_inherits() (arrayref)
8001  
8002 The execute_test_for_inherits method tests a documentation block for the C<inherits> section and returns the result.
8003  
8004 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8005  
8006 B<example 1>
8007  
8008 # =inherits
8009 #
8010 # Venus::Core::Class
8011 #
8012 # =cut
8013  
8014 package main;
8015  
8016 use Venus::Test 'test';
8017  
8018 my $test = test 't/path/pod/example';
8019  
8020 my $execute_test_for_inherits = $test->execute_test_for_inherits;
8021  
8022 # true
8023  
8024 =back
8025  
8026 =over 4
8027  
8028 =item execute_test_for_integrates
8029  
8030 execute_test_for_integrates() (arrayref)
8031  
8032 The execute_test_for_integrates method tests a documentation block for the C<integrates> section and returns the result.
8033  
8034 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8035  
8036 B<example 1>
8037  
8038 # =integrates
8039 #
8040 # Venus::Role::Catchable
8041 # Venus::Role::Throwable
8042 #
8043 # =cut
8044  
8045 package main;
8046  
8047 use Venus::Test 'test';
8048  
8049 my $test = test 't/path/pod/example';
8050  
8051 my $execute_test_for_integrates = $test->execute_test_for_integrates;
8052  
8053 # true
8054  
8055 =back
8056  
8057 =over 4
8058  
8059 =item execute_test_for_layout
8060  
8061 execute_test_for_layout() (arrayref)
8062  
8063 The execute_test_for_layout method tests a documentation block for the C<layout> section and returns the result.
8064  
8065 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8066  
8067 B<example 1>
8068  
8069 # =layout
8070 #
8071 # encoding
8072 # name
8073 # synopsis
8074 # description
8075 # attributes: attribute
8076 # authors
8077 # license
8078 #
8079 # =cut
8080  
8081 package main;
8082  
8083 use Venus::Test 'test';
8084  
8085 my $test = test 't/path/pod/example';
8086  
8087 my $execute_test_for_layout = $test->execute_test_for_layout;
8088  
8089 # true
8090  
8091 =back
8092  
8093 =over 4
8094  
8095 =item execute_test_for_libraries
8096  
8097 execute_test_for_libraries() (arrayref)
8098  
8099 The execute_test_for_libraries method tests a documentation block for the C<libraries> section and returns the result.
8100  
8101 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8102  
8103 B<example 1>
8104  
8105 # =libraries
8106 #
8107 # Venus::Check
8108 #
8109 # =cut
8110  
8111 package main;
8112  
8113 use Venus::Test 'test';
8114  
8115 my $test = test 't/path/pod/example';
8116  
8117 my $execute_test_for_libraries = $test->execute_test_for_libraries;
8118  
8119 # true
8120  
8121 =back
8122  
8123 =over 4
8124  
8125 =item execute_test_for_license
8126  
8127 execute_test_for_license() (arrayref)
8128  
8129 The execute_test_for_license method tests a documentation block for the C<license> section and returns the result.
8130  
8131 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8132  
8133 B<example 1>
8134  
8135 # =license
8136 #
8137 # No license granted.
8138 #
8139 # =cut
8140  
8141 package main;
8142  
8143 use Venus::Test 'test';
8144  
8145 my $test = test 't/path/pod/example';
8146  
8147 my $execute_test_for_license = $test->execute_test_for_license;
8148  
8149 # true
8150  
8151 =back
8152  
8153 =over 4
8154  
8155 =item execute_test_for_message
8156  
8157 execute_test_for_message(string $name) (arrayref)
8158  
8159 The execute_test_for_message method tests a documentation block for the C<message $name> section and returns the result.
8160  
8161 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8162  
8163 B<example 1>
8164  
8165 # =message accept
8166 #
8167 # The accept message represents acceptance.
8168 #
8169 # =cut
8170 #
8171 # =example-1 accept
8172 #
8173 # # given: synopsis
8174 #
8175 # my $accept = $example->accept;
8176 #
8177 # # "..."
8178 #
8179 # =cut
8180  
8181 package main;
8182  
8183 use Venus::Test 'test';
8184  
8185 my $test = test 't/path/pod/example';
8186  
8187 my $execute_test_for_message = $test->execute_test_for_message('accept');
8188  
8189 # true
8190  
8191 =back
8192  
8193 =over 4
8194  
8195 =item execute_test_for_metadata
8196  
8197 execute_test_for_metadata(string $name) (arrayref)
8198  
8199 The execute_test_for_metadata method tests a documentation block for the C<metadata $name> section and returns the result.
8200  
8201 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8202  
8203 B<example 1>
8204  
8205 # =method prepare
8206 #
8207 # The prepare method prepares for execution.
8208 #
8209 # =cut
8210 #
8211 # =metadata prepare
8212 #
8213 # {since => 1.2.3}
8214 #
8215 # =cut
8216 #
8217 # =example-1 prepare
8218 #
8219 # # given: synopsis
8220 #
8221 # my $prepare = $example->prepare;
8222 #
8223 # # "..."
8224 #
8225 # =cut
8226  
8227 package main;
8228  
8229 use Venus::Test 'test';
8230  
8231 my $test = test 't/path/pod/example';
8232  
8233 my $execute_test_for_metadata = $test->execute_test_for_metadata('prepare');
8234  
8235 # true
8236  
8237 =back
8238  
8239 =over 4
8240  
8241 =item execute_test_for_method
8242  
8243 execute_test_for_method(string $name) (arrayref)
8244  
8245 The execute_test_for_method method tests a documentation block for the C<method $name> section and returns the result.
8246  
8247 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8248  
8249 B<example 1>
8250  
8251 # =method execute
8252 #
8253 # The execute method executes the logic.
8254 #
8255 # =cut
8256 #
8257 # =metadata execute
8258 #
8259 # {since => 1.2.3}
8260 #
8261 # =cut
8262 #
8263 # =example-1 execute
8264 #
8265 # # given: synopsis
8266 #
8267 # my $execute = $example->execute;
8268 #
8269 # # "..."
8270 #
8271 # =cut
8272  
8273 package main;
8274  
8275 use Venus::Test 'test';
8276  
8277 my $test = test 't/path/pod/example';
8278  
8279 my $execute_test_for_method = $test->execute_test_for_method('execute');
8280  
8281 # true
8282  
8283 =back
8284  
8285 =over 4
8286  
8287 =item execute_test_for_name
8288  
8289 execute_test_for_name() (arrayref)
8290  
8291 The execute_test_for_name method tests a documentation block for the C<name> section and returns the result.
8292  
8293 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8294  
8295 B<example 1>
8296  
8297 # =name
8298  
8299 # Example
8300  
8301 # =cut
8302  
8303 package main;
8304  
8305 use Venus::Test 'test';
8306  
8307 my $test = test 't/path/pod/example';
8308  
8309 my $execute_test_for_name = $test->execute_test_for_name;
8310  
8311 # true
8312  
8313 =back
8314  
8315 =over 4
8316  
8317 =item execute_test_for_operator
8318  
8319 execute_test_for_operator(string $name) (arrayref)
8320  
8321 The execute_test_for_operator method tests a documentation block for the C<operator $name> section and returns the result.
8322  
8323 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8324  
8325 B<example 1>
8326  
8327 # =operator ("")
8328 #
8329 # This package overloads the C<""> operator.
8330 #
8331 # =cut
8332 #
8333 # =example-1 ("")
8334 #
8335 # # given: synopsis
8336 #
8337 # my $string = "$example";
8338 #
8339 # # "..."
8340 #
8341 # =cut
8342  
8343 package main;
8344  
8345 use Venus::Test 'test';
8346  
8347 my $test = test 't/path/pod/example';
8348  
8349 my $execute_test_for_operator = $test->execute_test_for_operator('("")');
8350  
8351 # true
8352  
8353 =back
8354  
8355 =over 4
8356  
8357 =item execute_test_for_raise
8358  
8359 execute_test_for_raise(string $name, string $class, string $id) (arrayref)
8360  
8361 The execute_test_for_raise method tests a documentation block for the C<raise
8362 $name $error $id> section and returns the result.
8363  
8364 I<Introduced C<4.15>>
8365  
8366 B<example 1>
8367  
8368 # =raise execute Venus::Error on.unknown
8369 #
8370 # # given: synopsis
8371 #
8372 # $example->operation; # throw exception
8373 #
8374 # # Error (on.unknown)
8375 #
8376 # =cut
8377  
8378 package main;
8379  
8380 use Venus::Test 'test';
8381  
8382 my $test = test 't/path/pod/example';
8383  
8384 my $execute_test_for_raise = $test->execute_test_for_raise('execute', 'Venus::Error', 'on.unknown');
8385  
8386 # true
8387  
8388 =back
8389  
8390 =over 4
8391  
8392 =item more
8393  
8394 more(any @args) (any)
8395  
8396 The more method dispatches to the L<Test::More> method specified by the first
8397 argument and returns its result.
8398  
8399 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8400  
8401 B<example 1>
8402  
8403 # given: synopsis
8404  
8405 package main;
8406  
8407 my $more = $test->more('ok', true);
8408  
8409 # true
8410  
8411 =back
8412  
8413 =over 4
8414  
8415 =item okay
8416  
8417 okay(any $data, string $description) (any)
8418  
8419 The okay method dispatches to the L<Test::More/ok> operation and returns the
8420 result.
8421  
8422 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8423  
8424 B<example 1>
8425  
8426 # given: synopsis
8427  
8428 package main;
8429  
8430 my $okay = $test->okay(1, 'example-1 okay passed');
8431  
8432 # true
8433  
8434 B<example 2>
8435  
8436 # given: synopsis
8437  
8438 package main;
8439  
8440 my $okay = $test->okay(!0, 'example-1 okay passed');
8441  
8442 # true
8443  
8444 =back
8445  
8446 =over 4
8447  
8448 =item okay_can
8449  
8450 okay_can(string $name, string @args) (any)
8451  
8452 The okay_can method dispatches to the L<Test::More/can_ok> operation and
8453 returns the result.
8454  
8455 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8456  
8457 B<example 1>
8458  
8459 # given: synopsis
8460  
8461 package main;
8462  
8463 my $okay_can = $test->okay_can('Venus::Test', 'diag');
8464  
8465 # true
8466  
8467 =back
8468  
8469 =over 4
8470  
8471 =item okay_isa
8472  
8473 okay_isa(string $name, string $base) (any)
8474  
8475 The okay_isa method dispatches to the L<Test::More/isa_ok> operation and
8476 returns the result.
8477  
8478 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8479  
8480 B<example 1>
8481  
8482 # given: synopsis
8483  
8484 package main;
8485  
8486 my $okay_isa = $test->okay_isa('Venus::Test', 'Venus::Kind');
8487  
8488 # true
8489  
8490 =back
8491  
8492 =over 4
8493  
8494 =item perform
8495  
8496 perform(string $name, any @args) (boolean)
8497  
8498 The perform method dispatches to the C<perform_data_for_${name}> method
8499 indictated by the first argument and returns the result. Returns an arrayref in
8500 scalar context, and a list in list context.
8501  
8502 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8503  
8504 B<example 1>
8505  
8506 # given: synopsis
8507  
8508 package main;
8509  
8510 my $data = $test->collect('name');
8511  
8512 my $perform = $test->perform('name', $data);
8513  
8514 # true
8515  
8516 =back
8517  
8518 =over 4
8519  
8520 =item perform_test_for_abstract
8521  
8522 perform_test_for_abstract(arrayref $data) (boolean)
8523  
8524 The perform_data_for_abstract method performs an overridable test for the C<abstract> section and returns truthy or falsy.
8525  
8526 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8527  
8528 B<example 1>
8529  
8530 package Example::Test;
8531  
8532 use Venus::Class 'base';
8533  
8534 base 'Venus::Test';
8535  
8536 sub perform_test_for_abstract {
8537 my ($self, $data) = @_;
8538  
8539 my $result = length(join "\n", @{$data}) ? true : false;
8540  
8541 $self->pass($result, "=abstract content");
8542  
8543 return $result;
8544 }
8545  
8546 package main;
8547  
8548 my $test = Example::Test->new('t/path/pod/example');
8549  
8550 my $data = $test->collect_data_for_abstract;
8551  
8552 my $perform_test_for_abstract = $test->perform_test_for_abstract(
8553 $data,
8554 );
8555  
8556 # true
8557  
8558 =back
8559  
8560 =over 4
8561  
8562 =item perform_test_for_attribute
8563  
8564 perform_test_for_attribute(string $name, arrayref $data) (boolean)
8565  
8566 The perform_data_for_attribute method performs an overridable test for the C<attribute $name> section and returns truthy or falsy.
8567  
8568 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8569  
8570 B<example 1>
8571  
8572 package Example::Test;
8573  
8574 use Venus::Class 'base';
8575  
8576 base 'Venus::Test';
8577  
8578 sub perform_test_for_attribute {
8579 my ($self, $name, $data) = @_;
8580  
8581 my $result = length(join "\n", @{$data}) ? true : false;
8582  
8583 $self->pass($result, "=attribute $name content");
8584  
8585 return $result;
8586 }
8587  
8588 package main;
8589  
8590 my $test = Example::Test->new('t/path/pod/example');
8591  
8592 my $data = $test->collect_data_for_attribute('name');
8593  
8594 my $perform_test_for_attribute = $test->perform_test_for_attribute(
8595 'name', $data,
8596 );
8597  
8598 # true
8599  
8600 =back
8601  
8602 =over 4
8603  
8604 =item perform_test_for_authors
8605  
8606 perform_test_for_authors(arrayref $data) (boolean)
8607  
8608 The perform_data_for_authors method performs an overridable test for the C<authors> section and returns truthy or falsy.
8609  
8610 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8611  
8612 B<example 1>
8613  
8614 package Example::Test;
8615  
8616 use Venus::Class 'base';
8617  
8618 base 'Venus::Test';
8619  
8620 sub perform_test_for_authors {
8621 my ($self, $data) = @_;
8622  
8623 my $result = length(join "\n", @{$data}) ? true : false;
8624  
8625 $self->pass($result, "=authors content");
8626  
8627 return $result;
8628 }
8629  
8630 package main;
8631  
8632 my $test = Example::Test->new('t/path/pod/example');
8633  
8634 my $data = $test->collect_data_for_authors;
8635  
8636 my $perform_test_for_authors = $test->perform_test_for_authors(
8637 $data,
8638 );
8639  
8640 # true
8641  
8642 =back
8643  
8644 =over 4
8645  
8646 =item perform_test_for_description
8647  
8648 perform_test_for_description(arrayref $data) (boolean)
8649  
8650 The perform_data_for_description method performs an overridable test for the C<description> section and returns truthy or falsy.
8651  
8652 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8653  
8654 B<example 1>
8655  
8656 package Example::Test;
8657  
8658 use Venus::Class 'base';
8659  
8660 base 'Venus::Test';
8661  
8662 sub perform_test_for_description {
8663 my ($self, $data) = @_;
8664  
8665 my $result = length(join "\n", @{$data}) ? true : false;
8666  
8667 $self->pass($result, "=description content");
8668  
8669 return $result;
8670 }
8671  
8672 package main;
8673  
8674 my $test = Example::Test->new('t/path/pod/example');
8675  
8676 my $data = $test->collect_data_for_description;
8677  
8678 my $perform_test_for_description = $test->perform_test_for_description(
8679 $data,
8680 );
8681  
8682 # true
8683  
8684 =back
8685  
8686 =over 4
8687  
8688 =item perform_test_for_encoding
8689  
8690 perform_test_for_encoding(arrayref $data) (boolean)
8691  
8692 The perform_data_for_encoding method performs an overridable test for the C<encoding> section and returns truthy or falsy.
8693  
8694 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8695  
8696 B<example 1>
8697  
8698 package Example::Test;
8699  
8700 use Venus::Class 'base';
8701  
8702 base 'Venus::Test';
8703  
8704 sub perform_test_for_encoding {
8705 my ($self, $data) = @_;
8706  
8707 my $result = length(join "\n", @{$data}) ? true : false;
8708  
8709 $self->pass($result, "=encoding content");
8710  
8711 return $result;
8712 }
8713  
8714 package main;
8715  
8716 my $test = Example::Test->new('t/path/pod/example');
8717  
8718 my $data = $test->collect_data_for_encoding;
8719  
8720 my $perform_test_for_encoding = $test->perform_test_for_encoding(
8721 $data,
8722 );
8723  
8724 # true
8725  
8726 =back
8727  
8728 =over 4
8729  
8730 =item perform_test_for_error
8731  
8732 perform_test_for_error(arrayref $data) (boolean)
8733  
8734 The perform_data_for_error method performs an overridable test for the C<error $name> section and returns truthy or falsy.
8735  
8736 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8737  
8738 B<example 1>
8739  
8740 package Example::Test;
8741  
8742 use Venus::Class 'base';
8743  
8744 base 'Venus::Test';
8745  
8746 sub perform_test_for_error {
8747 my ($self, $name, $data) = @_;
8748  
8749 my $result = length(join "\n", @{$data}) ? true : false;
8750  
8751 $self->pass($result, "=error $name content");
8752  
8753 return $result;
8754 }
8755  
8756 package main;
8757  
8758 my $test = Example::Test->new('t/path/pod/example');
8759  
8760 my $data = $test->collect_data_for_error('error_on_unknown');
8761  
8762 my $perform_test_for_error = $test->perform_test_for_error(
8763 'error_on_unknown', $data,
8764 );
8765  
8766 # true
8767  
8768 =back
8769  
8770 =over 4
8771  
8772 =item perform_test_for_example
8773  
8774 perform_test_for_example(arrayref $data) (boolean)
8775  
8776 The perform_data_for_example method performs an overridable test for the C<example-$number $name> section and returns truthy or falsy.
8777  
8778 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8779  
8780 B<example 1>
8781  
8782 package Example::Test;
8783  
8784 use Venus::Class 'base';
8785  
8786 base 'Venus::Test';
8787  
8788 sub perform_test_for_example {
8789 my ($self, $number, $name, $data) = @_;
8790  
8791 my $result = length(join "\n", @{$data}) ? true : false;
8792  
8793 $self->pass($result, "=example-$number $name content");
8794  
8795 return $result;
8796 }
8797  
8798 package main;
8799  
8800 my $test = Example::Test->new('t/path/pod/example');
8801  
8802 my $data = $test->collect_data_for_example(1, 'execute');
8803  
8804 my $perform_test_for_example = $test->perform_test_for_example(
8805 1, 'execute', $data,
8806 );
8807  
8808 # true
8809  
8810 =back
8811  
8812 =over 4
8813  
8814 =item perform_test_for_feature
8815  
8816 perform_test_for_feature(arrayref $data) (boolean)
8817  
8818 The perform_data_for_feature method performs an overridable test for the C<feature $name> section and returns truthy or falsy.
8819  
8820 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8821  
8822 B<example 1>
8823  
8824 package Example::Test;
8825  
8826 use Venus::Class 'base';
8827  
8828 base 'Venus::Test';
8829  
8830 sub perform_test_for_feature {
8831 my ($self, $name, $data) = @_;
8832  
8833 my $result = length(join "\n", @{$data}) ? true : false;
8834  
8835 $self->pass($result, "=feature $name content");
8836  
8837 return $result;
8838 }
8839  
8840 package main;
8841  
8842 my $test = Example::Test->new('t/path/pod/example');
8843  
8844 my $data = $test->collect_data_for_feature('noop');
8845  
8846 my $perform_test_for_feature = $test->perform_test_for_feature(
8847 'noop', $data,
8848 );
8849  
8850 # true
8851  
8852 =back
8853  
8854 =over 4
8855  
8856 =item perform_test_for_function
8857  
8858 perform_test_for_function(arrayref $data) (boolean)
8859  
8860 The perform_data_for_function method performs an overridable test for the C<function $name> section and returns truthy or falsy.
8861  
8862 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8863  
8864 B<example 1>
8865  
8866 package Example::Test;
8867  
8868 use Venus::Class 'base';
8869  
8870 base 'Venus::Test';
8871  
8872 sub perform_test_for_function {
8873 my ($self, $name, $data) = @_;
8874  
8875 my $result = length(join "\n", @{$data}) ? true : false;
8876  
8877 $self->pass($result, "=function $name content");
8878  
8879 return $result;
8880 }
8881  
8882 package main;
8883  
8884 my $test = Example::Test->new('t/path/pod/example');
8885  
8886 my $data = $test->collect_data_for_function('eg');
8887  
8888 my $perform_test_for_function = $test->perform_test_for_function(
8889 'eg', $data,
8890 );
8891  
8892 # true
8893  
8894 =back
8895  
8896 =over 4
8897  
8898 =item perform_test_for_includes
8899  
8900 perform_test_for_includes(arrayref $data) (boolean)
8901  
8902 The perform_data_for_includes method performs an overridable test for the C<includes> section and returns truthy or falsy.
8903  
8904 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8905  
8906 B<example 1>
8907  
8908 package Example::Test;
8909  
8910 use Venus::Class 'base';
8911  
8912 base 'Venus::Test';
8913  
8914 sub perform_test_for_includes {
8915 my ($self, $data) = @_;
8916  
8917 my $result = length(join "\n", @{$data}) ? true : false;
8918  
8919 $self->pass($result, "=includes content");
8920  
8921 return $result;
8922 }
8923  
8924 package main;
8925  
8926 my $test = Example::Test->new('t/path/pod/example');
8927  
8928 my $data = $test->collect_data_for_includes;
8929  
8930 my $perform_test_for_includes = $test->perform_test_for_includes(
8931 $data,
8932 );
8933  
8934 # true
8935  
8936 =back
8937  
8938 =over 4
8939  
8940 =item perform_test_for_inherits
8941  
8942 perform_test_for_inherits(arrayref $data) (boolean)
8943  
8944 The perform_data_for_inherits method performs an overridable test for the C<inherits> section and returns truthy or falsy.
8945  
8946 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8947  
8948 B<example 1>
8949  
8950 package Example::Test;
8951  
8952 use Venus::Class 'base';
8953  
8954 base 'Venus::Test';
8955  
8956 sub perform_test_for_inherits {
8957 my ($self, $data) = @_;
8958  
8959 my $result = length(join "\n", @{$data}) ? true : false;
8960  
8961 $self->pass($result, "=inherits content");
8962  
8963 return $result;
8964 }
8965  
8966 package main;
8967  
8968 my $test = Example::Test->new('t/path/pod/example');
8969  
8970 my $data = $test->collect_data_for_inherits;
8971  
8972 my $perform_test_for_inherits = $test->perform_test_for_inherits(
8973 $data,
8974 );
8975  
8976 # true
8977  
8978 =back
8979  
8980 =over 4
8981  
8982 =item perform_test_for_integrates
8983  
8984 perform_test_for_integrates(arrayref $data) (boolean)
8985  
8986 The perform_data_for_integrates method performs an overridable test for the C<integrates> section and returns truthy or falsy.
8987  
8988 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
8989  
8990 B<example 1>
8991  
8992 package Example::Test;
8993  
8994 use Venus::Class 'base';
8995  
8996 base 'Venus::Test';
8997  
8998 sub perform_test_for_integrates {
8999 my ($self, $data) = @_;
9000  
9001 my $result = length(join "\n", @{$data}) ? true : false;
9002  
9003 $self->pass($result, "=integrates content");
9004  
9005 return $result;
9006 }
9007  
9008 package main;
9009  
9010 my $test = Example::Test->new('t/path/pod/example');
9011  
9012 my $data = $test->collect_data_for_integrates;
9013  
9014 my $perform_test_for_integrates = $test->perform_test_for_integrates(
9015 $data,
9016 );
9017  
9018 # true
9019  
9020 =back
9021  
9022 =over 4
9023  
9024 =item perform_test_for_layout
9025  
9026 perform_test_for_layout(arrayref $data) (boolean)
9027  
9028 The perform_data_for_layout method performs an overridable test for the C<layout> section and returns truthy or falsy.
9029  
9030 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9031  
9032 B<example 1>
9033  
9034 package Example::Test;
9035  
9036 use Venus::Class 'base';
9037  
9038 base 'Venus::Test';
9039  
9040 sub perform_test_for_layout {
9041 my ($self, $data) = @_;
9042  
9043 my $result = length(join "\n", @{$data}) ? true : false;
9044  
9045 $self->pass($result, "=layout content");
9046  
9047 return $result;
9048 }
9049  
9050 package main;
9051  
9052 my $test = Example::Test->new('t/path/pod/example');
9053  
9054 my $data = $test->collect_data_for_layout;
9055  
9056 my $perform_test_for_layout = $test->perform_test_for_layout(
9057 $data,
9058 );
9059  
9060 # true
9061  
9062 =back
9063  
9064 =over 4
9065  
9066 =item perform_test_for_libraries
9067  
9068 perform_test_for_libraries(arrayref $data) (boolean)
9069  
9070 The perform_data_for_libraries method performs an overridable test for the C<libraries> section and returns truthy or falsy.
9071  
9072 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9073  
9074 B<example 1>
9075  
9076 package Example::Test;
9077  
9078 use Venus::Class 'base';
9079  
9080 base 'Venus::Test';
9081  
9082 sub perform_test_for_libraries {
9083 my ($self, $data) = @_;
9084  
9085 my $result = length(join "\n", @{$data}) ? true : false;
9086  
9087 $self->pass($result, "=libraries content");
9088  
9089 return $result;
9090 }
9091  
9092 package main;
9093  
9094 my $test = Example::Test->new('t/path/pod/example');
9095  
9096 my $data = $test->collect_data_for_libraries;
9097  
9098 my $perform_test_for_libraries = $test->perform_test_for_libraries(
9099 $data,
9100 );
9101  
9102 # true
9103  
9104 =back
9105  
9106 =over 4
9107  
9108 =item perform_test_for_license
9109  
9110 perform_test_for_license(arrayref $data) (boolean)
9111  
9112 The perform_data_for_license method performs an overridable test for the C<license> section and returns truthy or falsy.
9113  
9114 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9115  
9116 B<example 1>
9117  
9118 package Example::Test;
9119  
9120 use Venus::Class 'base';
9121  
9122 base 'Venus::Test';
9123  
9124 sub perform_test_for_license {
9125 my ($self, $data) = @_;
9126  
9127 my $result = length(join "\n", @{$data}) ? true : false;
9128  
9129 $self->pass($result, "=license content");
9130  
9131 return $result;
9132 }
9133  
9134 package main;
9135  
9136 my $test = Example::Test->new('t/path/pod/example');
9137  
9138 my $data = $test->collect_data_for_license;
9139  
9140 my $perform_test_for_license = $test->perform_test_for_license(
9141 $data,
9142 );
9143  
9144 # true
9145  
9146 =back
9147  
9148 =over 4
9149  
9150 =item perform_test_for_message
9151  
9152 perform_test_for_message(arrayref $data) (boolean)
9153  
9154 The perform_data_for_message method performs an overridable test for the C<message $name> section and returns truthy or falsy.
9155  
9156 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9157  
9158 B<example 1>
9159  
9160 package Example::Test;
9161  
9162 use Venus::Class 'base';
9163  
9164 base 'Venus::Test';
9165  
9166 sub perform_test_for_message {
9167 my ($self, $name, $data) = @_;
9168  
9169 my $result = length(join "\n", @{$data}) ? true : false;
9170  
9171 $self->pass($result, "=message $name content");
9172  
9173 return $result;
9174 }
9175  
9176 package main;
9177  
9178 my $test = Example::Test->new('t/path/pod/example');
9179  
9180 my $data = $test->collect_data_for_message('accept');
9181  
9182 my $perform_test_for_message = $test->perform_test_for_message(
9183 'accept', $data,
9184 );
9185  
9186 # true
9187  
9188 =back
9189  
9190 =over 4
9191  
9192 =item perform_test_for_metadata
9193  
9194 perform_test_for_metadata(arrayref $data) (boolean)
9195  
9196 The perform_data_for_metadata method performs an overridable test for the C<metadata $name> section and returns truthy or falsy.
9197  
9198 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9199  
9200 B<example 1>
9201  
9202 package Example::Test;
9203  
9204 use Venus::Class 'base';
9205  
9206 base 'Venus::Test';
9207  
9208 sub perform_test_for_metadata {
9209 my ($self, $name, $data) = @_;
9210  
9211 my $result = length(join "\n", @{$data}) ? true : false;
9212  
9213 $self->pass($result, "=metadata $name content");
9214  
9215 return $result;
9216 }
9217  
9218 package main;
9219  
9220 my $test = Example::Test->new('t/path/pod/example');
9221  
9222 my $data = $test->collect_data_for_metadata('execute');
9223  
9224 my $perform_test_for_metadata = $test->perform_test_for_metadata(
9225 'execute', $data,
9226 );
9227  
9228 # true
9229  
9230 =back
9231  
9232 =over 4
9233  
9234 =item perform_test_for_method
9235  
9236 perform_test_for_method(arrayref $data) (boolean)
9237  
9238 The perform_data_for_method method performs an overridable test for the C<method $name> section and returns truthy or falsy.
9239  
9240 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9241  
9242 B<example 1>
9243  
9244 package Example::Test;
9245  
9246 use Venus::Class 'base';
9247  
9248 base 'Venus::Test';
9249  
9250 sub perform_test_for_method {
9251 my ($self, $name, $data) = @_;
9252  
9253 my $result = length(join "\n", @{$data}) ? true : false;
9254  
9255 $self->pass($result, "=method $name content");
9256  
9257 return $result;
9258 }
9259  
9260 package main;
9261  
9262 my $test = Example::Test->new('t/path/pod/example');
9263  
9264 my $data = $test->collect_data_for_method('execute');
9265  
9266 my $perform_test_for_method = $test->perform_test_for_method(
9267 'execute', $data,
9268 );
9269  
9270 # true
9271  
9272 =back
9273  
9274 =over 4
9275  
9276 =item perform_test_for_name
9277  
9278 perform_test_for_name(arrayref $data) (boolean)
9279  
9280 The perform_data_for_name method performs an overridable test for the C<name> section and returns truthy or falsy.
9281  
9282 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9283  
9284 B<example 1>
9285  
9286 package Example::Test;
9287  
9288 use Venus::Class 'base';
9289  
9290 base 'Venus::Test';
9291  
9292 sub perform_test_for_name {
9293 my ($self, $data) = @_;
9294  
9295 my $result = length(join "\n", @{$data}) ? true : false;
9296  
9297 $self->pass($result, "=name content");
9298  
9299 return $result;
9300 }
9301  
9302 package main;
9303  
9304 my $test = Example::Test->new('t/path/pod/example');
9305  
9306 my $data = $test->collect_data_for_name;
9307  
9308 my $perform_test_for_name = $test->perform_test_for_name(
9309 $data,
9310 );
9311  
9312 # true
9313  
9314 =back
9315  
9316 =over 4
9317  
9318 =item perform_test_for_operator
9319  
9320 perform_test_for_operator(arrayref $data) (boolean)
9321  
9322 The perform_data_for_operator method performs an overridable test for the C<operator $name> section and returns truthy or falsy.
9323  
9324 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9325  
9326 B<example 1>
9327  
9328 package Example::Test;
9329  
9330 use Venus::Class 'base';
9331  
9332 base 'Venus::Test';
9333  
9334 sub perform_test_for_operator {
9335 my ($self, $name, $data) = @_;
9336  
9337 my $result = length(join "\n", @{$data}) ? true : false;
9338  
9339 $self->pass($result, "=operator $name content");
9340  
9341 return $result;
9342 }
9343  
9344 package main;
9345  
9346 my $test = Example::Test->new('t/path/pod/example');
9347  
9348 my $data = $test->collect_data_for_operator('("")');
9349  
9350 my $perform_test_for_operator = $test->perform_test_for_operator(
9351 '("")', $data,
9352 );
9353  
9354 # true
9355  
9356 =back
9357  
9358 =over 4
9359  
9360 =item perform_test_for_partials
9361  
9362 perform_test_for_partials(arrayref $data) (boolean)
9363  
9364 The perform_data_for_partials method performs an overridable test for the C<partials> section and returns truthy or falsy.
9365  
9366 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9367  
9368 B<example 1>
9369  
9370 package Example::Test;
9371  
9372 use Venus::Class 'base';
9373  
9374 base 'Venus::Test';
9375  
9376 sub perform_test_for_partials {
9377 my ($self, $data) = @_;
9378  
9379 my $result = length(join "\n", @{$data}) ? true : false;
9380  
9381 $self->pass($result, "=partials content");
9382  
9383 return $result;
9384 }
9385  
9386 package main;
9387  
9388 my $test = Example::Test->new('t/path/pod/example');
9389  
9390 my $data = $test->collect_data_for_partials;
9391  
9392 my $perform_test_for_partials = $test->perform_test_for_partials(
9393 $data,
9394 );
9395  
9396 # true
9397  
9398 =back
9399  
9400 =over 4
9401  
9402 =item perform_test_for_project
9403  
9404 perform_test_for_project(arrayref $data) (boolean)
9405  
9406 The perform_data_for_project method performs an overridable test for the C<project> section and returns truthy or falsy.
9407  
9408 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9409  
9410 B<example 1>
9411  
9412 package Example::Test;
9413  
9414 use Venus::Class 'base';
9415  
9416 base 'Venus::Test';
9417  
9418 sub perform_test_for_project {
9419 my ($self, $data) = @_;
9420  
9421 my $result = length(join "\n", @{$data}) ? true : false;
9422  
9423 $self->pass($result, "=project content");
9424  
9425 return $result;
9426 }
9427  
9428 package main;
9429  
9430 my $test = Example::Test->new('t/path/pod/example');
9431  
9432 my $data = $test->collect_data_for_project;
9433  
9434 my $perform_test_for_project = $test->perform_test_for_project(
9435 $data,
9436 );
9437  
9438 # true
9439  
9440 =back
9441  
9442 =over 4
9443  
9444 =item perform_test_for_signature
9445  
9446 perform_test_for_signature(arrayref $data) (boolean)
9447  
9448 The perform_data_for_signature method performs an overridable test for the C<signature $name> section and returns truthy or falsy.
9449  
9450 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9451  
9452 B<example 1>
9453  
9454 package Example::Test;
9455  
9456 use Venus::Class 'base';
9457  
9458 base 'Venus::Test';
9459  
9460 sub perform_test_for_signature {
9461 my ($self, $name, $data) = @_;
9462  
9463 my $result = length(join "\n", @{$data}) ? true : false;
9464  
9465 $self->pass($result, "=signature $name content");
9466  
9467 return $result;
9468 }
9469  
9470 package main;
9471  
9472 my $test = Example::Test->new('t/path/pod/example');
9473  
9474 my $data = $test->collect_data_for_signature('execute');
9475  
9476 my $perform_test_for_signature = $test->perform_test_for_signature(
9477 'execute', $data,
9478 );
9479  
9480 # true
9481  
9482 =back
9483  
9484 =over 4
9485  
9486 =item perform_test_for_synopsis
9487  
9488 perform_test_for_synopsis(arrayref $data) (boolean)
9489  
9490 The perform_data_for_synopsis method performs an overridable test for the C<synopsis> section and returns truthy or falsy.
9491  
9492 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9493  
9494 B<example 1>
9495  
9496 package Example::Test;
9497  
9498 use Venus::Class 'base';
9499  
9500 base 'Venus::Test';
9501  
9502 sub perform_test_for_synopsis {
9503 my ($self, $data) = @_;
9504  
9505 my $result = length(join "\n", @{$data}) ? true : false;
9506  
9507 $self->pass($result, "=synopsis content");
9508  
9509 return $result;
9510 }
9511  
9512 package main;
9513  
9514 my $test = Example::Test->new('t/path/pod/example');
9515  
9516 my $data = $test->collect_data_for_synopsis;
9517  
9518 my $perform_test_for_synopsis = $test->perform_test_for_synopsis(
9519 $data,
9520 );
9521  
9522 # true
9523  
9524 =back
9525  
9526 =over 4
9527  
9528 =item perform_test_for_tagline
9529  
9530 perform_test_for_tagline(arrayref $data) (boolean)
9531  
9532 The perform_data_for_tagline method performs an overridable test for the C<tagline> section and returns truthy or falsy.
9533  
9534 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9535  
9536 B<example 1>
9537  
9538 package Example::Test;
9539  
9540 use Venus::Class 'base';
9541  
9542 base 'Venus::Test';
9543  
9544 sub perform_test_for_tagline {
9545 my ($self, $data) = @_;
9546  
9547 my $result = length(join "\n", @{$data}) ? true : false;
9548  
9549 $self->pass($result, "=tagline content");
9550  
9551 return $result;
9552 }
9553  
9554 package main;
9555  
9556 my $test = Example::Test->new('t/path/pod/example');
9557  
9558 my $data = $test->collect_data_for_tagline;
9559  
9560 my $perform_test_for_tagline = $test->perform_test_for_tagline(
9561 $data,
9562 );
9563  
9564 # true
9565  
9566 =back
9567  
9568 =over 4
9569  
9570 =item perform_test_for_version
9571  
9572 perform_test_for_version(arrayref $data) (boolean)
9573  
9574 The perform_data_for_version method performs an overridable test for the C<version> section and returns truthy or falsy.
9575  
9576 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9577  
9578 B<example 1>
9579  
9580 package Example::Test;
9581  
9582 use Venus::Class 'base';
9583  
9584 base 'Venus::Test';
9585  
9586 sub perform_test_for_version {
9587 my ($self, $data) = @_;
9588  
9589 my $result = length(join "\n", @{$data}) ? true : false;
9590  
9591 $self->pass($result, "=version content");
9592  
9593 return $result;
9594 }
9595  
9596 package main;
9597  
9598 my $test = Example::Test->new('t/path/pod/example');
9599  
9600 my $data = $test->collect_data_for_version;
9601  
9602 my $perform_test_for_version = $test->perform_test_for_version(
9603 $data,
9604 );
9605  
9606 # true
9607  
9608 =back
9609  
9610 =over 4
9611  
9612 =item present
9613  
9614 present(string $name, any @args) (string)
9615  
9616 The present method dispatches to the C<present_data_for_${name}> method
9617 indictated by the first argument and returns the result. Returns an arrayref in
9618 scalar context, and a list in list context.
9619  
9620 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9621  
9622 B<example 1>
9623  
9624 # given: synopsis
9625  
9626 package main;
9627  
9628 my $present = $test->present('name');
9629  
9630 # =head1 NAME
9631 #
9632 # Venus::Test - Test Class
9633 #
9634 # =cut
9635  
9636 =back
9637  
9638 =over 4
9639  
9640 =item present_data_for_abstract
9641  
9642 present_data_for_abstract() (arrayref)
9643  
9644 The present_data_for_abstract method builds a documentation block for the C<abstract> section and returns it as a string.
9645  
9646 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9647  
9648 B<example 1>
9649  
9650 # =abstract
9651 #
9652 # Example Test Documentation
9653 #
9654 # =cut
9655  
9656 package main;
9657  
9658 use Venus::Test 'test';
9659  
9660 my $test = test 't/path/pod/example';
9661  
9662 my $present_data_for_abstract = $test->present_data_for_abstract;
9663  
9664 # =head1 ABSTRACT
9665 #
9666 # Example Test Documentation
9667 #
9668 # =cut
9669  
9670 =back
9671  
9672 =over 4
9673  
9674 =item present_data_for_attribute
9675  
9676 present_data_for_attribute(string $name) (arrayref)
9677  
9678 The present_data_for_attribute method builds a documentation block for the C<attribute $name> section and returns it as a string.
9679  
9680 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9681  
9682 B<example 1>
9683  
9684 # =attribute name
9685 #
9686 # The name attribute is read-write, optional, and holds a string.
9687 #
9688 # =cut
9689 #
9690 # =example-1 name
9691 #
9692 # # given: synopsis
9693 #
9694 # my $name = $example->name;
9695 #
9696 # # "..."
9697 #
9698 # =cut
9699  
9700 package main;
9701  
9702 use Venus::Test 'test';
9703  
9704 my $test = test 't/path/pod/example';
9705  
9706 my $present_data_for_attribute = $test->present_data_for_attribute('name');
9707  
9708 # =head2 name
9709 #
9710 # The name attribute is read-write, optional, and holds a string.
9711 #
9712 # =over 4
9713 #
9714 # =item name example 1
9715 #
9716 # # given: synopsis
9717 #
9718 # my $name = $example->name;
9719 #
9720 # # "..."
9721 #
9722 # =back
9723 #
9724 # =cut
9725  
9726 =back
9727  
9728 =over 4
9729  
9730 =item present_data_for_authors
9731  
9732 present_data_for_authors() (arrayref)
9733  
9734 The present_data_for_authors method builds a documentation block for the C<authors> section and returns it as a string.
9735  
9736 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9737  
9738 B<example 1>
9739  
9740 # =authors
9741 #
9742 # Awncorp, C<awncorp@cpan.org>
9743 #
9744 # =cut
9745  
9746 package main;
9747  
9748 use Venus::Test 'test';
9749  
9750 my $test = test 't/path/pod/example';
9751  
9752 my $present_data_for_authors = $test->present_data_for_authors;
9753  
9754 # =head1 AUTHORS
9755 #
9756 # Awncorp, C<awncorp@cpan.org>
9757 #
9758 # =cut
9759  
9760 =back
9761  
9762 =over 4
9763  
9764 =item present_data_for_description
9765  
9766 present_data_for_description() (arrayref)
9767  
9768 The present_data_for_description method builds a documentation block for the C<description> section and returns it as a string.
9769  
9770 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9771  
9772 B<example 1>
9773  
9774 # =description
9775 #
9776 # This package provides an example class.
9777 #
9778 # =cut
9779  
9780 package main;
9781  
9782 use Venus::Test 'test';
9783  
9784 my $test = test 't/path/pod/example';
9785  
9786 my $present_data_for_description = $test->present_data_for_description;
9787  
9788 # =head1 DESCRIPTION
9789 #
9790 # This package provides an example class.
9791 #
9792 # =cut
9793  
9794 =back
9795  
9796 =over 4
9797  
9798 =item present_data_for_encoding
9799  
9800 present_data_for_encoding() (arrayref)
9801  
9802 The present_data_for_encoding method builds a documentation block for the C<encoding> section and returns it as a string.
9803  
9804 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9805  
9806 B<example 1>
9807  
9808 # =encoding
9809 #
9810 # utf8
9811 #
9812 # =cut
9813  
9814 package main;
9815  
9816 use Venus::Test 'test';
9817  
9818 my $test = test 't/path/pod/example';
9819  
9820 my $present_data_for_encoding = $test->present_data_for_encoding;
9821  
9822 # =encoding UTF8
9823 #
9824 # =cut
9825  
9826 =back
9827  
9828 =over 4
9829  
9830 =item present_data_for_error
9831  
9832 present_data_for_error(string $name) (arrayref)
9833  
9834 The present_data_for_error method builds a documentation block for the C<error $name> section and returns it as a string.
9835  
9836 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9837  
9838 B<example 1>
9839  
9840 # =error error_on_unknown
9841 #
9842 # This package may raise an error_on_unknown error.
9843 #
9844 # =cut
9845 #
9846 # =example-1 error_on_unknown
9847 #
9848 # # given: synopsis
9849 #
9850 # my $error = $example->catch('error', {
9851 # with => 'error_on_unknown',
9852 # });
9853 #
9854 # # "..."
9855 #
9856 # =cut
9857  
9858 package main;
9859  
9860 use Venus::Test 'test';
9861  
9862 my $test = test 't/path/pod/example';
9863  
9864 my $present_data_for_error = $test->present_data_for_error('error_on_unknown');
9865  
9866 # =over 4
9867 #
9868 # =item error: C<error_on_unknown>
9869 #
9870 # This package may raise an error_on_unknown error.
9871 #
9872 # B<example 1>
9873 #
9874 # # given: synopsis
9875 #
9876 # my $error = $example->catch('error', {
9877 # with => 'error_on_unknown',
9878 # });
9879 #
9880 # # "..."
9881 #
9882 # =back
9883  
9884 =back
9885  
9886 =over 4
9887  
9888 =item present_data_for_example
9889  
9890 present_data_for_example(number $numberm string $name) (arrayref)
9891  
9892 The present_data_for_example method builds a documentation block for the C<example-$number $name> section and returns it as a string.
9893  
9894 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9895  
9896 B<example 1>
9897  
9898 # =attribute name
9899 #
9900 # The name attribute is read-write, optional, and holds a string.
9901 #
9902 # =cut
9903 #
9904 # =example-1 name
9905 #
9906 # # given: synopsis
9907 #
9908 # my $name = $example->name;
9909 #
9910 # # "..."
9911 #
9912 # =cut
9913  
9914 package main;
9915  
9916 use Venus::Test 'test';
9917  
9918 my $test = test 't/path/pod/example';
9919  
9920 my $present_data_for_example = $test->present_data_for_example(1, 'name');
9921  
9922 # =over 4
9923 #
9924 # =item name example 1
9925 #
9926 # # given: synopsis
9927 #
9928 # my $name = $example->name;
9929 #
9930 # # "..."
9931 #
9932 # =back
9933  
9934 =back
9935  
9936 =over 4
9937  
9938 =item present_data_for_feature
9939  
9940 present_data_for_feature(string $name) (arrayref)
9941  
9942 The present_data_for_feature method builds a documentation block for the C<feature $name> section and returns it as a string.
9943  
9944 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9945  
9946 B<example 1>
9947  
9948 # =feature noop
9949 #
9950 # This package is no particularly useful features.
9951 #
9952 # =cut
9953  
9954 package main;
9955  
9956 use Venus::Test 'test';
9957  
9958 my $test = test 't/path/pod/example';
9959  
9960 my $present_data_for_feature = $test->present_data_for_feature('noop');
9961  
9962 # =over 4
9963 #
9964 # =item noop
9965 #
9966 # This package is no particularly useful features.
9967 #
9968 # =back
9969  
9970 =back
9971  
9972 =over 4
9973  
9974 =item present_data_for_function
9975  
9976 present_data_for_function(string $name) (arrayref)
9977  
9978 The present_data_for_function method builds a documentation block for the C<function $name> section and returns it as a string.
9979  
9980 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
9981  
9982 B<example 1>
9983  
9984 # =function eg
9985 #
9986 # The eg function returns a new instance of Example.
9987 #
9988 # =cut
9989 #
9990 # =example-1 name
9991 #
9992 # # given: synopsis
9993 #
9994 # my $example = eg();
9995 #
9996 # # "..."
9997 #
9998 # =cut
9999  
10000 package main;
10001  
10002 use Venus::Test 'test';
10003  
10004 my $test = test 't/path/pod/example';
10005  
10006 my $present_data_for_function = $test->present_data_for_function('eg');
10007  
10008 # =head2 eg
10009 #
10010 # The eg function returns a new instance of Example.
10011 #
10012 # =cut
10013  
10014 =back
10015  
10016 =over 4
10017  
10018 =item present_data_for_includes
10019  
10020 present_data_for_includes() (arrayref)
10021  
10022 The present_data_for_includes method builds a documentation block for the C<includes> section and returns it as a string.
10023  
10024 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10025  
10026 B<example 1>
10027  
10028 # =includes
10029 #
10030 # function: eg
10031 #
10032 # method: prepare
10033 # method: execute
10034 #
10035 # =cut
10036  
10037 package main;
10038  
10039 use Venus::Test 'test';
10040  
10041 my $test = test 't/path/pod/example';
10042  
10043 my $present_data_for_includes = $test->present_data_for_includes;
10044  
10045 # undef
10046  
10047 =back
10048  
10049 =over 4
10050  
10051 =item present_data_for_inherits
10052  
10053 present_data_for_inherits() (arrayref)
10054  
10055 The present_data_for_inherits method builds a documentation block for the C<inherits> section and returns it as a string.
10056  
10057 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10058  
10059 B<example 1>
10060  
10061 # =inherits
10062 #
10063 # Venus::Core::Class
10064 #
10065 # =cut
10066  
10067 package main;
10068  
10069 use Venus::Test 'test';
10070  
10071 my $test = test 't/path/pod/example';
10072  
10073 my $present_data_for_inherits = $test->present_data_for_inherits;
10074  
10075 # =head1 INHERITS
10076 #
10077 # This package inherits behaviors from:
10078 #
10079 # L<Venus::Core::Class>
10080 #
10081 # =cut
10082  
10083 =back
10084  
10085 =over 4
10086  
10087 =item present_data_for_integrates
10088  
10089 present_data_for_integrates() (arrayref)
10090  
10091 The present_data_for_integrates method builds a documentation block for the C<integrates> section and returns it as a string.
10092  
10093 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10094  
10095 B<example 1>
10096  
10097 # =integrates
10098 #
10099 # Venus::Role::Catchable
10100 # Venus::Role::Throwable
10101 #
10102 # =cut
10103  
10104 package main;
10105  
10106 use Venus::Test 'test';
10107  
10108 my $test = test 't/path/pod/example';
10109  
10110 my $present_data_for_integrates = $test->present_data_for_integrates;
10111  
10112 # =head1 INTEGRATES
10113 #
10114 # This package integrates behaviors from:
10115 #
10116 # L<Venus::Role::Catchable>
10117 #
10118 # L<Venus::Role::Throwable>
10119 #
10120 # =cut
10121  
10122 =back
10123  
10124 =over 4
10125  
10126 =item present_data_for_layout
10127  
10128 present_data_for_layout() (arrayref)
10129  
10130 The present_data_for_layout method builds a documentation block for the C<layout> section and returns it as a string.
10131  
10132 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10133  
10134 B<example 1>
10135  
10136 # =layout
10137 #
10138 # encoding
10139 # name
10140 # synopsis
10141 # description
10142 # attributes: attribute
10143 # authors
10144 # license
10145 #
10146 # =cut
10147  
10148 package main;
10149  
10150 use Venus::Test 'test';
10151  
10152 my $test = test 't/path/pod/example';
10153  
10154 my $present_data_for_layout = $test->present_data_for_layout;
10155  
10156 # undef
10157  
10158 =back
10159  
10160 =over 4
10161  
10162 =item present_data_for_libraries
10163  
10164 present_data_for_libraries() (arrayref)
10165  
10166 The present_data_for_libraries method builds a documentation block for the C<libraries> section and returns it as a string.
10167  
10168 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10169  
10170 B<example 1>
10171  
10172 # =libraries
10173 #
10174 # Venus::Check
10175 #
10176 # =cut
10177  
10178 package main;
10179  
10180 use Venus::Test 'test';
10181  
10182 my $test = test 't/path/pod/example';
10183  
10184 my $present_data_for_libraries = $test->present_data_for_libraries;
10185  
10186 # =head1 LIBRARIES
10187 #
10188 # This package uses type constraints from:
10189 #
10190 # L<Venus::Check>
10191 #
10192 # =cut
10193  
10194 =back
10195  
10196 =over 4
10197  
10198 =item present_data_for_license
10199  
10200 present_data_for_license() (arrayref)
10201  
10202 The present_data_for_license method builds a documentation block for the C<license> section and returns it as a string.
10203  
10204 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10205  
10206 B<example 1>
10207  
10208 # =license
10209 #
10210 # No license granted.
10211 #
10212 # =cut
10213  
10214 package main;
10215  
10216 use Venus::Test 'test';
10217  
10218 my $test = test 't/path/pod/example';
10219  
10220 my $present_data_for_license = $test->present_data_for_license;
10221  
10222 # =head1 LICENSE
10223 #
10224 # No license granted.
10225 #
10226 # =cut
10227  
10228 =back
10229  
10230 =over 4
10231  
10232 =item present_data_for_message
10233  
10234 present_data_for_message(string $name) (arrayref)
10235  
10236 The present_data_for_message method builds a documentation block for the C<message $name> section and returns it as a string.
10237  
10238 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10239  
10240 B<example 1>
10241  
10242 # =message accept
10243 #
10244 # The accept message represents acceptance.
10245 #
10246 # =cut
10247 #
10248 # =example-1 accept
10249 #
10250 # # given: synopsis
10251 #
10252 # my $accept = $example->accept;
10253 #
10254 # # "..."
10255 #
10256 # =cut
10257  
10258 package main;
10259  
10260 use Venus::Test 'test';
10261  
10262 my $test = test 't/path/pod/example';
10263  
10264 my $present_data_for_message = $test->present_data_for_message('accept');
10265  
10266 # =over 4
10267 #
10268 # =item accept
10269 #
10270 # The accept message represents acceptance.
10271 #
10272 # B<example 1>
10273 #
10274 # # given: synopsis
10275 #
10276 # my $accept = $example->accept;
10277 #
10278 # # "..."
10279 #
10280 # =back
10281  
10282 =back
10283  
10284 =over 4
10285  
10286 =item present_data_for_metadata
10287  
10288 present_data_for_metadata(string $name) (arrayref)
10289  
10290 The present_data_for_metadata method builds a documentation block for the C<metadata $name> section and returns it as a string.
10291  
10292 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10293  
10294 B<example 1>
10295  
10296 # =method prepare
10297 #
10298 # The prepare method prepares for execution.
10299 #
10300 # =cut
10301 #
10302 # =metadata prepare
10303 #
10304 # {since => 1.2.3}
10305 #
10306 # =cut
10307 #
10308 # =example-1 prepare
10309 #
10310 # # given: synopsis
10311 #
10312 # my $prepare = $example->prepare;
10313 #
10314 # # "..."
10315 #
10316 # =cut
10317  
10318 package main;
10319  
10320 use Venus::Test 'test';
10321  
10322 my $test = test 't/path/pod/example';
10323  
10324 my $present_data_for_metadata = $test->present_data_for_metadata('prepare');
10325  
10326 # undef
10327  
10328 =back
10329  
10330 =over 4
10331  
10332 =item present_data_for_method
10333  
10334 present_data_for_method(string $name) (arrayref)
10335  
10336 The present_data_for_method method builds a documentation block for the C<method $name> section and returns it as a string.
10337  
10338 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10339  
10340 B<example 1>
10341  
10342 # =method execute
10343 #
10344 # The execute method executes the logic.
10345 #
10346 # =cut
10347 #
10348 # =metadata execute
10349 #
10350 # {since => 1.2.3}
10351 #
10352 # =cut
10353 #
10354 # =example-1 execute
10355 #
10356 # # given: synopsis
10357 #
10358 # my $execute = $example->execute;
10359 #
10360 # # "..."
10361 #
10362 # =cut
10363  
10364 package main;
10365  
10366 use Venus::Test 'test';
10367  
10368 my $test = test 't/path/pod/example';
10369  
10370 my $present_data_for_method = $test->present_data_for_method('execute');
10371  
10372 # =head2 execute
10373 #
10374 # execute() (boolean)
10375 #
10376 # The execute method executes the logic.
10377 #
10378 # I<Since C<1.2.3>>
10379 #
10380 # =over 4
10381 #
10382 # =item execute example 1
10383 #
10384 # # given: synopsis
10385 #
10386 # my $execute = $example->execute;
10387 #
10388 # # "..."
10389 #
10390 # =back
10391 #
10392 # =cut
10393  
10394 =back
10395  
10396 =over 4
10397  
10398 =item present_data_for_name
10399  
10400 present_data_for_name() (arrayref)
10401  
10402 The present_data_for_name method builds a documentation block for the C<name> section and returns it as a string.
10403  
10404 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10405  
10406 B<example 1>
10407  
10408 # =name
10409  
10410 # Example
10411  
10412 # =cut
10413  
10414 package main;
10415  
10416 use Venus::Test 'test';
10417  
10418 my $test = test 't/path/pod/example';
10419  
10420 my $present_data_for_name = $test->present_data_for_name;
10421  
10422 # =head1 NAME
10423 #
10424 # Example - Example Class
10425 #
10426 # =cut
10427  
10428 =back
10429  
10430 =over 4
10431  
10432 =item present_data_for_operator
10433  
10434 present_data_for_operator(string $name) (arrayref)
10435  
10436 The present_data_for_operator method builds a documentation block for the C<operator $name> section and returns it as a string.
10437  
10438 I<Introduced C<3.55>>, I<Deprecated C<4.15>>
10439  
10440 B<example 1>
10441  
10442 # =operator ("")
10443 #
10444 # This package overloads the C<""> operator.
10445 #
10446 # =cut
10447 #
10448 # =example-1 ("")
10449 #
10450 # # given: synopsis
10451 #
10452 # my $string = "$example";
10453 #
10454 # # "..."
10455 #
10456 # =cut
10457  
10458 package main;
10459  
10460 use Venus::Test 'test';
10461  
10462 my $test = test 't/path/pod/example';
10463  
10464 my $present_data_for_operator = $test->present_data_for_operator('("")');
10465  
10466 # =over 4
10467 #
10468 # =item operation: C<("")>
10469 #
10470 # This package overloads the C<""> operator.
10471 #
10472 # B<example 1>
10473 #
10474 # # given: synopsis
10475 #
10476 # my $string = "$example";
10477 #
10478 # # "..."
10479 #
10480 # =back
10481  
10482 =back
10483  
10484 =head1 AUTHORS
10485  
10486 Awncorp, C<awncorp@cpan.org>
10487  
10488 =cut
10489  
10490 =head1 LICENSE
10491  
10492 Copyright (C) 2022, Awncorp, C<awncorp@cpan.org>.
10493  
10494 This program is free software, you can redistribute it and/or modify it under
10495 the terms of the Apache license version 2.0.
10496  
10497 =cut
↑ Summary blib/lib/Venus/Task/Venus/Gen.pm »