1App::Yath::Command::faiUlseedr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Command::failed(3)
2
6 App::Yath::Command::failed - Show the failed tests from an event log
7
9 This yath command will list the test scripts from an event log that
10 have failed. The only required argument is the path to the log file,
11 which may be compressed. Any extra arguments are assumed to be job
12 id's. If you list any jobs, only the 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] failed [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 --brief
190 --no-brief
191 Show only the files that failed, newline separated, no other
192 output. If a file failed once but passed on a retry it will NOT be
193 shown.
194 Git Options
196 --git-change-base master
198 --git-change-base HEAD^
199 --git-change-base df22abe4
200 --no-git-change-base
201 Find files changed by all commits in the current branch from most
202 recent stopping when a commit is found that is also present in the
203 history of the branch/commit specified as the change base.
204 Help and Debugging
206 --dummy
208 -d
209 --no-dummy
210 Dummy run, do not actually execute anything
211 Can also be set with the following environment variables:
213 "T2_HARNESS_DUMMY"
214 --help
216 -h
217 --no-help
218 exit after showing help information
219 --interactive
221 -i
222 --no-interactive
223 Use interactive mode, 1 test at a time, stdin forwarded to it
224 --keep-dirs
226 --keep_dir
227 -k
228 --no-keep-dirs
229 Do not delete directories when done. This is useful if you want to
230 inspect the directories used for various commands.
231 --procname-prefix ARG
233 --procname-prefix=ARG
234 --no-procname-prefix
235 Add a prefix to all proc names (as seen by ps).
236 YathUI Options
238 --yathui-api-key ARG
240 --yathui-api-key=ARG
241 --no-yathui-api-key
242 Yath-UI API key. This is not necessary if your Yath-UI instance is
243 set to single-user
244 --yathui-db
246 --no-yathui-db
247 Add the YathUI DB renderer in addition to other renderers
248 --yathui-grace
250 --no-yathui-grace
251 If yath cannot connect to yath-ui it normally throws an error, use
252 this to make it fail gracefully. You get a warning, but things keep
253 going.
254 --yathui-long-duration 10
256 --no-yathui-long-duration
257 Minimum duration length (seconds) before a test goes from MEDIUM to
258 LONG
259 --yathui-medium-duration 5
261 --no-yathui-medium-duration
262 Minimum duration length (seconds) before a test goes from SHORT to
263 MEDIUM
264 --yathui-mode summary
266 --yathui-mode qvf
267 --yathui-mode qvfd
268 --yathui-mode complete
269 --no-yathui-mode
270 Set the upload mode (default 'qvfd')
271 --yathui-only
273 --no-yathui-only
274 Only use the YathUI renderer
275 --yathui-only-db
277 --no-yathui-only-db
278 Only use the YathUI DB renderer
279 --yathui-port 8080
281 --no-yathui-port
282 Port to use when running a local server
283 --yathui-port-command get_port.sh
285 --yathui-port-command get_port.sh --pid $$
286 --no-yathui-port-command
287 Use a command to get a port number. "$$" will be replaced with the
288 PID of the yath process
289 --yathui-project ARG
291 --yathui-project=ARG
292 --no-yathui-project
293 The Yath-UI project for your test results
294 --yathui-render
296 --no-yathui-render
297 Add the YathUI renderer in addition to other renderers
298 --yathui-resources
300 --yathui-resources=5
301 --no-yathui-resources
302 Send resource info (for supported resources) to yathui at the
303 specified interval in seconds (5 if not specified)
304 --yathui-retry
306 --no-yathui-retry
307 How many times to try an operation before giving up
308 Can be specified multiple times
310 --yathui-schema PostgreSQL
312 --yathui-schema MySQL
313 --yathui-schema MySQL56
314 --no-yathui-schema
315 What type of DB/schema to use when using a temporary database
316 --yathui-url http://my-yath-ui.com/...
318 --uri http://my-yath-ui.com/...
319 --no-yathui-url
320 Yath-UI url
321 --yathui-user ARG
323 --yathui-user=ARG
324 --no-yathui-user
325 Username to attach to the data sent to the db
326 --yathui-db-buffering none
328 --yathui-db-buffering job
329 --yathui-db-buffering diag
330 --yathui-db-buffering run
331 --no-yathui-db-buffering
332 Type of buffering to use, if "none" then events are written to the
333 db one at a time, which is SLOW
334 --yathui-db-config ARG
336 --yathui-db-config=ARG
337 --no-yathui-db-config
338 Module that implements 'MODULE->yath_ui_config(%params)' which
339 should return a Test2::Harness::UI::Config instance.
340 --yathui-db-coverage
342 --no-yathui-db-coverage
343 Pull coverage data directly from the database (default: off)
344 --yathui-db-driver Pg
346 --yathui-db-drivermysql
347 --yathui-db-driverMariaDB
348 --no-yathui-db-driver
349 DBI Driver to use
350 --yathui-db-dsn ARG
352 --yathui-db-dsn=ARG
353 --no-yathui-db-dsn
354 DSN to use when connecting to the db
355 --yathui-db-duration-limit ARG
357 --yathui-db-duration-limit=ARG
358 --no-yathui-db-duration-limit
359 Limit the number of runs to look at for durations data (default:
360 10)
361 --yathui-db-durations
363 --no-yathui-db-durations
364 Pull duration data directly from the database (default: off)
365 --yathui-db-flush-interval 2
367 --yathui-db-flush-interval 1.5
368 --no-yathui-db-flush-interval
369 When buffering DB writes, force a flush when an event is recieved
370 at least N seconds after the last flush.
371 --yathui-db-host ARG
373 --yathui-db-host=ARG
374 --no-yathui-db-host
375 hostname to use when connecting to the db
376 --yathui-db-name ARG
378 --yathui-db-name=ARG
379 --no-yathui-db-name
380 Name of the database to use for yathui
381 --yathui-db-pass ARG
383 --yathui-db-pass=ARG
384 --no-yathui-db-pass
385 Password to use when connecting to the db
386 --yathui-db-port ARG
388 --yathui-db-port=ARG
389 --no-yathui-db-port
390 port to use when connecting to the db
391 --yathui-db-publisher ARG
393 --yathui-db-publisher=ARG
394 --no-yathui-db-publisher
395 When using coverage or duration data, only use data uploaded by
396 this user
397 --yathui-db-socket ARG
399 --yathui-db-socket=ARG
400 --no-yathui-db-socket
401 socket to use when connecting to the db
402 --yathui-db-user ARG
404 --yathui-db-user=ARG
405 --no-yathui-db-user
406 Username to use when connecting to the db
407
409 The source code repository for Test2-Harness can be found at
410 http://github.com/Test-More/Test2-Harness/.
411
413 Chad Granum <exodist@cpan.org>
414
416 Chad Granum <exodist@cpan.org>
417
419 Copyright 2023 Chad Granum <exodist7@gmail.com>.
420 This program is free software; you can redistribute it and/or modify it
422 under the same terms as Perl itself.
423 See http://dev.perl.org/licenses/
425perl v5.38.0 2023-10-04 App::Yath::Command::failed(3)