1App::Yath::Command::repUlsaeyr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Command::replay(3)
2
6 App::Yath::Command::replay - Replay a test run from an event log
7
9 This yath command will re-run the harness against an event log produced
10 by a previous test run. The only required argument is the path to the
11 log file, which maybe compressed. Any extra arguments are assumed to be
12 job id's. If you list any jobs, only listed jobs will be processed.
13 This command accepts all the same renderer/formatter options that the
15 'test' command accepts.
16
18 $ yath [YATH OPTIONS] replay [COMMAND OPTIONS]
19 YATH OPTIONS
21 Developer
22 --dev-lib
24 --dev-lib=lib
25 -D
26 -D=lib
27 -Dlib
28 --no-dev-lib
29 Add paths to @INC before loading ANYTHING. This is what you use if
30 you are developing yath or yath plugins to make sure the yath
31 script finds the local code instead of the installed versions of
32 the same code. You can provide an argument (-Dfoo) to provide a
33 custom path, or you can just use -D without and arg to add lib,
34 blib/lib and blib/arch.
35 Can be specified multiple times
37 Environment
39 --persist-dir ARG
41 --persist-dir=ARG
42 --no-persist-dir
43 Where to find persistence files.
44 --persist-file ARG
46 --persist-file=ARG
47 --pfile ARG
48 --pfile=ARG
49 --no-persist-file
50 Where to find the persistence file. The default is
51 /{system-tempdir}/project-yath-persist.json. If no project is
52 specified then it will fall back to the current directory. If the
53 current directory is not writable it will default to
54 /tmp/yath-persist.json which limits you to one persistent runner on
55 your system.
56 --project ARG
58 --project=ARG
59 --project-name ARG
60 --project-name=ARG
61 --no-project
62 This lets you provide a label for your current project/codebase.
63 This is best used in a .yath.rc file. This is necessary for a
64 persistent runner.
65 Help and Debugging
67 --show-opts
69 --no-show-opts
70 Exit after showing what yath thinks your options mean
71 --version
73 -V
74 --no-version
75 Exit after showing a helpful usage message
76 Plugins
78 --no-scan-plugins
80 --no-no-scan-plugins
81 Normally yath scans for and loads all App::Yath::Plugin::* modules
82 in order to bring in command-line options they may provide. This
83 flag will disable that. This is useful if you have a naughty plugin
84 that it loading other modules when it should not.
85 --plugins PLUGIN
87 --plugins +App::Yath::Plugin::PLUGIN
88 --plugins PLUGIN=arg1,arg2,...
89 --plugin PLUGIN
90 --plugin +App::Yath::Plugin::PLUGIN
91 --plugin PLUGIN=arg1,arg2,...
92 -pPLUGIN
93 --no-plugins
94 Load a yath plugin.
95 Can be specified multiple times
97 COMMAND OPTIONS
99 Display Options
100 --color
102 --no-color
103 Turn color on, default is true if STDOUT is a TTY.
104 --no-wrap
106 --no-no-wrap
107 Do not do fancy text-wrapping, let the terminal handle it
108 --progress
110 --no-progress
111 Toggle progress indicators. On by default if STDOUT is a TTY. You
112 can use --no-progress to disable the 'events seen' counter and
113 buffered event pre-display
114 --quiet
116 -q
117 --no-quiet
118 Be very quiet.
119 Can be specified multiple times
121 --renderers +My::Renderer
123 --renderers Renderer=arg1,arg2,...
124 --renderer +My::Renderer
125 --renderer Renderer=arg1,arg2,...
126 --no-renderers
127 Specify renderers, (Default: "Formatter=Test2"). Use "+" to give a
128 fully qualified module name. Without "+"
129 "Test2::Harness::Renderer::" will be prepended to your argument.
130 Can be specified multiple times. If the same key is listed multiple
132 times the value lists will be appended together.
133 --show-times
135 -T
136 --no-show-times
137 Show the timing data for each job
138 --term-width 80
140 --term-width 200
141 --term-size 80
142 --term-size 200
143 --no-term-width
144 Alternative to setting $TABLE_TERM_SIZE. Setting this will override
145 the terminal width detection to the number of characters specified.
146 --verbose
148 -v
149 --no-verbose
150 Be more verbose
151 Can be specified multiple times
153 Formatter Options
155 --formatter ARG
157 --formatter=ARG
158 --no-formatter
159 NO DESCRIPTION - FIX ME
160 --qvf
162 --no-qvf
163 [Q]uiet, but [V]erbose on [F]ailure. Hide all output from tests
164 when they pass, except to say they passed. If a test fails then ALL
165 output from the test is verbosely output.
166 --show-job-end
168 --no-show-job-end
169 Show output when a job ends. (Default: on)
170 --show-job-info
172 --no-show-job-info
173 Show the job configuration when a job starts. (Default: off, unless
174 -vv)
175 --show-job-launch
177 --no-show-job-launch
178 Show output for the start of a job. (Default: off unless -v)
179 --show-run-info
181 --no-show-run-info
182 Show the run configuration when a run starts. (Default: off, unless
183 -vv)
184 Help and Debugging
186 --dummy
188 -d
189 --no-dummy
190 Dummy run, do not actually execute anything
191 Can also be set with the following environment variables:
193 "T2_HARNESS_DUMMY"
194 --help
196 -h
197 --no-help
198 exit after showing help information
199 --keep-dirs
201 --keep_dir
202 -k
203 --no-keep-dirs
204 Do not delete directories when done. This is useful if you want to
205 inspect the directories used for various commands.
206 YathUI Options
208 --yathui-api-key ARG
210 --yathui-api-key=ARG
211 --no-yathui-api-key
212 Yath-UI API key. This is not necessary if your Yath-UI instance is
213 set to single-user
214 --yathui-grace
216 --no-yathui-grace
217 If yath cannot connect to yath-ui it normally throws an error, use
218 this to make it fail gracefully. You get a warning, but things keep
219 going.
220 --yathui-long-duration 10
222 --no-yathui-long-duration
223 Minimum duration length (seconds) before a test goes from MEDIUM to
224 LONG
225 --yathui-medium-duration 5
227 --no-yathui-medium-duration
228 Minimum duration length (seconds) before a test goes from SHORT to
229 MEDIUM
230 --yathui-mode summary
232 --yathui-mode qvf
233 --yathui-mode qvfd
234 --yathui-mode complete
235 --no-yathui-mode
236 Set the upload mode (default 'qvfd')
237 --yathui-project ARG
239 --yathui-project=ARG
240 --no-yathui-project
241 The Yath-UI project for your test results
242 --yathui-retry
244 --no-yathui-retry
245 How many times to try an operation before giving up
246 Can be specified multiple times
248 --yathui-url http://my-yath-ui.com/...
250 --uri http://my-yath-ui.com/...
251 --no-yathui-url
252 Yath-UI url
253
255 The source code repository for Test2-Harness can be found at
256 http://github.com/Test-More/Test2-Harness/.
257
259 Chad Granum <exodist@cpan.org>
260
262 Chad Granum <exodist@cpan.org>
263
265 Copyright 2020 Chad Granum <exodist7@gmail.com>.
266 This program is free software; you can redistribute it and/or modify it
268 under the same terms as Perl itself.
269 See http://dev.perl.org/licenses/
271perl v5.32.0 2020-07-28 App::Yath::Command::replay(3)