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 Git Options
186 --git-change-base master
188 --git-change-base HEAD^
189 --git-change-base df22abe4
190 --no-git-change-base
191 Find files changed by all commits in the current branch from most
192 recent stopping when a commit is found that is also present in the
193 history of the branch/commit specified as the change base.
194 Help and Debugging
196 --dummy
198 -d
199 --no-dummy
200 Dummy run, do not actually execute anything
201 Can also be set with the following environment variables:
203 "T2_HARNESS_DUMMY"
204 --help
206 -h
207 --no-help
208 exit after showing help information
209 --keep-dirs
211 --keep_dir
212 -k
213 --no-keep-dirs
214 Do not delete directories when done. This is useful if you want to
215 inspect the directories used for various commands.
216 YathUI Options
218 --yathui-api-key ARG
220 --yathui-api-key=ARG
221 --no-yathui-api-key
222 Yath-UI API key. This is not necessary if your Yath-UI instance is
223 set to single-user
224 --yathui-db
226 --no-yathui-db
227 Add the YathUI DB renderer in addition to other renderers
228 --yathui-grace
230 --no-yathui-grace
231 If yath cannot connect to yath-ui it normally throws an error, use
232 this to make it fail gracefully. You get a warning, but things keep
233 going.
234 --yathui-long-duration 10
236 --no-yathui-long-duration
237 Minimum duration length (seconds) before a test goes from MEDIUM to
238 LONG
239 --yathui-medium-duration 5
241 --no-yathui-medium-duration
242 Minimum duration length (seconds) before a test goes from SHORT to
243 MEDIUM
244 --yathui-mode summary
246 --yathui-mode qvf
247 --yathui-mode qvfd
248 --yathui-mode complete
249 --no-yathui-mode
250 Set the upload mode (default 'qvfd')
251 --yathui-only
253 --no-yathui-only
254 Only use the YathUI renderer
255 --yathui-only-db
257 --no-yathui-only-db
258 Only use the YathUI DB renderer
259 --yathui-port 8080
261 --no-yathui-port
262 Port to use when running a local server
263 --yathui-port-command get_port.sh
265 --yathui-port-command get_port.sh --pid $$
266 --no-yathui-port-command
267 Use a command to get a port number. "$$" will be replaced with the
268 PID of the yath process
269 --yathui-project ARG
271 --yathui-project=ARG
272 --no-yathui-project
273 The Yath-UI project for your test results
274 --yathui-render
276 --no-yathui-render
277 Add the YathUI renderer in addition to other renderers
278 --yathui-retry
280 --no-yathui-retry
281 How many times to try an operation before giving up
282 Can be specified multiple times
284 --yathui-schema PostgreSQL
286 --yathui-schema MySQL
287 --yathui-schema MySQL56
288 --no-yathui-schema
289 What type of DB/schema to use when using a temporary database
290 --yathui-url http://my-yath-ui.com/...
292 --uri http://my-yath-ui.com/...
293 --no-yathui-url
294 Yath-UI url
295 --yathui-user ARG
297 --yathui-user=ARG
298 --no-yathui-user
299 Username to attach to the data sent to the db
300 --yathui-db-buffering none
302 --yathui-db-buffering job
303 --yathui-db-buffering diag
304 --yathui-db-buffering run
305 --no-yathui-db-buffering
306 Type of buffering to use, if "none" then events are written to the
307 db one at a time, which is SLOW
308 --yathui-db-config ARG
310 --yathui-db-config=ARG
311 --no-yathui-db-config
312 Module that implements 'MODULE->yath_ui_config(%params)' which
313 should return a Test2::Harness::UI::Config instance.
314 --yathui-db-driver Pg
316 --yathui-db-drivermysql
317 --yathui-db-driverMariaDB
318 --no-yathui-db-driver
319 DBI Driver to use
320 --yathui-db-dsn ARG
322 --yathui-db-dsn=ARG
323 --no-yathui-db-dsn
324 DSN to use when connecting to the db
325 --yathui-db-flush-interval 2
327 --yathui-db-flush-interval 1.5
328 --no-yathui-db-flush-interval
329 When buffering DB writes, force a flush when an event is recieved
330 at least N seconds after the last flush.
331 --yathui-db-host ARG
333 --yathui-db-host=ARG
334 --no-yathui-db-host
335 hostname to use when connecting to the db
336 --yathui-db-name ARG
338 --yathui-db-name=ARG
339 --no-yathui-db-name
340 Name of the database to use for yathui
341 --yathui-db-pass ARG
343 --yathui-db-pass=ARG
344 --no-yathui-db-pass
345 Password to use when connecting to the db
346 --yathui-db-port ARG
348 --yathui-db-port=ARG
349 --no-yathui-db-port
350 port to use when connecting to the db
351 --yathui-db-socket ARG
353 --yathui-db-socket=ARG
354 --no-yathui-db-socket
355 socket to use when connecting to the db
356 --yathui-db-user ARG
358 --yathui-db-user=ARG
359 --no-yathui-db-user
360 Username to use when connecting to the db
361
363 The source code repository for Test2-Harness can be found at
364 http://github.com/Test-More/Test2-Harness/.
365
367 Chad Granum <exodist@cpan.org>
368
370 Chad Granum <exodist@cpan.org>
371
373 Copyright 2021 Chad Granum <exodist7@gmail.com>.
374 This program is free software; you can redistribute it and/or modify it
376 under the same terms as Perl itself.
377 See http://dev.perl.org/licenses/
379perl v5.32.1 2021-03-12 App::Yath::Command::replay(3)