1App::Yath::Command::whiUcshe(r3)Contributed Perl DocumenAtpapt:i:oYnath::Command::which(3)
2
3
4

NAME

6       App::Yath::Command::which - Locate the persistent test runner
7

DESCRIPTION

9       This will tell you about any persistent runners it can find.
10

USAGE

12           $ yath [YATH OPTIONS] which [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 it 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-durations
337       --no-yathui-db-durations
338           Pull duration data directly from the database (default: off)
339
340       --yathui-db-flush-interval 2
341       --yathui-db-flush-interval 1.5
342       --no-yathui-db-flush-interval
343           When buffering DB writes, force a flush when an event is recieved
344           at least N seconds after the last flush.
345
346       --yathui-db-host ARG
347       --yathui-db-host=ARG
348       --no-yathui-db-host
349           hostname to use when connecting to the db
350
351       --yathui-db-name ARG
352       --yathui-db-name=ARG
353       --no-yathui-db-name
354           Name of the database to use for yathui
355
356       --yathui-db-pass ARG
357       --yathui-db-pass=ARG
358       --no-yathui-db-pass
359           Password to use when connecting to the db
360
361       --yathui-db-port ARG
362       --yathui-db-port=ARG
363       --no-yathui-db-port
364           port to use when connecting to the db
365
366       --yathui-db-publisher ARG
367       --yathui-db-publisher=ARG
368       --no-yathui-db-publisher
369           When using coverage or duration data, only use data uploaded by
370           this user
371
372       --yathui-db-socket ARG
373       --yathui-db-socket=ARG
374       --no-yathui-db-socket
375           socket to use when connecting to the db
376
377       --yathui-db-user ARG
378       --yathui-db-user=ARG
379       --no-yathui-db-user
380           Username to use when connecting to the db
381

SOURCE

383       The source code repository for Test2-Harness can be found at
384       http://github.com/Test-More/Test2-Harness/.
385

MAINTAINERS

387       Chad Granum <exodist@cpan.org>
388

AUTHORS

390       Chad Granum <exodist@cpan.org>
391
393       Copyright 2022 Chad Granum <exodist7@gmail.com>.
394
395       This program is free software; you can redistribute it and/or modify it
396       under the same terms as Perl itself.
397
398       See http://dev.perl.org/licenses/
399
400
401
402perl v5.34.1                      2022-07-11      App::Yath::Command::which(3)
Impressum