1App::Yath::Options::RunUnseerr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Options::Runner(3)
2
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 --blib
16 -b
17 --no-blib
18 (Default: include if it exists) Include 'blib/lib' and 'blib/arch'
19 in your module path
20 --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 --event-timeout SECONDS
29 --et SECONDS
30 --no-event-timeout
31 Kill test if no output is received within timeout period. (Default:
32 60 seconds). Add the "# HARNESS-NO-TIMEOUT" comment to the top of a
33 test file to disable timeouts on a per-test basis. This prevents a
34 hung test from running forever.
35 --include ARG
37 --include=ARG
38 -I ARG
39 -I=ARG
40 --no-include
41 Add a directory to your include paths
42 Can be specified multiple times
44 --job-count ARG
46 --job-count=ARG
47 --jobs ARG
48 --jobs=ARG
49 -j ARG
50 -j=ARG
51 --no-job-count
52 Set the number of concurrent jobs to run (Default: 1)
53 Can also be set with the following environment variables:
55 "YATH_JOB_COUNT", "T2_HARNESS_JOB_COUNT", "HARNESS_JOB_COUNT"
56 --lib
58 -l
59 --no-lib
60 (Default: include if it exists) Include 'lib' in your module path
61 --nytprof
63 --no-nytprof
64 Use Devel::NYTProf on tests. This will set addpid=1 for you. This
65 works with or without fork.
66 --post-exit-timeout SECONDS
68 --pet SECONDS
69 --no-post-exit-timeout
70 Stop waiting post-exit after the timeout period. (Default: 15
71 seconds) Some tests fork and allow the parent to exit before
72 writing all their output. If Test2::Harness detects an incomplete
73 plan after the test exits it will monitor for more events until the
74 timeout period. Add the "# HARNESS-NO-TIMEOUT" comment to the top
75 of a test file to disable timeouts on a per-test basis.
76 --preload-threshold ARG
78 --preload-threshold=ARG
79 --Pt ARG
80 --Pt=ARG
81 -W ARG
82 -W=ARG
83 --no-preload-threshold
84 Only do preload if at least N tests are going to be run. In some
85 cases a full preload takes longer than simply running the tests,
86 this lets you specify a minimum number of test jobs that will be
87 run for preload to happen. This has no effect for a persistent
88 runner. The default is 0, and it means always preload.
89 --preloads ARG
91 --preloads=ARG
92 --preload ARG
93 --preload=ARG
94 -P ARG
95 -P=ARG
96 --no-preloads
97 Preload a module before running tests
98 Can be specified multiple times
100 --resource Port
102 --resource +Test2::Harness::Runner::Resource::Port
103 -R Port
104 --no-resource
105 Use a resource module to assign resource assignments to individual
106 tests
107 Can be specified multiple times
109 --switch ARG
111 --switch=ARG
112 -S ARG
113 -S=ARG
114 --no-switch
115 Pass the specified switch to perl for each test. This is not
116 compatible with preload.
117 Can be specified multiple times
119 --tlib
121 --no-tlib
122 (Default: off) Include 't/lib' in your module path
123 --unsafe-inc
125 --no-unsafe-inc
126 perl is removing '.' from @INC as a security concern. This option
127 keeps things from breaking for now.
128 Can also be set with the following environment variables:
130 "PERL_USE_UNSAFE_INC"
131 --use-fork
133 --fork
134 --no-use-fork
135 (default: on, except on windows) Normally tests are run by forking,
136 which allows for features like preloading. This will turn off the
137 behavior globally (which is not compatible with preloading). This
138 is slower, it is better to tag misbehaving tests with the '#
139 HARNESS-NO-PRELOAD' comment in their header to disable forking only
140 for those tests.
141 Can also be set with the following environment variables:
143 "!T2_NO_FORK", "T2_HARNESS_FORK", "!T2_HARNESS_NO_FORK",
144 "YATH_FORK", "!YATH_NO_FORK"
145 --use-timeout
147 --timeout
148 --no-use-timeout
149 (default: on) Enable/disable timeouts
150
152 The source code repository for Test2-Harness can be found at
153 http://github.com/Test-More/Test2-Harness/.
154
156 Chad Granum <exodist@cpan.org>
157
159 Chad Granum <exodist@cpan.org>
160
162 Copyright 2020 Chad Granum <exodist7@gmail.com>.
163 This program is free software; you can redistribute it and/or modify it
165 under the same terms as Perl itself.
166 See http://dev.perl.org/licenses/
168perl v5.32.1 2021-03-12 App::Yath::Options::Runner(3)