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 YathUI Options
222 --yathui-api-key ARG
224 --yathui-api-key=ARG
225 --no-yathui-api-key
226 Yath-UI API key. This is not necessary if your Yath-UI instance is
227 set to single-user
228 --yathui-db
230 --no-yathui-db
231 Add the YathUI DB renderer in addition to other renderers
232 --yathui-grace
234 --no-yathui-grace
235 If yath cannot connect to yath-ui it normally throws an error, use
236 this to make it fail gracefully. You get a warning, but things keep
237 going.
238 --yathui-long-duration 10
240 --no-yathui-long-duration
241 Minimum duration length (seconds) before a test goes from MEDIUM to
242 LONG
243 --yathui-medium-duration 5
245 --no-yathui-medium-duration
246 Minimum duration length (seconds) before a test goes from SHORT to
247 MEDIUM
248 --yathui-mode summary
250 --yathui-mode qvf
251 --yathui-mode qvfd
252 --yathui-mode complete
253 --no-yathui-mode
254 Set the upload mode (default 'qvfd')
255 --yathui-only
257 --no-yathui-only
258 Only use the YathUI renderer
259 --yathui-only-db
261 --no-yathui-only-db
262 Only use the YathUI DB renderer
263 --yathui-port 8080
265 --no-yathui-port
266 Port to use when running a local server
267 --yathui-port-command get_port.sh
269 --yathui-port-command get_port.sh --pid $$
270 --no-yathui-port-command
271 Use a command to get a port number. "$$" will be replaced with the
272 PID of the yath process
273 --yathui-project ARG
275 --yathui-project=ARG
276 --no-yathui-project
277 The Yath-UI project for your test results
278 --yathui-render
280 --no-yathui-render
281 Add the YathUI renderer in addition to other renderers
282 --yathui-retry
284 --no-yathui-retry
285 How many times to try an operation before giving up
286 Can be specified multiple times
288 --yathui-schema PostgreSQL
290 --yathui-schema MySQL
291 --yathui-schema MySQL56
292 --no-yathui-schema
293 What type of DB/schema to use when using a temporary database
294 --yathui-url http://my-yath-ui.com/...
296 --uri http://my-yath-ui.com/...
297 --no-yathui-url
298 Yath-UI url
299 --yathui-user ARG
301 --yathui-user=ARG
302 --no-yathui-user
303 Username to attach to the data sent to the db
304 --yathui-db-buffering none
306 --yathui-db-buffering job
307 --yathui-db-buffering diag
308 --yathui-db-buffering run
309 --no-yathui-db-buffering
310 Type of buffering to use, if "none" then events are written to the
311 db one at a time, which is SLOW
312 --yathui-db-config ARG
314 --yathui-db-config=ARG
315 --no-yathui-db-config
316 Module that implements 'MODULE->yath_ui_config(%params)' which
317 should return a Test2::Harness::UI::Config instance.
318 --yathui-db-coverage
320 --no-yathui-db-coverage
321 Pull coverage data directly from the database (default: off)
322 --yathui-db-driver Pg
324 --yathui-db-drivermysql
325 --yathui-db-driverMariaDB
326 --no-yathui-db-driver
327 DBI Driver to use
328 --yathui-db-dsn ARG
330 --yathui-db-dsn=ARG
331 --no-yathui-db-dsn
332 DSN to use when connecting to the db
333 --yathui-db-durations
335 --no-yathui-db-durations
336 Pull duration data directly from the database (default: off)
337 --yathui-db-flush-interval 2
339 --yathui-db-flush-interval 1.5
340 --no-yathui-db-flush-interval
341 When buffering DB writes, force a flush when an event is recieved
342 at least N seconds after the last flush.
343 --yathui-db-host ARG
345 --yathui-db-host=ARG
346 --no-yathui-db-host
347 hostname to use when connecting to the db
348 --yathui-db-name ARG
350 --yathui-db-name=ARG
351 --no-yathui-db-name
352 Name of the database to use for yathui
353 --yathui-db-pass ARG
355 --yathui-db-pass=ARG
356 --no-yathui-db-pass
357 Password to use when connecting to the db
358 --yathui-db-port ARG
360 --yathui-db-port=ARG
361 --no-yathui-db-port
362 port to use when connecting to the db
363 --yathui-db-publisher ARG
365 --yathui-db-publisher=ARG
366 --no-yathui-db-publisher
367 When using coverage or duration data, only use data uploaded by
368 this user
369 --yathui-db-socket ARG
371 --yathui-db-socket=ARG
372 --no-yathui-db-socket
373 socket to use when connecting to the db
374 --yathui-db-user ARG
376 --yathui-db-user=ARG
377 --no-yathui-db-user
378 Username to use when connecting to the db
379
381 The source code repository for Test2-Harness can be found at
382 http://github.com/Test-More/Test2-Harness/.
383
385 Chad Granum <exodist@cpan.org>
386
388 Chad Granum <exodist@cpan.org>
389
391 Copyright 2021 Chad Granum <exodist7@gmail.com>.
392 This program is free software; you can redistribute it and/or modify it
394 under the same terms as Perl itself.
395 See http://dev.perl.org/licenses/
397perl v5.34.0 2021-11-05 App::Yath::Command::times(3)