1App::Yath::Command::runUnseerr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Command::runner(3)
2
3
4

NAME

6       App::Yath::Command::runner - For internal use only
7

DESCRIPTION

9       No Description
10

USAGE

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

SOURCE

389       The source code repository for Test2-Harness can be found at
390       http://github.com/Test-More/Test2-Harness/.
391

MAINTAINERS

393       Chad Granum <exodist@cpan.org>
394

AUTHORS

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