1App::Yath::Options::RunUnseerr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Options::Runner(3)
2
3
4
6 App::Yath::Options::Runner - Runner options for Yath.
7
9 This is where command line options for the runner are defined.
10
12 COMMAND OPTIONS
13 Runner Options
14
15 --blib
16 -b
17 --no-blib
18 (Default: include if it exists) Include 'blib/lib' and 'blib/arch'
19 in your module path
20
21 --cover
22 --cover=-silent,1,+ignore,^t/,+ignore,^t2/,+ignore,^xt,+ignore,^test.pl
23 --no-cover
24 Use Devel::Cover to calculate test coverage. This disables forking.
25 If no args are specified the following are used:
26 -silent,1,+ignore,^t/,+ignore,^t2/,+ignore,^xt,+ignore,^test.pl
27
28 --cover-files
29 --no-cover-files
30 Use Test2::Plugin::Cover to collect coverage data for what files
31 are touched by what tests. Unlike Devel::Cover this has very little
32 performance impact (About 4% difference)
33
34 --event-timeout SECONDS
35 --et SECONDS
36 --no-event-timeout
37 Kill test if no output is received within timeout period. (Default:
38 60 seconds). Add the "# HARNESS-NO-TIMEOUT" comment to the top of a
39 test file to disable timeouts on a per-test basis. This prevents a
40 hung test from running forever.
41
42 --include ARG
43 --include=ARG
44 -I ARG
45 -I=ARG
46 --no-include
47 Add a directory to your include paths
48
49 Can be specified multiple times
50
51 --job-count ARG
52 --job-count=ARG
53 --jobs ARG
54 --jobs=ARG
55 -j ARG
56 -j=ARG
57 --no-job-count
58 Set the number of concurrent jobs to run (Default: 1)
59
60 Can also be set with the following environment variables:
61 "YATH_JOB_COUNT", "T2_HARNESS_JOB_COUNT", "HARNESS_JOB_COUNT"
62
63 --lib
64 -l
65 --no-lib
66 (Default: include if it exists) Include 'lib' in your module path
67
68 --post-exit-timeout SECONDS
69 --pet SECONDS
70 --no-post-exit-timeout
71 Stop waiting post-exit after the timeout period. (Default: 15
72 seconds) Some tests fork and allow the parent to exit before
73 writing all their output. If Test2::Harness detects an incomplete
74 plan after the test exits it will monitor for more events until the
75 timeout period. Add the "# HARNESS-NO-TIMEOUT" comment to the top
76 of a test file to disable timeouts on a per-test basis.
77
78 --preload-threshold ARG
79 --preload-threshold=ARG
80 --Pt ARG
81 --Pt=ARG
82 -W ARG
83 -W=ARG
84 --no-preload-threshold
85 Only do preload if at least N tests are going to be run. In some
86 cases a full preload takes longer than simply running the tests,
87 this lets you specify a minimum number of test jobs that will be
88 run for preload to happen. This has no effect for a persistent
89 runner. The default is 0, and it means always preload.
90
91 --preloads ARG
92 --preloads=ARG
93 --preload ARG
94 --preload=ARG
95 -P ARG
96 -P=ARG
97 --no-preloads
98 Preload a module before running tests
99
100 Can be specified multiple times
101
102 --switch ARG
103 --switch=ARG
104 -S ARG
105 -S=ARG
106 --no-switch
107 Pass the specified switch to perl for each test. This is not
108 compatible with preload.
109
110 Can be specified multiple times
111
112 --tlib
113 --no-tlib
114 (Default: off) Include 't/lib' in your module path
115
116 --unsafe-inc
117 --no-unsafe-inc
118 perl is removing '.' from @INC as a security concern. This option
119 keeps things from breaking for now.
120
121 Can also be set with the following environment variables:
122 "PERL_USE_UNSAFE_INC"
123
124 --use-fork
125 --fork
126 --no-use-fork
127 (default: on, except on windows) Normally tests are run by forking,
128 which allows for features like preloading. This will turn off the
129 behavior globally (which is not compatible with preloading). This
130 is slower, it is better to tag misbehaving tests with the '#
131 HARNESS-NO-PRELOAD' comment in their header to disable forking only
132 for those tests.
133
134 Can also be set with the following environment variables:
135 "!T2_NO_FORK", "T2_HARNESS_FORK", "!T2_HARNESS_NO_FORK",
136 "YATH_FORK", "!YATH_NO_FORK"
137
138 --use-timeout
139 --timeout
140 --no-use-timeout
141 (default: on) Enable/disable timeouts
142
144 The source code repository for Test2-Harness can be found at
145 http://github.com/Test-More/Test2-Harness/.
146
148 Chad Granum <exodist@cpan.org>
149
151 Chad Granum <exodist@cpan.org>
152
154 Copyright 2020 Chad Granum <exodist7@gmail.com>.
155
156 This program is free software; you can redistribute it and/or modify it
157 under the same terms as Perl itself.
158
159 See http://dev.perl.org/licenses/
160
161
162
163perl v5.32.0 2020-07-28 App::Yath::Options::Runner(3)