1App::Yath::Command::repUlsaeyr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Command::replay(3)
2
3
4

NAME

6       App::Yath::Command::replay - Replay a test run from an event log
7

DESCRIPTION

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
14       This command accepts all the same renderer/formatter options that the
15       'test' command accepts.
16

USAGE

18           $ yath [YATH OPTIONS] replay [COMMAND OPTIONS]
19
20   YATH OPTIONS
21       Developer
22
23       --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
36           Can be specified multiple times
37
38       Environment
39
40       --persist-dir ARG
41       --persist-dir=ARG
42       --no-persist-dir
43           Where to find persistence files.
44
45       --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
57       --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
66       Help and Debugging
67
68       --show-opts
69       --no-show-opts
70           Exit after showing what yath thinks your options mean
71
72       --version
73       -V
74       --no-version
75           Exit after showing a helpful usage message
76
77       Plugins
78
79       --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
86       --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
96           Can be specified multiple times
97
98   COMMAND OPTIONS
99       Cover Options
100
101       --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
110       --cover-class ARG
111       --cover-class=ARG
112       --no-cover-class
113           Choose a Test2::Plugin::Cover subclass
114
115       --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
122           Can be specified multiple times
123
124       --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
132       --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
140       --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
149       --cover-manager My::Coverage::Manager
150       --no-cover-manager
151           Coverage 'from' manager to use when coverage data does not provide
152           one
153
154       --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
162       --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
169       --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
178           Can be specified multiple times
179
180       --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
187       Display Options
188
189       --color
190       --no-color
191           Turn color on, default is true if STDOUT is a TTY.
192
193       --no-wrap
194       --no-no-wrap
195           Do not do fancy text-wrapping, let the terminal handle it
196
197       --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
203       --quiet
204       -q
205       --no-quiet
206           Be very quiet.
207
208           Can be specified multiple times
209
210       --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
219           Can be specified multiple times. If the same key is listed multiple
220           times the value lists will be appended together.
221
222       --show-times
223       -T
224       --no-show-times
225           Show the timing data for each job
226
227       --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
235       --verbose
236       -v
237       --no-verbose
238           Be more verbose
239
240           Can be specified multiple times
241
242       Formatter Options
243
244       --formatter ARG
245       --formatter=ARG
246       --no-formatter
247           NO DESCRIPTION - FIX ME
248
249       --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
255       --show-job-end
256       --no-show-job-end
257           Show output when a job ends. (Default: on)
258
259       --show-job-info
260       --no-show-job-info
261           Show the job configuration when a job starts. (Default: off, unless
262           -vv)
263
264       --show-job-launch
265       --no-show-job-launch
266           Show output for the start of a job. (Default: off unless -v)
267
268       --show-run-info
269       --no-show-run-info
270           Show the run configuration when a run starts. (Default: off, unless
271           -vv)
272
273       Git Options
274
275       --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
283       Help and Debugging
284
285       --dummy
286       -d
287       --no-dummy
288           Dummy run, do not actually execute anything
289
290           Can also be set with the following environment variables:
291           "T2_HARNESS_DUMMY"
292
293       --help
294       -h
295       --no-help
296           exit after showing help information
297
298       --interactive
299       -i
300       --no-interactive
301           Use interactive mode, 1 test at a time, stdin forwarded to it
302
303       --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
310       YathUI Options
311
312       --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
318       --yathui-db
319       --no-yathui-db
320           Add the YathUI DB renderer in addition to other renderers
321
322       --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
328       --yathui-long-duration 10
329       --no-yathui-long-duration
330           Minimum duration length (seconds) before a test goes from MEDIUM to
331           LONG
332
333       --yathui-medium-duration 5
334       --no-yathui-medium-duration
335           Minimum duration length (seconds) before a test goes from SHORT to
336           MEDIUM
337
338       --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
345       --yathui-only
346       --no-yathui-only
347           Only use the YathUI renderer
348
349       --yathui-only-db
350       --no-yathui-only-db
351           Only use the YathUI DB renderer
352
353       --yathui-port 8080
354       --no-yathui-port
355           Port to use when running a local server
356
357       --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
363       --yathui-project ARG
364       --yathui-project=ARG
365       --no-yathui-project
366           The Yath-UI project for your test results
367
368       --yathui-render
369       --no-yathui-render
370           Add the YathUI renderer in addition to other renderers
371
372       --yathui-retry
373       --no-yathui-retry
374           How many times to try an operation before giving up
375
376           Can be specified multiple times
377
378       --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
384       --yathui-url http://my-yath-ui.com/...
385       --uri http://my-yath-ui.com/...
386       --no-yathui-url
387           Yath-UI url
388
389       --yathui-user ARG
390       --yathui-user=ARG
391       --no-yathui-user
392           Username to attach to the data sent to the db
393
394       --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
402       --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
408       --yathui-db-coverage
409       --no-yathui-db-coverage
410           Pull coverage data directly from the database (default: off)
411
412       --yathui-db-driver Pg
413       --yathui-db-drivermysql
414       --yathui-db-driverMariaDB
415       --no-yathui-db-driver
416           DBI Driver to use
417
418       --yathui-db-dsn ARG
419       --yathui-db-dsn=ARG
420       --no-yathui-db-dsn
421           DSN to use when connecting to the db
422
423       --yathui-db-durations
424       --no-yathui-db-durations
425           Pull duration data directly from the database (default: off)
426
427       --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
433       --yathui-db-host ARG
434       --yathui-db-host=ARG
435       --no-yathui-db-host
436           hostname to use when connecting to the db
437
438       --yathui-db-name ARG
439       --yathui-db-name=ARG
440       --no-yathui-db-name
441           Name of the database to use for yathui
442
443       --yathui-db-pass ARG
444       --yathui-db-pass=ARG
445       --no-yathui-db-pass
446           Password to use when connecting to the db
447
448       --yathui-db-port ARG
449       --yathui-db-port=ARG
450       --no-yathui-db-port
451           port to use when connecting to the db
452
453       --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
459       --yathui-db-socket ARG
460       --yathui-db-socket=ARG
461       --no-yathui-db-socket
462           socket to use when connecting to the db
463
464       --yathui-db-user ARG
465       --yathui-db-user=ARG
466       --no-yathui-db-user
467           Username to use when connecting to the db
468

SOURCE

470       The source code repository for Test2-Harness can be found at
471       http://github.com/Test-More/Test2-Harness/.
472

MAINTAINERS

474       Chad Granum <exodist@cpan.org>
475

AUTHORS

477       Chad Granum <exodist@cpan.org>
478
480       Copyright 2021 Chad Granum <exodist7@gmail.com>.
481
482       This program is free software; you can redistribute it and/or modify it
483       under the same terms as Perl itself.
484
485       See http://dev.perl.org/licenses/
486
487
488
489perl v5.34.0                      2021-11-05     App::Yath::Command::replay(3)
Impressum