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-resources
289       --yathui-resources=5
290       --no-yathui-resources
291           Send resource info (for supported resources) to yathui at the
292           specified interval in seconds (5 if not specified)
293
294       --yathui-retry
295       --no-yathui-retry
296           How many times to try an operation before giving up
297
298           Can be specified multiple times
299
300       --yathui-schema PostgreSQL
301       --yathui-schema MySQL
302       --yathui-schema MySQL56
303       --no-yathui-schema
304           What type of DB/schema to use when using a temporary database
305
306       --yathui-url http://my-yath-ui.com/...
307       --uri http://my-yath-ui.com/...
308       --no-yathui-url
309           Yath-UI url
310
311       --yathui-user ARG
312       --yathui-user=ARG
313       --no-yathui-user
314           Username to attach to the data sent to the db
315
316       --yathui-db-buffering none
317       --yathui-db-buffering job
318       --yathui-db-buffering diag
319       --yathui-db-buffering run
320       --no-yathui-db-buffering
321           Type of buffering to use, if "none" then events are written to the
322           db one at a time, which is SLOW
323
324       --yathui-db-config ARG
325       --yathui-db-config=ARG
326       --no-yathui-db-config
327           Module that implements 'MODULE->yath_ui_config(%params)' which
328           should return a Test2::Harness::UI::Config instance.
329
330       --yathui-db-coverage
331       --no-yathui-db-coverage
332           Pull coverage data directly from the database (default: off)
333
334       --yathui-db-driver Pg
335       --yathui-db-drivermysql
336       --yathui-db-driverMariaDB
337       --no-yathui-db-driver
338           DBI Driver to use
339
340       --yathui-db-dsn ARG
341       --yathui-db-dsn=ARG
342       --no-yathui-db-dsn
343           DSN to use when connecting to the db
344
345       --yathui-db-duration-limit ARG
346       --yathui-db-duration-limit=ARG
347       --no-yathui-db-duration-limit
348           Limit the number of runs to look at for durations data (default:
349           10)
350
351       --yathui-db-durations
352       --no-yathui-db-durations
353           Pull duration data directly from the database (default: off)
354
355       --yathui-db-flush-interval 2
356       --yathui-db-flush-interval 1.5
357       --no-yathui-db-flush-interval
358           When buffering DB writes, force a flush when an event is recieved
359           at least N seconds after the last flush.
360
361       --yathui-db-host ARG
362       --yathui-db-host=ARG
363       --no-yathui-db-host
364           hostname to use when connecting to the db
365
366       --yathui-db-name ARG
367       --yathui-db-name=ARG
368       --no-yathui-db-name
369           Name of the database to use for yathui
370
371       --yathui-db-pass ARG
372       --yathui-db-pass=ARG
373       --no-yathui-db-pass
374           Password to use when connecting to the db
375
376       --yathui-db-port ARG
377       --yathui-db-port=ARG
378       --no-yathui-db-port
379           port to use when connecting to the db
380
381       --yathui-db-publisher ARG
382       --yathui-db-publisher=ARG
383       --no-yathui-db-publisher
384           When using coverage or duration data, only use data uploaded by
385           this user
386
387       --yathui-db-socket ARG
388       --yathui-db-socket=ARG
389       --no-yathui-db-socket
390           socket to use when connecting to the db
391
392       --yathui-db-user ARG
393       --yathui-db-user=ARG
394       --no-yathui-db-user
395           Username to use when connecting to the db
396

SOURCE

398       The source code repository for Test2-Harness can be found at
399       http://github.com/Test-More/Test2-Harness/.
400

MAINTAINERS

402       Chad Granum <exodist@cpan.org>
403

AUTHORS

405       Chad Granum <exodist@cpan.org>
406
408       Copyright 2023 Chad Granum <exodist7@gmail.com>.
409
410       This program is free software; you can redistribute it and/or modify it
411       under the same terms as Perl itself.
412
413       See http://dev.perl.org/licenses/
414
415
416
417perl v5.36.1                      2023-10-04      App::Yath::Command::times(3)
Impressum