1App::Yath::Options::RunUnseerr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Options::Runner(3)
2
3
4

NAME

6       App::Yath::Options::Runner - Runner options for Yath.
7

DESCRIPTION

9       This is where command line options for the runner are defined.
10

PROVIDED OPTIONS

12   COMMAND OPTIONS
13       Runner Options
14
15       --abort-on-bail
16       --no-abort-on-bail
17           Abort all testing if a bail-out is encountered (default: on)
18
19       --blib
20       -b
21       --no-blib
22           (Default: include if it exists) Include 'blib/lib' and 'blib/arch'
23           in your module path
24
25       --cover
26       --cover=-silent,1,+ignore,^t/,+ignore,^t2/,+ignore,^xt,+ignore,^test.pl
27       --no-cover
28           Use Devel::Cover to calculate test coverage. This disables forking.
29           If no args are specified the following are used:
30           -silent,1,+ignore,^t/,+ignore,^t2/,+ignore,^xt,+ignore,^test.pl
31
32       --dump-depmap
33       --no-dump-depmap
34           When using staged preload, dump the depmap for each stage as json
35           files
36
37       --event-timeout SECONDS
38       --et SECONDS
39       --no-event-timeout
40           Kill test if no output is received within timeout period. (Default:
41           60 seconds). Add the "# HARNESS-NO-TIMEOUT" comment to the top of a
42           test file to disable timeouts on a per-test basis. This prevents a
43           hung test from running forever.
44
45       --include ARG
46       --include=ARG
47       -I ARG
48       -I=ARG
49       --no-include
50           Add a directory to your include paths
51
52           Can be specified multiple times
53
54       --job-count ARG
55       --job-count=ARG
56       --jobs ARG
57       --jobs=ARG
58       -j ARG
59       -j=ARG
60       --no-job-count
61           Set the number of concurrent jobs to run
62
63           Can also be set with the following environment variables:
64           "YATH_JOB_COUNT", "T2_HARNESS_JOB_COUNT", "HARNESS_JOB_COUNT"
65
66       --lib
67       -l
68       --no-lib
69           (Default: include if it exists) Include 'lib' in your module path
70
71       --nytprof
72       --no-nytprof
73           Use Devel::NYTProf on tests. This will set addpid=1 for you. This
74           works with or without fork.
75
76       --post-exit-timeout SECONDS
77       --pet SECONDS
78       --no-post-exit-timeout
79           Stop waiting post-exit after the timeout period. (Default: 15
80           seconds) Some tests fork and allow the parent to exit before
81           writing all their output. If Test2::Harness detects an incomplete
82           plan after the test exits it will monitor for more events until the
83           timeout period. Add the "# HARNESS-NO-TIMEOUT" comment to the top
84           of a test file to disable timeouts on a per-test basis.
85
86       --preload-threshold ARG
87       --preload-threshold=ARG
88       --Pt ARG
89       --Pt=ARG
90       -W ARG
91       -W=ARG
92       --no-preload-threshold
93           Only do preload if at least N tests are going to be run. In some
94           cases a full preload takes longer than simply running the tests,
95           this lets you specify a minimum number of test jobs that will be
96           run for preload to happen. This has no effect for a persistent
97           runner. The default is 0, and it means always preload.
98
99       --preloads ARG
100       --preloads=ARG
101       --preload ARG
102       --preload=ARG
103       -P ARG
104       -P=ARG
105       --no-preloads
106           Preload a module before running tests
107
108           Can be specified multiple times
109
110       --resource Port
111       --resource +Test2::Harness::Runner::Resource::Port
112       -R Port
113       --no-resource
114           Use a resource module to assign resource assignments to individual
115           tests
116
117           Can be specified multiple times
118
119       --switch ARG
120       --switch=ARG
121       -S ARG
122       -S=ARG
123       --no-switch
124           Pass the specified switch to perl for each test. This is not
125           compatible with preload.
126
127           Can be specified multiple times
128
129       --tlib
130       --no-tlib
131           (Default: off) Include 't/lib' in your module path
132
133       --unsafe-inc
134       --no-unsafe-inc
135           perl is removing '.' from @INC as a security concern. This option
136           keeps things from breaking for now.
137
138           Can also be set with the following environment variables:
139           "PERL_USE_UNSAFE_INC"
140
141       --use-fork
142       --fork
143       --no-use-fork
144           (default: on, except on windows) Normally tests are run by forking,
145           which allows for features like preloading. This will turn off the
146           behavior globally (which is not compatible with preloading). This
147           is slower, it is better to tag misbehaving tests with the '#
148           HARNESS-NO-PRELOAD' comment in their header to disable forking only
149           for those tests.
150
151           Can also be set with the following environment variables:
152           "!T2_NO_FORK", "T2_HARNESS_FORK", "!T2_HARNESS_NO_FORK",
153           "YATH_FORK", "!YATH_NO_FORK"
154
155       --use-timeout
156       --timeout
157       --no-use-timeout
158           (default: on) Enable/disable timeouts
159

SOURCE

161       The source code repository for Test2-Harness can be found at
162       http://github.com/Test-More/Test2-Harness/.
163

MAINTAINERS

165       Chad Granum <exodist@cpan.org>
166

AUTHORS

168       Chad Granum <exodist@cpan.org>
169

171       Copyright 2020 Chad Granum <exodist7@gmail.com>.
172
173       This program is free software; you can redistribute it and/or modify it
174       under the same terms as Perl itself.
175
176       See http://dev.perl.org/licenses/
177
178
179
180perl v5.34.1                      2022-07-11     App::Yath::Options::Runner(3)
Impressum