1App::Yath::Converting(3U)ser Contributed Perl DocumentatiAopnp::Yath::Converting(3)
2
3
4

NAME

6       App::Yath::Converting - Things you may need to change in your tests
7       before you can use yath.
8

NON-TAP FORMATTER

10       By default yath tells any Test2 or Test::Builder tests to use
11       Test2::Formatter::Stream instead of Test2::Formatter::TAP. This is done
12       in order to make sure as much data as possible makes it to yath, TAP is
13       a lossy formater by comparison.
14
15       This is not normally a problem, but tests that do strange things with
16       STDERR/STDOUT, or try to intercept output from the regular TAP
17       formatter can have issues with this.
18
19   SOLUTIONS
20       HARNESS-NO-STREAM
21
22       You can add a harness directive to the top of offending tests that tell
23       the harness those specific tests should still use the TAP formatter.
24
25           #!/usr/bin/perl
26           # HARNESS-NO-STREAM
27           ...
28
29       This directive can come after the "#!" line, and after use statements,
30       but must come BEFORE any empty lines or runtime statements.
31
32       --no-stream
33
34       You can run yath with the "--no-stream" option, which will have tests
35       default to TAP. This is not recommended as TAP is lossy.
36

TESTS ARE RUN VIA FORK BY DEFAULT

38       The default mode for yath is to preload a few things, then fork to
39       spawn each test. This is a complicated procedure, and it uses
40       goto::file under the hood. Sometimes you have tests that simply will
41       not work this way, or tests that verify specific libraries are not
42       already loaded.
43
44   SOLUTIONS
45       HARNESS-NO-PRELOAD
46
47       You can use this harness directive inside your tests to tell yath not
48       to fork, but to instead launch a new perl process to run the test.
49
50           #!/usr/bin/perl
51           # HARNESS-NO-PRELOAD
52           ...
53
54       --no-fork
55
56       --no-preload
57
58       Both these options tell yath not to preload+fork, but to run ALL tests
59       in new processes. This is slow, it is better to mark specific tests
60       that have issues in preload mode.
61

SOURCE

63       The source code repository for Test2-Harness can be found at
64       http://github.com/Test-More/Test2-Harness/.
65

MAINTAINERS

67       Chad Granum <exodist@cpan.org>
68

AUTHORS

70       Chad Granum <exodist@cpan.org>
71

73       Copyright 2020 Chad Granum <exodist7@gmail.com>.
74
75       This program is free software; you can redistribute it and/or modify it
76       under the same terms as Perl itself.
77
78       See http://dev.perl.org/licenses/
79
80
81
82perl v5.36.1                      2023-10-04          App::Yath::Converting(3)
Impressum