App::Yath::Command::failed(3pm)

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

NAME

6       App::Yath::Command::failed - 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] failed [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       Display Options
100
101       --brief
102       --no-brief
103           Show only files that failed, newline separated, no other output. If
104           a file dailed once but passed on a retry it will NOT be shown.
105
106       Git Options
107
108       --git-change-base master
109       --git-change-base HEAD^
110       --git-change-base df22abe4
111       --no-git-change-base
112           Find files changed by all commits in the current branch from most
113           recent stopping when a commit is found that is also present in the
114           history of the branch/commit specified as the change base.
115
116       Help and Debugging
117
118       --dummy
119       -d
120       --no-dummy
121           Dummy run, do not actually execute anything
122
123           Can also be set with the following environment variables:
124           "T2_HARNESS_DUMMY"
125
126       --help
127       -h
128       --no-help
129           exit after showing help information
130
131       --keep-dirs
132       --keep_dir
133       -k
134       --no-keep-dirs
135           Do not delete directories when done. This is useful if you want to
136           inspect the directories used for various commands.
137
138       YathUI Options
139
140       --yathui-api-key ARG
141       --yathui-api-key=ARG
142       --no-yathui-api-key
143           Yath-UI API key. This is not necessary if your Yath-UI instance is
144           set to single-user
145
146       --yathui-db
147       --no-yathui-db
148           Add the YathUI DB renderer in addition to other renderers
149
150       --yathui-grace
151       --no-yathui-grace
152           If yath cannot connect to yath-ui it normally throws an error, use
153           this to make it fail gracefully. You get a warning, but things keep
154           going.
155
156       --yathui-long-duration 10
157       --no-yathui-long-duration
158           Minimum duration length (seconds) before a test goes from MEDIUM to
159           LONG
160
161       --yathui-medium-duration 5
162       --no-yathui-medium-duration
163           Minimum duration length (seconds) before a test goes from SHORT to
164           MEDIUM
165
166       --yathui-mode summary
167       --yathui-mode qvf
168       --yathui-mode qvfd
169       --yathui-mode complete
170       --no-yathui-mode
171           Set the upload mode (default 'qvfd')
172
173       --yathui-only
174       --no-yathui-only
175           Only use the YathUI renderer
176
177       --yathui-only-db
178       --no-yathui-only-db
179           Only use the YathUI DB renderer
180
181       --yathui-port 8080
182       --no-yathui-port
183           Port to use when running a local server
184
185       --yathui-port-command get_port.sh
186       --yathui-port-command get_port.sh --pid $$
187       --no-yathui-port-command
188           Use a command to get a port number. "$$" will be replaced with the
189           PID of the yath process
190
191       --yathui-project ARG
192       --yathui-project=ARG
193       --no-yathui-project
194           The Yath-UI project for your test results
195
196       --yathui-render
197       --no-yathui-render
198           Add the YathUI renderer in addition to other renderers
199
200       --yathui-retry
201       --no-yathui-retry
202           How many times to try an operation before giving up
203
204           Can be specified multiple times
205
206       --yathui-schema PostgreSQL
207       --yathui-schema MySQL
208       --yathui-schema MySQL56
209       --no-yathui-schema
210           What type of DB/schema to use when using a temporary database
211
212       --yathui-url http://my-yath-ui.com/...
213       --uri http://my-yath-ui.com/...
214       --no-yathui-url
215           Yath-UI url
216
217       --yathui-user ARG
218       --yathui-user=ARG
219       --no-yathui-user
220           Username to attach to the data sent to the db
221
222       --yathui-db-buffering none
223       --yathui-db-buffering job
224       --yathui-db-buffering diag
225       --yathui-db-buffering run
226       --no-yathui-db-buffering
227           Type of buffering to use, if "none" then events are written to the
228           db one at a time, which is SLOW
229
230       --yathui-db-config ARG
231       --yathui-db-config=ARG
232       --no-yathui-db-config
233           Module that implements 'MODULE->yath_ui_config(%params)' which
234           should return a Test2::Harness::UI::Config instance.
235
236       --yathui-db-driver Pg
237       --yathui-db-drivermysql
238       --yathui-db-driverMariaDB
239       --no-yathui-db-driver
240           DBI Driver to use
241
242       --yathui-db-dsn ARG
243       --yathui-db-dsn=ARG
244       --no-yathui-db-dsn
245           DSN to use when connecting to the db
246
247       --yathui-db-flush-interval 2
248       --yathui-db-flush-interval 1.5
249       --no-yathui-db-flush-interval
250           When buffering DB writes, force a flush when an event is recieved
251           at least N seconds after the last flush.
252
253       --yathui-db-host ARG
254       --yathui-db-host=ARG
255       --no-yathui-db-host
256           hostname to use when connecting to the db
257
258       --yathui-db-name ARG
259       --yathui-db-name=ARG
260       --no-yathui-db-name
261           Name of the database to use for yathui
262
263       --yathui-db-pass ARG
264       --yathui-db-pass=ARG
265       --no-yathui-db-pass
266           Password to use when connecting to the db
267
268       --yathui-db-port ARG
269       --yathui-db-port=ARG
270       --no-yathui-db-port
271           port to use when connecting to the db
272
273       --yathui-db-socket ARG
274       --yathui-db-socket=ARG
275       --no-yathui-db-socket
276           socket to use when connecting to the db
277
278       --yathui-db-user ARG
279       --yathui-db-user=ARG
280       --no-yathui-db-user
281           Username to use when connecting to the db
282

SOURCE

284       The source code repository for Test2-Harness can be found at
285       http://github.com/Test-More/Test2-Harness/.
286

MAINTAINERS

288       Chad Granum <exodist@cpan.org>
289

AUTHORS

291       Chad Granum <exodist@cpan.org>
292

COPYRIGHT

294       Copyright 2021 Chad Granum <exodist7@gmail.com>.
295
296       This program is free software; you can redistribute it and/or modify it
297       under the same terms as Perl itself.
298
299       See http://dev.perl.org/licenses/
300
301
302
303perl v5.32.1                      2021-03-12     App::Yath::Command::failed(3)