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 Cover Options
100 --cover-aggregator ByTest
102 --cover-aggregator ByRun
103 --cover-aggregator +Custom::Aggregator
104 --cover-agg ByTest
105 --cover-agg ByRun
106 --cover-agg +Custom::Aggregator
107 --no-cover-aggregator
108 Choose a custom aggregator subclass
109 --cover-class ARG
111 --cover-class=ARG
112 --no-cover-class
113 Choose a Test2::Plugin::Cover subclass
114 --cover-dirs ARG
116 --cover-dirs=ARG
117 --cover-dir ARG
118 --cover-dir=ARG
119 --no-cover-dirs
120 NO DESCRIPTION - FIX ME
121 Can be specified multiple times
123 --cover-exclude-private
125 --no-cover-exclude-private
126 --cover-files
127 --no-cover-files
128 Use Test2::Plugin::Cover to collect coverage data for what files
129 are touched by what tests. Unlike Devel::Cover this has very little
130 performance impact (About 4% difference)
131 --cover-from path/to/log.jsonl
133 --cover-from http://example.com/coverage
134 --cover-from path/to/coverage.jsonl
135 --no-cover-from
136 This can be a test log, a coverage dump (old style json or new
137 jsonl format), or a url to any of the previous. Tests will not be
138 run if the file/url is invalid.
139 --cover-from-type json
141 --cover-from-type jsonl
142 --cover-from-type log
143 --no-cover-from-type
144 File type for coverage source. Usually it can be detected, but when
145 it cannot be you should specify. "json" is old style single-blob
146 coverage data, "jsonl" is the new by-test style, "log" is a logfile
147 from a previous run.
148 --cover-manager My::Coverage::Manager
150 --no-cover-manager
151 Coverage 'from' manager to use when coverage data does not provide
152 one
153 --cover-maybe-from path/to/log.jsonl
155 --cover-maybe-from http://example.com/coverage
156 --cover-maybe-from path/to/coverage.jsonl
157 --no-cover-maybe-from
158 This can be a test log, a coverage dump (old style json or new
159 jsonl format), or a url to any of the previous. Tests will coninue
160 if even if the coverage file/url is invalid.
161 --cover-maybe-from-type json
163 --cover-maybe-from-type jsonl
164 --cover-maybe-from-type log
165 --no-cover-maybe-from-type
166 Same as "from_type" but for "maybe_from". Defaults to "from_type"
167 if that is specified, otherwise auto-detect
168 --cover-metrics
170 --no-cover-metrics
171 --cover-types ARG
172 --cover-types=ARG
173 --cover-type ARG
174 --cover-type=ARG
175 --no-cover-types
176 NO DESCRIPTION - FIX ME
177 Can be specified multiple times
179 --cover-write
181 --cover-write=coverage.jsonl
182 --cover-write=coverage.json
183 --no-cover-write
184 Create a json or jsonl file of all coverage data seen during the
185 run (This implies --cover-files).
186 Display Options
188 --color
190 --no-color
191 Turn color on, default is true if STDOUT is a TTY.
192 --no-wrap
194 --no-no-wrap
195 Do not do fancy text-wrapping, let the terminal handle it
196 --progress
198 --no-progress
199 Toggle progress indicators. On by default if STDOUT is a TTY. You
200 can use --no-progress to disable the 'events seen' counter and
201 buffered event pre-display
202 --quiet
204 -q
205 --no-quiet
206 Be very quiet.
207 Can be specified multiple times
209 --renderers +My::Renderer
211 --renderers Renderer=arg1,arg2,...
212 --renderer +My::Renderer
213 --renderer Renderer=arg1,arg2,...
214 --no-renderers
215 Specify renderers, (Default: "Formatter=Test2"). Use "+" to give a
216 fully qualified module name. Without "+"
217 "Test2::Harness::Renderer::" will be prepended to your argument.
218 Can be specified multiple times. If the same key is listed multiple
220 times the value lists will be appended together.
221 --show-times
223 -T
224 --no-show-times
225 Show the timing data for each job
226 --term-width 80
228 --term-width 200
229 --term-size 80
230 --term-size 200
231 --no-term-width
232 Alternative to setting $TABLE_TERM_SIZE. Setting this will override
233 the terminal width detection to the number of characters specified.
234 --verbose
236 -v
237 --no-verbose
238 Be more verbose
239 Can be specified multiple times
241 Formatter Options
243 --formatter ARG
245 --formatter=ARG
246 --no-formatter
247 NO DESCRIPTION - FIX ME
248 --qvf
250 --no-qvf
251 [Q]uiet, but [V]erbose on [F]ailure. Hide all output from tests
252 when they pass, except to say they passed. If a test fails then ALL
253 output from the test is verbosely output.
254 --show-job-end
256 --no-show-job-end
257 Show output when a job ends. (Default: on)
258 --show-job-info
260 --no-show-job-info
261 Show the job configuration when a job starts. (Default: off, unless
262 -vv)
263 --show-job-launch
265 --no-show-job-launch
266 Show output for the start of a job. (Default: off unless -v)
267 --show-run-info
269 --no-show-run-info
270 Show the run configuration when a run starts. (Default: off, unless
271 -vv)
272 Git Options
274 --git-change-base master
276 --git-change-base HEAD^
277 --git-change-base df22abe4
278 --no-git-change-base
279 Find files changed by all commits in the current branch from most
280 recent stopping when a commit is found that is also present in the
281 history of the branch/commit specified as the change base.
282 Help and Debugging
284 --dummy
286 -d
287 --no-dummy
288 Dummy run, do not actually execute anything
289 Can also be set with the following environment variables:
291 "T2_HARNESS_DUMMY"
292 --help
294 -h
295 --no-help
296 exit after showing help information
297 --interactive
299 -i
300 --no-interactive
301 Use interactive mode, 1 test at a time, stdin forwarded to it
302 --keep-dirs
304 --keep_dir
305 -k
306 --no-keep-dirs
307 Do not delete directories when done. This is useful if you want to
308 inspect the directories used for various commands.
309 YathUI Options
311 --yathui-api-key ARG
313 --yathui-api-key=ARG
314 --no-yathui-api-key
315 Yath-UI API key. This is not necessary if your Yath-UI instance is
316 set to single-user
317 --yathui-db
319 --no-yathui-db
320 Add the YathUI DB renderer in addition to other renderers
321 --yathui-grace
323 --no-yathui-grace
324 If yath cannot connect to yath-ui it normally throws an error, use
325 this to make it fail gracefully. You get a warning, but things keep
326 going.
327 --yathui-long-duration 10
329 --no-yathui-long-duration
330 Minimum duration length (seconds) before a test goes from MEDIUM to
331 LONG
332 --yathui-medium-duration 5
334 --no-yathui-medium-duration
335 Minimum duration length (seconds) before a test goes from SHORT to
336 MEDIUM
337 --yathui-mode summary
339 --yathui-mode qvf
340 --yathui-mode qvfd
341 --yathui-mode complete
342 --no-yathui-mode
343 Set the upload mode (default 'qvfd')
344 --yathui-only
346 --no-yathui-only
347 Only use the YathUI renderer
348 --yathui-only-db
350 --no-yathui-only-db
351 Only use the YathUI DB renderer
352 --yathui-port 8080
354 --no-yathui-port
355 Port to use when running a local server
356 --yathui-port-command get_port.sh
358 --yathui-port-command get_port.sh --pid $$
359 --no-yathui-port-command
360 Use a command to get a port number. "$$" will be replaced with the
361 PID of the yath process
362 --yathui-project ARG
364 --yathui-project=ARG
365 --no-yathui-project
366 The Yath-UI project for your test results
367 --yathui-render
369 --no-yathui-render
370 Add the YathUI renderer in addition to other renderers
371 --yathui-retry
373 --no-yathui-retry
374 How many times to try an operation before giving up
375 Can be specified multiple times
377 --yathui-schema PostgreSQL
379 --yathui-schema MySQL
380 --yathui-schema MySQL56
381 --no-yathui-schema
382 What type of DB/schema to use when using a temporary database
383 --yathui-url http://my-yath-ui.com/...
385 --uri http://my-yath-ui.com/...
386 --no-yathui-url
387 Yath-UI url
388 --yathui-user ARG
390 --yathui-user=ARG
391 --no-yathui-user
392 Username to attach to the data sent to the db
393 --yathui-db-buffering none
395 --yathui-db-buffering job
396 --yathui-db-buffering diag
397 --yathui-db-buffering run
398 --no-yathui-db-buffering
399 Type of buffering to use, if "none" then events are written to the
400 db one at a time, which is SLOW
401 --yathui-db-config ARG
403 --yathui-db-config=ARG
404 --no-yathui-db-config
405 Module that implements 'MODULE->yath_ui_config(%params)' which
406 should return a Test2::Harness::UI::Config instance.
407 --yathui-db-coverage
409 --no-yathui-db-coverage
410 Pull coverage data directly from the database (default: off)
411 --yathui-db-driver Pg
413 --yathui-db-drivermysql
414 --yathui-db-driverMariaDB
415 --no-yathui-db-driver
416 DBI Driver to use
417 --yathui-db-dsn ARG
419 --yathui-db-dsn=ARG
420 --no-yathui-db-dsn
421 DSN to use when connecting to the db
422 --yathui-db-durations
424 --no-yathui-db-durations
425 Pull duration data directly from the database (default: off)
426 --yathui-db-flush-interval 2
428 --yathui-db-flush-interval 1.5
429 --no-yathui-db-flush-interval
430 When buffering DB writes, force a flush when an event is recieved
431 at least N seconds after the last flush.
432 --yathui-db-host ARG
434 --yathui-db-host=ARG
435 --no-yathui-db-host
436 hostname to use when connecting to the db
437 --yathui-db-name ARG
439 --yathui-db-name=ARG
440 --no-yathui-db-name
441 Name of the database to use for yathui
442 --yathui-db-pass ARG
444 --yathui-db-pass=ARG
445 --no-yathui-db-pass
446 Password to use when connecting to the db
447 --yathui-db-port ARG
449 --yathui-db-port=ARG
450 --no-yathui-db-port
451 port to use when connecting to the db
452 --yathui-db-publisher ARG
454 --yathui-db-publisher=ARG
455 --no-yathui-db-publisher
456 When using coverage or duration data, only use data uploaded by
457 this user
458 --yathui-db-socket ARG
460 --yathui-db-socket=ARG
461 --no-yathui-db-socket
462 socket to use when connecting to the db
463 --yathui-db-user ARG
465 --yathui-db-user=ARG
466 --no-yathui-db-user
467 Username to use when connecting to the db
468
470 The source code repository for Test2-Harness can be found at
471 http://github.com/Test-More/Test2-Harness/.
472
474 Chad Granum <exodist@cpan.org>
475
477 Chad Granum <exodist@cpan.org>
478
480 Copyright 2021 Chad Granum <exodist7@gmail.com>.
481 This program is free software; you can redistribute it and/or modify it
483 under the same terms as Perl itself.
484 See http://dev.perl.org/licenses/
486perl v5.34.0 2021-11-05 App::Yath::Command::replay(3)