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 is 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 --hide-runner-output
194 --no-hide-runner-output
195 Hide output from the runner, showing only test output. (See Also
196 truncate_runner_output)
197 --no-wrap
199 --no-no-wrap
200 Do not do fancy text-wrapping, let the terminal handle it
201 --progress
203 --no-progress
204 Toggle progress indicators. On by default if STDOUT is a TTY. You
205 can use --no-progress to disable the 'events seen' counter and
206 buffered event pre-display
207 --quiet
209 -q
210 --no-quiet
211 Be very quiet.
212 Can be specified multiple times
214 --renderers +My::Renderer
216 --renderers Renderer=arg1,arg2,...
217 --renderer +My::Renderer
218 --renderer Renderer=arg1,arg2,...
219 --no-renderers
220 Specify renderers, (Default: "Formatter=Test2"). Use "+" to give a
221 fully qualified module name. Without "+"
222 "Test2::Harness::Renderer::" will be prepended to your argument.
223 Can be specified multiple times. If the same key is listed multiple
225 times the value lists will be appended together.
226 --show-times
228 -T
229 --no-show-times
230 Show the timing data for each job
231 --term-width 80
233 --term-width 200
234 --term-size 80
235 --term-size 200
236 --no-term-width
237 Alternative to setting $TABLE_TERM_SIZE. Setting this will override
238 the terminal width detection to the number of characters specified.
239 --truncate-runner-output
241 --no-truncate-runner-output
242 Only show runner output that was generated after the current
243 command. This is only useful with a persistent runner.
244 --verbose
246 -v
247 --no-verbose
248 Be more verbose
249 Can be specified multiple times
251 Formatter Options
253 --formatter ARG
255 --formatter=ARG
256 --no-formatter
257 NO DESCRIPTION - FIX ME
258 --qvf
260 --no-qvf
261 [Q]uiet, but [V]erbose on [F]ailure. Hide all output from tests
262 when they pass, except to say they passed. If a test fails then ALL
263 output from the test is verbosely output.
264 --show-job-end
266 --no-show-job-end
267 Show output when a job ends. (Default: on)
268 --show-job-info
270 --no-show-job-info
271 Show the job configuration when a job starts. (Default: off, unless
272 -vv)
273 --show-job-launch
275 --no-show-job-launch
276 Show output for the start of a job. (Default: off unless -v)
277 --show-run-info
279 --no-show-run-info
280 Show the run configuration when a run starts. (Default: off, unless
281 -vv)
282 Git Options
284 --git-change-base master
286 --git-change-base HEAD^
287 --git-change-base df22abe4
288 --no-git-change-base
289 Find files changed by all commits in the current branch from most
290 recent stopping when a commit is found that is also present in the
291 history of the branch/commit specified as the change base.
292 Help and Debugging
294 --dummy
296 -d
297 --no-dummy
298 Dummy run, do not actually execute anything
299 Can also be set with the following environment variables:
301 "T2_HARNESS_DUMMY"
302 --help
304 -h
305 --no-help
306 exit after showing help information
307 --interactive
309 -i
310 --no-interactive
311 Use interactive mode, 1 test at a time, stdin forwarded to it
312 --keep-dirs
314 --keep_dir
315 -k
316 --no-keep-dirs
317 Do not delete directories when done. This is useful if you want to
318 inspect the directories used for various commands.
319 --procname-prefix ARG
321 --procname-prefix=ARG
322 --no-procname-prefix
323 Add a prefix to all proc names (as seen by ps).
324 YathUI Options
326 --yathui-api-key ARG
328 --yathui-api-key=ARG
329 --no-yathui-api-key
330 Yath-UI API key. This is not necessary if your Yath-UI instance is
331 set to single-user
332 --yathui-db
334 --no-yathui-db
335 Add the YathUI DB renderer in addition to other renderers
336 --yathui-grace
338 --no-yathui-grace
339 If yath cannot connect to yath-ui it normally throws an error, use
340 this to make it fail gracefully. You get a warning, but things keep
341 going.
342 --yathui-long-duration 10
344 --no-yathui-long-duration
345 Minimum duration length (seconds) before a test goes from MEDIUM to
346 LONG
347 --yathui-medium-duration 5
349 --no-yathui-medium-duration
350 Minimum duration length (seconds) before a test goes from SHORT to
351 MEDIUM
352 --yathui-mode summary
354 --yathui-mode qvf
355 --yathui-mode qvfd
356 --yathui-mode complete
357 --no-yathui-mode
358 Set the upload mode (default 'qvfd')
359 --yathui-only
361 --no-yathui-only
362 Only use the YathUI renderer
363 --yathui-only-db
365 --no-yathui-only-db
366 Only use the YathUI DB renderer
367 --yathui-port 8080
369 --no-yathui-port
370 Port to use when running a local server
371 --yathui-port-command get_port.sh
373 --yathui-port-command get_port.sh --pid $$
374 --no-yathui-port-command
375 Use a command to get a port number. "$$" will be replaced with the
376 PID of the yath process
377 --yathui-project ARG
379 --yathui-project=ARG
380 --no-yathui-project
381 The Yath-UI project for your test results
382 --yathui-render
384 --no-yathui-render
385 Add the YathUI renderer in addition to other renderers
386 --yathui-resources
388 --yathui-resources=5
389 --no-yathui-resources
390 Send resource info (for supported resources) to yathui at the
391 specified interval in seconds (5 if not specified)
392 --yathui-retry
394 --no-yathui-retry
395 How many times to try an operation before giving up
396 Can be specified multiple times
398 --yathui-schema PostgreSQL
400 --yathui-schema MySQL
401 --yathui-schema MySQL56
402 --no-yathui-schema
403 What type of DB/schema to use when using a temporary database
404 --yathui-url http://my-yath-ui.com/...
406 --uri http://my-yath-ui.com/...
407 --no-yathui-url
408 Yath-UI url
409 --yathui-user ARG
411 --yathui-user=ARG
412 --no-yathui-user
413 Username to attach to the data sent to the db
414 --yathui-db-buffering none
416 --yathui-db-buffering job
417 --yathui-db-buffering diag
418 --yathui-db-buffering run
419 --no-yathui-db-buffering
420 Type of buffering to use, if "none" then events are written to the
421 db one at a time, which is SLOW
422 --yathui-db-config ARG
424 --yathui-db-config=ARG
425 --no-yathui-db-config
426 Module that implements 'MODULE->yath_ui_config(%params)' which
427 should return a Test2::Harness::UI::Config instance.
428 --yathui-db-coverage
430 --no-yathui-db-coverage
431 Pull coverage data directly from the database (default: off)
432 --yathui-db-driver Pg
434 --yathui-db-drivermysql
435 --yathui-db-driverMariaDB
436 --no-yathui-db-driver
437 DBI Driver to use
438 --yathui-db-dsn ARG
440 --yathui-db-dsn=ARG
441 --no-yathui-db-dsn
442 DSN to use when connecting to the db
443 --yathui-db-duration-limit ARG
445 --yathui-db-duration-limit=ARG
446 --no-yathui-db-duration-limit
447 Limit the number of runs to look at for durations data (default:
448 10)
449 --yathui-db-durations
451 --no-yathui-db-durations
452 Pull duration data directly from the database (default: off)
453 --yathui-db-flush-interval 2
455 --yathui-db-flush-interval 1.5
456 --no-yathui-db-flush-interval
457 When buffering DB writes, force a flush when an event is recieved
458 at least N seconds after the last flush.
459 --yathui-db-host ARG
461 --yathui-db-host=ARG
462 --no-yathui-db-host
463 hostname to use when connecting to the db
464 --yathui-db-name ARG
466 --yathui-db-name=ARG
467 --no-yathui-db-name
468 Name of the database to use for yathui
469 --yathui-db-pass ARG
471 --yathui-db-pass=ARG
472 --no-yathui-db-pass
473 Password to use when connecting to the db
474 --yathui-db-port ARG
476 --yathui-db-port=ARG
477 --no-yathui-db-port
478 port to use when connecting to the db
479 --yathui-db-publisher ARG
481 --yathui-db-publisher=ARG
482 --no-yathui-db-publisher
483 When using coverage or duration data, only use data uploaded by
484 this user
485 --yathui-db-socket ARG
487 --yathui-db-socket=ARG
488 --no-yathui-db-socket
489 socket to use when connecting to the db
490 --yathui-db-user ARG
492 --yathui-db-user=ARG
493 --no-yathui-db-user
494 Username to use when connecting to the db
495
497 The source code repository for Test2-Harness can be found at
498 http://github.com/Test-More/Test2-Harness/.
499
501 Chad Granum <exodist@cpan.org>
502
504 Chad Granum <exodist@cpan.org>
505
507 Copyright 2023 Chad Granum <exodist7@gmail.com>.
508 This program is free software; you can redistribute it and/or modify it
510 under the same terms as Perl itself.
511 See http://dev.perl.org/licenses/
513perl v5.38.0 2023-10-04 App::Yath::Command::replay(3)