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 is 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-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 --yathui-retry
295 --no-yathui-retry
296 How many times to try an operation before giving up
297 Can be specified multiple times
299 --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 --yathui-url http://my-yath-ui.com/...
307 --uri http://my-yath-ui.com/...
308 --no-yathui-url
309 Yath-UI url
310 --yathui-user ARG
312 --yathui-user=ARG
313 --no-yathui-user
314 Username to attach to the data sent to the db
315 --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 --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 --yathui-db-coverage
331 --no-yathui-db-coverage
332 Pull coverage data directly from the database (default: off)
333 --yathui-db-driver Pg
335 --yathui-db-drivermysql
336 --yathui-db-driverMariaDB
337 --no-yathui-db-driver
338 DBI Driver to use
339 --yathui-db-dsn ARG
341 --yathui-db-dsn=ARG
342 --no-yathui-db-dsn
343 DSN to use when connecting to the db
344 --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 --yathui-db-durations
352 --no-yathui-db-durations
353 Pull duration data directly from the database (default: off)
354 --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 --yathui-db-host ARG
362 --yathui-db-host=ARG
363 --no-yathui-db-host
364 hostname to use when connecting to the db
365 --yathui-db-name ARG
367 --yathui-db-name=ARG
368 --no-yathui-db-name
369 Name of the database to use for yathui
370 --yathui-db-pass ARG
372 --yathui-db-pass=ARG
373 --no-yathui-db-pass
374 Password to use when connecting to the db
375 --yathui-db-port ARG
377 --yathui-db-port=ARG
378 --no-yathui-db-port
379 port to use when connecting to the db
380 --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 --yathui-db-socket ARG
388 --yathui-db-socket=ARG
389 --no-yathui-db-socket
390 socket to use when connecting to the db
391 --yathui-db-user ARG
393 --yathui-db-user=ARG
394 --no-yathui-db-user
395 Username to use when connecting to the db
396
398 The source code repository for Test2-Harness can be found at
399 http://github.com/Test-More/Test2-Harness/.
400
402 Chad Granum <exodist@cpan.org>
403
405 Chad Granum <exodist@cpan.org>
406
408 Copyright 2023 Chad Granum <exodist7@gmail.com>.
409 This program is free software; you can redistribute it and/or modify it
411 under the same terms as Perl itself.
412 See http://dev.perl.org/licenses/
414perl v5.38.0 2023-10-04 App::Yath::Command::times(3)