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

1App::Yath::Command::timUesse(r3)Contributed Perl DocumenAtpapt:i:oYnath::Command::times(3)
2
3
4

NAME

6       App::Yath::Command::times - Get times from a test log
7

DESCRIPTION

9       This command will consume the log of a previous run, and output all
10       timing data from shortest test to longest. You can specify a sort order
11       by listing fields in your desired order after the log file on the
12       command line.
13

USAGE

15           $ yath [YATH OPTIONS] times [COMMAND OPTIONS]
16
17   YATH OPTIONS
18       Developer
19
20       --dev-lib
21       --dev-lib=lib
22       -D
23       -D=lib
24       -Dlib
25       --no-dev-lib
26           Add paths to @INC before loading ANYTHING. This is what you use if
27           you are developing yath or yath plugins to make sure the yath
28           script finds the local code instead of the installed versions of
29           the same code. You can provide an argument (-Dfoo) to provide a
30           custom path, or you can just use -D without and arg to add lib,
31           blib/lib and blib/arch.
32
33           Can be specified multiple times
34
35       Environment
36
37       --persist-dir ARG
38       --persist-dir=ARG
39       --no-persist-dir
40           Where to find persistence files.
41
42       --persist-file ARG
43       --persist-file=ARG
44       --pfile ARG
45       --pfile=ARG
46       --no-persist-file
47           Where to find the persistence file. The default is
48           /{system-tempdir}/project-yath-persist.json. If no project is
49           specified then it will fall back to the current directory. If the
50           current directory is not writable it will default to
51           /tmp/yath-persist.json which limits you to one persistent runner on
52           your system.
53
54       --project ARG
55       --project=ARG
56       --project-name ARG
57       --project-name=ARG
58       --no-project
59           This lets you provide a label for your current project/codebase.
60           This is best used in a .yath.rc file. This is necessary for a
61           persistent runner.
62
63       Help and Debugging
64
65       --show-opts
66       --no-show-opts
67           Exit after showing what yath thinks your options mean
68
69       --version
70       -V
71       --no-version
72           Exit after showing a helpful usage message
73
74       Plugins
75
76       --no-scan-plugins
77       --no-no-scan-plugins
78           Normally yath scans for and loads all App::Yath::Plugin::* modules
79           in order to bring in command-line options they may provide. This
80           flag will disable that. This is useful if you have a naughty plugin
81           that is loading other modules when it should not.
82
83       --plugins PLUGIN
84       --plugins +App::Yath::Plugin::PLUGIN
85       --plugins PLUGIN=arg1,arg2,...
86       --plugin PLUGIN
87       --plugin +App::Yath::Plugin::PLUGIN
88       --plugin PLUGIN=arg1,arg2,...
89       -pPLUGIN
90       --no-plugins
91           Load a yath plugin.
92
93           Can be specified multiple times
94
95   COMMAND OPTIONS
96       Cover Options
97
98       --cover-aggregator ByTest
99       --cover-aggregator ByRun
100       --cover-aggregator +Custom::Aggregator
101       --cover-agg ByTest
102       --cover-agg ByRun
103       --cover-agg +Custom::Aggregator
104       --no-cover-aggregator
105           Choose a custom aggregator subclass
106
107       --cover-class ARG
108       --cover-class=ARG
109       --no-cover-class
110           Choose a Test2::Plugin::Cover subclass
111
112       --cover-dirs ARG
113       --cover-dirs=ARG
114       --cover-dir ARG
115       --cover-dir=ARG
116       --no-cover-dirs
117           NO DESCRIPTION - FIX ME
118
119           Can be specified multiple times
120
121       --cover-exclude-private
122       --no-cover-exclude-private
123       --cover-files
124       --no-cover-files
125           Use Test2::Plugin::Cover to collect coverage data for what files
126           are touched by what tests. Unlike Devel::Cover this has very little
127           performance impact (About 4% difference)
128
129       --cover-from path/to/log.jsonl
130       --cover-from http://example.com/coverage
131       --cover-from path/to/coverage.jsonl
132       --no-cover-from
133           This can be a test log, a coverage dump (old style json or new
134           jsonl format), or a url to any of the previous. Tests will not be
135           run if the file/url is invalid.
136
137       --cover-from-type json
138       --cover-from-type jsonl
139       --cover-from-type log
140       --no-cover-from-type
141           File type for coverage source. Usually it can be detected, but when
142           it cannot be you should specify. "json" is old style single-blob
143           coverage data, "jsonl" is the new by-test style, "log" is a logfile
144           from a previous run.
145
146       --cover-manager My::Coverage::Manager
147       --no-cover-manager
148           Coverage 'from' manager to use when coverage data does not provide
149           one
150
151       --cover-maybe-from path/to/log.jsonl
152       --cover-maybe-from http://example.com/coverage
153       --cover-maybe-from path/to/coverage.jsonl
154       --no-cover-maybe-from
155           This can be a test log, a coverage dump (old style json or new
156           jsonl format), or a url to any of the previous. Tests will coninue
157           if even if the coverage file/url is invalid.
158
159       --cover-maybe-from-type json
160       --cover-maybe-from-type jsonl
161       --cover-maybe-from-type log
162       --no-cover-maybe-from-type
163           Same as "from_type" but for "maybe_from". Defaults to "from_type"
164           if that is specified, otherwise auto-detect
165
166       --cover-metrics
167       --no-cover-metrics
168       --cover-types ARG
169       --cover-types=ARG
170       --cover-type ARG
171       --cover-type=ARG
172       --no-cover-types
173           NO DESCRIPTION - FIX ME
174
175           Can be specified multiple times
176
177       --cover-write
178       --cover-write=coverage.jsonl
179       --cover-write=coverage.json
180       --no-cover-write
181           Create a json or jsonl file of all coverage data seen during the
182           run (This implies --cover-files).
183
184       Git Options
185
186       --git-change-base master
187       --git-change-base HEAD^
188       --git-change-base df22abe4
189       --no-git-change-base
190           Find files changed by all commits in the current branch from most
191           recent stopping when a commit is found that is also present in the
192           history of the branch/commit specified as the change base.
193
194       Help and Debugging
195
196       --dummy
197       -d
198       --no-dummy
199           Dummy run, do not actually execute anything
200
201           Can also be set with the following environment variables:
202           "T2_HARNESS_DUMMY"
203
204       --help
205       -h
206       --no-help
207           exit after showing help information
208
209       --interactive
210       -i
211       --no-interactive
212           Use interactive mode, 1 test at a time, stdin forwarded to it
213
214       --keep-dirs
215       --keep_dir
216       -k
217       --no-keep-dirs
218           Do not delete directories when done. This is useful if you want to
219           inspect the directories used for various commands.
220
221       --procname-prefix ARG
222       --procname-prefix=ARG
223       --no-procname-prefix
224           Add a prefix to all proc names (as seen by ps).
225
226       YathUI Options
227
228       --yathui-api-key ARG
229       --yathui-api-key=ARG
230       --no-yathui-api-key
231           Yath-UI API key. This is not necessary if your Yath-UI instance is
232           set to single-user
233
234       --yathui-db
235       --no-yathui-db
236           Add the YathUI DB renderer in addition to other renderers
237
238       --yathui-grace
239       --no-yathui-grace
240           If yath cannot connect to yath-ui it normally throws an error, use
241           this to make it fail gracefully. You get a warning, but things keep
242           going.
243
244       --yathui-long-duration 10
245       --no-yathui-long-duration
246           Minimum duration length (seconds) before a test goes from MEDIUM to
247           LONG
248
249       --yathui-medium-duration 5
250       --no-yathui-medium-duration
251           Minimum duration length (seconds) before a test goes from SHORT to
252           MEDIUM
253
254       --yathui-mode summary
255       --yathui-mode qvf
256       --yathui-mode qvfd
257       --yathui-mode complete
258       --no-yathui-mode
259           Set the upload mode (default 'qvfd')
260
261       --yathui-only
262       --no-yathui-only
263           Only use the YathUI renderer
264
265       --yathui-only-db
266       --no-yathui-only-db
267           Only use the YathUI DB renderer
268
269       --yathui-port 8080
270       --no-yathui-port
271           Port to use when running a local server
272
273       --yathui-port-command get_port.sh
274       --yathui-port-command get_port.sh --pid $$
275       --no-yathui-port-command
276           Use a command to get a port number. "$$" will be replaced with the
277           PID of the yath process
278
279       --yathui-project ARG
280       --yathui-project=ARG
281       --no-yathui-project
282           The Yath-UI project for your test results
283
284       --yathui-render
285       --no-yathui-render
286           Add the YathUI renderer in addition to other renderers
287
288       --yathui-retry
289       --no-yathui-retry
290           How many times to try an operation before giving up
291
292           Can be specified multiple times
293
294       --yathui-schema PostgreSQL
295       --yathui-schema MySQL
296       --yathui-schema MySQL56
297       --no-yathui-schema
298           What type of DB/schema to use when using a temporary database
299
300       --yathui-url http://my-yath-ui.com/...
301       --uri http://my-yath-ui.com/...
302       --no-yathui-url
303           Yath-UI url
304
305       --yathui-user ARG
306       --yathui-user=ARG
307       --no-yathui-user
308           Username to attach to the data sent to the db
309
310       --yathui-db-buffering none
311       --yathui-db-buffering job
312       --yathui-db-buffering diag
313       --yathui-db-buffering run
314       --no-yathui-db-buffering
315           Type of buffering to use, if "none" then events are written to the
316           db one at a time, which is SLOW
317
318       --yathui-db-config ARG
319       --yathui-db-config=ARG
320       --no-yathui-db-config
321           Module that implements 'MODULE->yath_ui_config(%params)' which
322           should return a Test2::Harness::UI::Config instance.
323
324       --yathui-db-coverage
325       --no-yathui-db-coverage
326           Pull coverage data directly from the database (default: off)
327
328       --yathui-db-driver Pg
329       --yathui-db-drivermysql
330       --yathui-db-driverMariaDB
331       --no-yathui-db-driver
332           DBI Driver to use
333
334       --yathui-db-dsn ARG
335       --yathui-db-dsn=ARG
336       --no-yathui-db-dsn
337           DSN to use when connecting to the db
338
339       --yathui-db-duration-limit ARG
340       --yathui-db-duration-limit=ARG
341       --no-yathui-db-duration-limit
342           Limit the number of runs to look at for durations data (default:
343           10)
344
345       --yathui-db-durations
346       --no-yathui-db-durations
347           Pull duration data directly from the database (default: off)
348
349       --yathui-db-flush-interval 2
350       --yathui-db-flush-interval 1.5
351       --no-yathui-db-flush-interval
352           When buffering DB writes, force a flush when an event is recieved
353           at least N seconds after the last flush.
354
355       --yathui-db-host ARG
356       --yathui-db-host=ARG
357       --no-yathui-db-host
358           hostname to use when connecting to the db
359
360       --yathui-db-name ARG
361       --yathui-db-name=ARG
362       --no-yathui-db-name
363           Name of the database to use for yathui
364
365       --yathui-db-pass ARG
366       --yathui-db-pass=ARG
367       --no-yathui-db-pass
368           Password to use when connecting to the db
369
370       --yathui-db-port ARG
371       --yathui-db-port=ARG
372       --no-yathui-db-port
373           port to use when connecting to the db
374
375       --yathui-db-publisher ARG
376       --yathui-db-publisher=ARG
377       --no-yathui-db-publisher
378           When using coverage or duration data, only use data uploaded by
379           this user
380
381       --yathui-db-socket ARG
382       --yathui-db-socket=ARG
383       --no-yathui-db-socket
384           socket to use when connecting to the db
385
386       --yathui-db-user ARG
387       --yathui-db-user=ARG
388       --no-yathui-db-user
389           Username to use when connecting to the db
390

SOURCE

392       The source code repository for Test2-Harness can be found at
393       http://github.com/Test-More/Test2-Harness/.
394

MAINTAINERS

396       Chad Granum <exodist@cpan.org>
397

AUTHORS

399       Chad Granum <exodist@cpan.org>
400

COPYRIGHT

402       Copyright 2022 Chad Granum <exodist7@gmail.com>.
403
404       This program is free software; you can redistribute it and/or modify it
405       under the same terms as Perl itself.
406
407       See http://dev.perl.org/licenses/
408
409
410
411perl v5.36.0                      2022-09-08      App::Yath::Command::times(3)