1App::Yath::Command::timUesse(r3)Contributed Perl DocumenAtpapt:i:oYnath::Command::times(3)
2
6 App::Yath::Command::times - Get times from a test log
7
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
15 $ yath [YATH OPTIONS] times [COMMAND OPTIONS]
16 YATH OPTIONS
18 Developer
19 --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 Can be specified multiple times
34 Environment
36 --persist-dir ARG
38 --persist-dir=ARG
39 --no-persist-dir
40 Where to find persistence files.
41 --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 --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 Help and Debugging
64 --show-opts
66 --no-show-opts
67 Exit after showing what yath thinks your options mean
68 --version
70 -V
71 --no-version
72 Exit after showing a helpful usage message
73 Plugins
75 --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 it loading other modules when it should not.
82 --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 Can be specified multiple times
94 COMMAND OPTIONS
96 Cover Options
97 --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 --cover-class ARG
108 --cover-class=ARG
109 --no-cover-class
110 Choose a Test2::Plugin::Cover subclass
111 --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 Can be specified multiple times
120 --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 --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 --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 --cover-manager My::Coverage::Manager
147 --no-cover-manager
148 Coverage 'from' manager to use when coverage data does not provide
149 one
150 --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 --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 --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 Can be specified multiple times
176 --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 Git Options
185 --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 Help and Debugging
195 --dummy
197 -d
198 --no-dummy
199 Dummy run, do not actually execute anything
200 Can also be set with the following environment variables:
202 "T2_HARNESS_DUMMY"
203 --help
205 -h
206 --no-help
207 exit after showing help information
208 --interactive
210 -i
211 --no-interactive
212 Use interactive mode, 1 test at a time, stdin forwarded to it
213 --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 --procname-prefix ARG
222 --procname-prefix=ARG
223 --no-procname-prefix
224 Add a prefix to all proc names (as seen by ps).
225 YathUI Options
227 --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 --yathui-db
235 --no-yathui-db
236 Add the YathUI DB renderer in addition to other renderers
237 --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 --yathui-long-duration 10
245 --no-yathui-long-duration
246 Minimum duration length (seconds) before a test goes from MEDIUM to
247 LONG
248 --yathui-medium-duration 5
250 --no-yathui-medium-duration
251 Minimum duration length (seconds) before a test goes from SHORT to
252 MEDIUM
253 --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 --yathui-only
262 --no-yathui-only
263 Only use the YathUI renderer
264 --yathui-only-db
266 --no-yathui-only-db
267 Only use the YathUI DB renderer
268 --yathui-port 8080
270 --no-yathui-port
271 Port to use when running a local server
272 --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 --yathui-project ARG
280 --yathui-project=ARG
281 --no-yathui-project
282 The Yath-UI project for your test results
283 --yathui-render
285 --no-yathui-render
286 Add the YathUI renderer in addition to other renderers
287 --yathui-retry
289 --no-yathui-retry
290 How many times to try an operation before giving up
291 Can be specified multiple times
293 --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 --yathui-url http://my-yath-ui.com/...
301 --uri http://my-yath-ui.com/...
302 --no-yathui-url
303 Yath-UI url
304 --yathui-user ARG
306 --yathui-user=ARG
307 --no-yathui-user
308 Username to attach to the data sent to the db
309 --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 --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 --yathui-db-coverage
325 --no-yathui-db-coverage
326 Pull coverage data directly from the database (default: off)
327 --yathui-db-driver Pg
329 --yathui-db-drivermysql
330 --yathui-db-driverMariaDB
331 --no-yathui-db-driver
332 DBI Driver to use
333 --yathui-db-dsn ARG
335 --yathui-db-dsn=ARG
336 --no-yathui-db-dsn
337 DSN to use when connecting to the db
338 --yathui-db-durations
340 --no-yathui-db-durations
341 Pull duration data directly from the database (default: off)
342 --yathui-db-flush-interval 2
344 --yathui-db-flush-interval 1.5
345 --no-yathui-db-flush-interval
346 When buffering DB writes, force a flush when an event is recieved
347 at least N seconds after the last flush.
348 --yathui-db-host ARG
350 --yathui-db-host=ARG
351 --no-yathui-db-host
352 hostname to use when connecting to the db
353 --yathui-db-name ARG
355 --yathui-db-name=ARG
356 --no-yathui-db-name
357 Name of the database to use for yathui
358 --yathui-db-pass ARG
360 --yathui-db-pass=ARG
361 --no-yathui-db-pass
362 Password to use when connecting to the db
363 --yathui-db-port ARG
365 --yathui-db-port=ARG
366 --no-yathui-db-port
367 port to use when connecting to the db
368 --yathui-db-publisher ARG
370 --yathui-db-publisher=ARG
371 --no-yathui-db-publisher
372 When using coverage or duration data, only use data uploaded by
373 this user
374 --yathui-db-socket ARG
376 --yathui-db-socket=ARG
377 --no-yathui-db-socket
378 socket to use when connecting to the db
379 --yathui-db-user ARG
381 --yathui-db-user=ARG
382 --no-yathui-db-user
383 Username to use when connecting to the db
384
386 The source code repository for Test2-Harness can be found at
387 http://github.com/Test-More/Test2-Harness/.
388
390 Chad Granum <exodist@cpan.org>
391
393 Chad Granum <exodist@cpan.org>
394
396 Copyright 2022 Chad Granum <exodist7@gmail.com>.
397 This program is free software; you can redistribute it and/or modify it
399 under the same terms as Perl itself.
400 See http://dev.perl.org/licenses/
402perl v5.34.1 2022-07-11 App::Yath::Command::times(3)