1App::Yath::Command::runU(s3e)r Contributed Perl DocumentaAtpipo:n:Yath::Command::run(3)
2
3
4
6 App::Yath::Command::run - Run tests using the persistent test runner
7
9 This command will run tests through an already started persistent
10 instance. See the start command for details on how to launch a
11 persistant instance.
12
14 $ yath [YATH OPTIONS] run [COMMAND OPTIONS]
15
16 YATH OPTIONS
17 Developer
18
19 --dev-lib
20 --dev-lib=lib
21 -D
22 -D=lib
23 -Dlib
24 --no-dev-lib
25 Add paths to @INC before loading ANYTHING. This is what you use if
26 you are developing yath or yath plugins to make sure the yath
27 script finds the local code instead of the installed versions of
28 the same code. You can provide an argument (-Dfoo) to provide a
29 custom path, or you can just use -D without and arg to add lib,
30 blib/lib and blib/arch.
31
32 Can be specified multiple times
33
34 Environment
35
36 --persist-dir ARG
37 --persist-dir=ARG
38 --no-persist-dir
39 Where to find persistence files.
40
41 --persist-file ARG
42 --persist-file=ARG
43 --pfile ARG
44 --pfile=ARG
45 --no-persist-file
46 Where to find the persistence file. The default is
47 /{system-tempdir}/project-yath-persist.json. If no project is
48 specified then it will fall back to the current directory. If the
49 current directory is not writable it will default to
50 /tmp/yath-persist.json which limits you to one persistent runner on
51 your system.
52
53 --project ARG
54 --project=ARG
55 --project-name ARG
56 --project-name=ARG
57 --no-project
58 This lets you provide a label for your current project/codebase.
59 This is best used in a .yath.rc file. This is necessary for a
60 persistent runner.
61
62 Finder Options
63
64 --finder MyFinder
65 --finder +Test2::Harness::Finder::MyFinder
66 --no-finder
67 Specify what Finder subclass to use when searching for
68 files/processing the file list. Use the "+" prefix to specify a
69 fully qualified namespace, otherwise Test2::Harness::Finder::XXX
70 namespace is assumed.
71
72 Help and Debugging
73
74 --show-opts
75 --no-show-opts
76 Exit after showing what yath thinks your options mean
77
78 --version
79 -V
80 --no-version
81 Exit after showing a helpful usage message
82
83 Plugins
84
85 --no-scan-plugins
86 --no-no-scan-plugins
87 Normally yath scans for and loads all App::Yath::Plugin::* modules
88 in order to bring in command-line options they may provide. This
89 flag will disable that. This is useful if you have a naughty plugin
90 that is loading other modules when it should not.
91
92 --plugins PLUGIN
93 --plugins +App::Yath::Plugin::PLUGIN
94 --plugins PLUGIN=arg1,arg2,...
95 --plugin PLUGIN
96 --plugin +App::Yath::Plugin::PLUGIN
97 --plugin PLUGIN=arg1,arg2,...
98 -pPLUGIN
99 --no-plugins
100 Load a yath plugin.
101
102 Can be specified multiple times
103
104 COMMAND OPTIONS
105 Cover Options
106
107 --cover-aggregator ByTest
108 --cover-aggregator ByRun
109 --cover-aggregator +Custom::Aggregator
110 --cover-agg ByTest
111 --cover-agg ByRun
112 --cover-agg +Custom::Aggregator
113 --no-cover-aggregator
114 Choose a custom aggregator subclass
115
116 --cover-class ARG
117 --cover-class=ARG
118 --no-cover-class
119 Choose a Test2::Plugin::Cover subclass
120
121 --cover-dirs ARG
122 --cover-dirs=ARG
123 --cover-dir ARG
124 --cover-dir=ARG
125 --no-cover-dirs
126 NO DESCRIPTION - FIX ME
127
128 Can be specified multiple times
129
130 --cover-exclude-private
131 --no-cover-exclude-private
132 --cover-files
133 --no-cover-files
134 Use Test2::Plugin::Cover to collect coverage data for what files
135 are touched by what tests. Unlike Devel::Cover this has very little
136 performance impact (About 4% difference)
137
138 --cover-from path/to/log.jsonl
139 --cover-from http://example.com/coverage
140 --cover-from path/to/coverage.jsonl
141 --no-cover-from
142 This can be a test log, a coverage dump (old style json or new
143 jsonl format), or a url to any of the previous. Tests will not be
144 run if the file/url is invalid.
145
146 --cover-from-type json
147 --cover-from-type jsonl
148 --cover-from-type log
149 --no-cover-from-type
150 File type for coverage source. Usually it can be detected, but when
151 it cannot be you should specify. "json" is old style single-blob
152 coverage data, "jsonl" is the new by-test style, "log" is a logfile
153 from a previous run.
154
155 --cover-manager My::Coverage::Manager
156 --no-cover-manager
157 Coverage 'from' manager to use when coverage data does not provide
158 one
159
160 --cover-maybe-from path/to/log.jsonl
161 --cover-maybe-from http://example.com/coverage
162 --cover-maybe-from path/to/coverage.jsonl
163 --no-cover-maybe-from
164 This can be a test log, a coverage dump (old style json or new
165 jsonl format), or a url to any of the previous. Tests will coninue
166 if even if the coverage file/url is invalid.
167
168 --cover-maybe-from-type json
169 --cover-maybe-from-type jsonl
170 --cover-maybe-from-type log
171 --no-cover-maybe-from-type
172 Same as "from_type" but for "maybe_from". Defaults to "from_type"
173 if that is specified, otherwise auto-detect
174
175 --cover-metrics
176 --no-cover-metrics
177 --cover-types ARG
178 --cover-types=ARG
179 --cover-type ARG
180 --cover-type=ARG
181 --no-cover-types
182 NO DESCRIPTION - FIX ME
183
184 Can be specified multiple times
185
186 --cover-write
187 --cover-write=coverage.jsonl
188 --cover-write=coverage.json
189 --no-cover-write
190 Create a json or jsonl file of all coverage data seen during the
191 run (This implies --cover-files).
192
193 Display Options
194
195 --color
196 --no-color
197 Turn color on, default is true if STDOUT is a TTY.
198
199 --hide-runner-output
200 --no-hide-runner-output
201 Hide output from the runner, showing only test output. (See Also
202 truncate_runner_output)
203
204 --no-wrap
205 --no-no-wrap
206 Do not do fancy text-wrapping, let the terminal handle it
207
208 --progress
209 --no-progress
210 Toggle progress indicators. On by default if STDOUT is a TTY. You
211 can use --no-progress to disable the 'events seen' counter and
212 buffered event pre-display
213
214 --quiet
215 -q
216 --no-quiet
217 Be very quiet.
218
219 Can be specified multiple times
220
221 --renderers +My::Renderer
222 --renderers Renderer=arg1,arg2,...
223 --renderer +My::Renderer
224 --renderer Renderer=arg1,arg2,...
225 --no-renderers
226 Specify renderers, (Default: "Formatter=Test2"). Use "+" to give a
227 fully qualified module name. Without "+"
228 "Test2::Harness::Renderer::" will be prepended to your argument.
229
230 Can be specified multiple times. If the same key is listed multiple
231 times the value lists will be appended together.
232
233 --show-times
234 -T
235 --no-show-times
236 Show the timing data for each job
237
238 --term-width 80
239 --term-width 200
240 --term-size 80
241 --term-size 200
242 --no-term-width
243 Alternative to setting $TABLE_TERM_SIZE. Setting this will override
244 the terminal width detection to the number of characters specified.
245
246 --truncate-runner-output
247 --no-truncate-runner-output
248 Only show runner output that was generated after the current
249 command. This is only useful with a persistent runner.
250
251 --verbose
252 -v
253 --no-verbose
254 Be more verbose
255
256 Can be specified multiple times
257
258 Finder Options
259
260 --changed path/to/file
261 --no-changed
262 Specify one or more files as having been changed.
263
264 Can be specified multiple times
265
266 --changed-only
267 --no-changed-only
268 Only search for tests for changed files (Requires a coverage data
269 source, also requires a list of changes either from the --changed
270 option, or a plugin that implements changed_files() or
271 changed_diff())
272
273 --changes-diff path/to/diff.diff
274 --no-changes-diff
275 Path to a diff file that should be used to find changed files for
276 use with --changed-only. This must be in the same format as `git
277 diff -W --minimal -U1000000`
278
279 --changes-exclude-file path/to/file
280 --no-changes-exclude-file
281 Specify one or more files to ignore when looking at changes
282
283 Can be specified multiple times
284
285 --changes-exclude-loads
286 --no-changes-exclude-loads
287 Exclude coverage tests which only load changed files, but never
288 call code from them. (default: off)
289
290 --changes-exclude-nonsub
291 --no-changes-exclude-nonsub
292 Exclude changes outside of subroutines (perl files only) (default:
293 off)
294
295 --changes-exclude-opens
296 --no-changes-exclude-opens
297 Exclude coverage tests which only open() changed files, but never
298 call code from them. (default: off)
299
300 --changes-exclude-pattern '(apple|pear|orange)'
301 --no-changes-exclude-pattern
302 Ignore files matching this pattern when looking for changes. Your
303 pattern will be inserted unmodified into a `$file =~ m/$pattern/`
304 check.
305
306 Can be specified multiple times
307
308 --changes-filter-file path/to/file
309 --no-changes-filter-file
310 Specify one or more files to check for changes. Changes to other
311 files will be ignored
312
313 Can be specified multiple times
314
315 --changes-filter-pattern '(apple|pear|orange)'
316 --no-changes-filter-pattern
317 Specify a pattern for change checking. When only running tests for
318 changed files this will limit which files are checked for changes.
319 Only files that match this pattern will be checked. Your pattern
320 will be inserted unmodified into a `$file =~ m/$pattern/` check.
321
322 Can be specified multiple times
323
324 --changes-include-whitespace
325 --no-changes-include-whitespace
326 Include changed lines that are whitespace only (default: off)
327
328 --changes-plugin Git
329 --changes-plugin +App::Yath::Plugin::Git
330 --no-changes-plugin
331 What plugin should be used to detect changed files.
332
333 --default-at-search ARG
334 --default-at-search=ARG
335 --no-default-at-search
336 Specify the default file/dir search when 'AUTHOR_TESTING' is set.
337 Defaults to './xt'. The default AT search is only used if no files
338 were specified at the command line
339
340 Can be specified multiple times
341
342 --default-search ARG
343 --default-search=ARG
344 --no-default-search
345 Specify the default file/dir search. defaults to './t', './t2', and
346 'test.pl'. The default search is only used if no files were
347 specified at the command line
348
349 Can be specified multiple times
350
351 --durations file.json
352 --durations http://example.com/durations.json
353 --no-durations
354 Point at a json file or url which has a hash of relative test
355 filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This
356 will override durations listed in the file headers. An exception
357 will be thrown if the durations file or url does not work.
358
359 --durations-threshold ARG
360 --durations-threshold=ARG
361 --Dt ARG
362 --Dt=ARG
363 --no-durations-threshold
364 Only fetch duration data if running at least this number of tests.
365 Default (-j value + 1)
366
367 --exclude-file t/nope.t
368 --no-exclude-file
369 Exclude a file from testing
370
371 Can be specified multiple times
372
373 --exclude-list file.txt
374 --exclude-list http://example.com/exclusions.txt
375 --no-exclude-list
376 Point at a file or url which has a new line separated list of test
377 file names to exclude from testing. Starting a line with a '#' will
378 comment it out (for compatibility with Test2::Aggregate list
379 files).
380
381 Can be specified multiple times
382
383 --exclude-pattern t/nope.t
384 --no-exclude-pattern
385 Exclude a pattern from testing, matched using m/$PATTERN/
386
387 Can be specified multiple times
388
389 --extension ARG
390 --extension=ARG
391 --ext ARG
392 --ext=ARG
393 --no-extension
394 Specify valid test filename extensions, default: t and t2
395
396 Can be specified multiple times
397
398 --maybe-durations file.json
399 --maybe-durations http://example.com/durations.json
400 --no-maybe-durations
401 Point at a json file or url which has a hash of relative test
402 filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This
403 will override durations listed in the file headers. An exception
404 will be thrown if the durations file or url does not work.
405
406 --no-long
407 --no-no-long
408 Do not run tests that have their duration flag set to 'LONG'
409
410 --only-long
411 --no-only-long
412 Only run tests that have their duration flag set to 'LONG'
413
414 --rerun
415 --rerun=path/to/log.jsonl
416 --rerun=plugin_specific_string
417 --no-rerun
418 Re-Run tests from a previous run from a log file (or last log
419 file). Plugins can intercept this, such as YathUIDB which will grab
420 a run UUID and derive tests to re-run from that.
421
422 --rerun-failed
423 --rerun-failed=path/to/log.jsonl
424 --rerun-failed=plugin_specific_string
425 --no-rerun-failed
426 Re-Run failed tests from a previous run from a log file (or last
427 log file). Plugins can intercept this, such as YathUIDB which will
428 grab a run UUID and derive tests to re-run from that.
429
430 --rerun-plugin Foo
431 --rerun-plugin +App::Yath::Plugin::Foo
432 --no-rerun-plugin
433 What plugin(s) should be used for rerun (will fallback to other
434 plugins if the listed ones decline the value, this is just used ot
435 set an order of priority)
436
437 Can be specified multiple times
438
439 --search ARG
440 --search=ARG
441 --no-search
442 List of tests and test directories to use instead of the default
443 search paths. Typically these can simply be listed as command line
444 arguments without the --search prefix.
445
446 Can be specified multiple times
447
448 --show-changed-files
449 --no-show-changed-files
450 Print a list of changed files if any are found
451
452 Formatter Options
453
454 --formatter ARG
455 --formatter=ARG
456 --no-formatter
457 NO DESCRIPTION - FIX ME
458
459 --qvf
460 --no-qvf
461 [Q]uiet, but [V]erbose on [F]ailure. Hide all output from tests
462 when they pass, except to say they passed. If a test fails then ALL
463 output from the test is verbosely output.
464
465 --show-job-end
466 --no-show-job-end
467 Show output when a job ends. (Default: on)
468
469 --show-job-info
470 --no-show-job-info
471 Show the job configuration when a job starts. (Default: off, unless
472 -vv)
473
474 --show-job-launch
475 --no-show-job-launch
476 Show output for the start of a job. (Default: off unless -v)
477
478 --show-run-info
479 --no-show-run-info
480 Show the run configuration when a run starts. (Default: off, unless
481 -vv)
482
483 Git Options
484
485 --git-change-base master
486 --git-change-base HEAD^
487 --git-change-base df22abe4
488 --no-git-change-base
489 Find files changed by all commits in the current branch from most
490 recent stopping when a commit is found that is also present in the
491 history of the branch/commit specified as the change base.
492
493 Help and Debugging
494
495 --dummy
496 -d
497 --no-dummy
498 Dummy run, do not actually execute anything
499
500 Can also be set with the following environment variables:
501 "T2_HARNESS_DUMMY"
502
503 --help
504 -h
505 --no-help
506 exit after showing help information
507
508 --interactive
509 -i
510 --no-interactive
511 Use interactive mode, 1 test at a time, stdin forwarded to it
512
513 --keep-dirs
514 --keep_dir
515 -k
516 --no-keep-dirs
517 Do not delete directories when done. This is useful if you want to
518 inspect the directories used for various commands.
519
520 --procname-prefix ARG
521 --procname-prefix=ARG
522 --no-procname-prefix
523 Add a prefix to all proc names (as seen by ps).
524
525 --summary
526 --summary=/path/to/summary.json
527 --no-summary
528 Write out a summary json file, if no path is provided
529 'summary.json' will be used. The .json extension is added
530 automatically if omitted.
531
532 Logging Options
533
534 --bzip2
535 --bz2
536 --bzip2_log
537 -B
538 --no-bzip2
539 Use bzip2 compression when writing the log. This option implies -L.
540 The .bz2 prefix is added to log file name for you
541
542 --gzip
543 --gz
544 --gzip_log
545 -G
546 --no-gzip
547 Use gzip compression when writing the log. This option implies -L.
548 The .gz prefix is added to log file name for you
549
550 --log
551 -L
552 --no-log
553 Turn on logging
554
555 --log-dir ARG
556 --log-dir=ARG
557 --no-log-dir
558 Specify a log directory. Will fall back to the system temp dir.
559
560 --log-file ARG
561 --log-file=ARG
562 -F ARG
563 -F=ARG
564 --no-log-file
565 Specify the name of the log file. This option implies -L.
566
567 --log-file-format ARG
568 --log-file-format=ARG
569 --lff ARG
570 --lff=ARG
571 --no-log-file-format
572 Specify the format for automatically-generated log files.
573 Overridden by --log-file, if given. This option implies -L
574 (Default: \$YATH_LOG_FILE_FORMAT, if that is set, or else
575 "%!P%Y-%m-%d~%H:%M:%S~%!U~%!p.jsonl"). This is a string in which
576 percent-escape sequences will be replaced as per POSIX::strftime.
577 The following special escape sequences are also replaced: (%!P :
578 Project name followed by a ~, if a project is defined, otherwise
579 empty string) (%!U : the unique test run ID) (%!p : the process ID)
580 (%!S : the number of seconds since local midnight UTC)
581
582 Can also be set with the following environment variables:
583 "YATH_LOG_FILE_FORMAT", "TEST2_HARNESS_LOG_FORMAT"
584
585 Notification Options
586
587 --notify-email foo@example.com
588 --no-notify-email
589 Email the test results to the specified email address(es)
590
591 Can be specified multiple times
592
593 --notify-email-fail foo@example.com
594 --no-notify-email-fail
595 Email failing results to the specified email address(es)
596
597 Can be specified multiple times
598
599 --notify-email-from foo@example.com
600 --no-notify-email-from
601 If any email is sent, this is who it will be from
602
603 --notify-email-owner
604 --no-notify-email-owner
605 Email the owner of broken tests files upon failure. Add `# HARNESS-
606 META-OWNER foo@example.com` to the top of a test file to give it an
607 owner
608
609 --notify-no-batch-email
610 --no-notify-no-batch-email
611 Usually owner failures are sent as a single batch at the end of
612 testing. Toggle this to send failures as they happen.
613
614 --notify-no-batch-slack
615 --no-notify-no-batch-slack
616 Usually owner failures are sent as a single batch at the end of
617 testing. Toggle this to send failures as they happen.
618
619 --notify-slack '#foo'
620 --notify-slack '@bar'
621 --no-notify-slack
622 Send results to a slack channel and/or user
623
624 Can be specified multiple times
625
626 --notify-slack-fail '#foo'
627 --notify-slack-fail '@bar'
628 --no-notify-slack-fail
629 Send failing results to a slack channel and/or user
630
631 Can be specified multiple times
632
633 --notify-slack-owner
634 --no-notify-slack-owner
635 Send slack notifications to the slack channels/users listed in test
636 meta-data when tests fail.
637
638 --notify-slack-url https://hooks.slack.com/...
639 --no-notify-slack-url
640 Specify an API endpoint for slack webhook integrations
641
642 --notify-text ARG
643 --notify-text=ARG
644 --message ARG
645 --message=ARG
646 --msg ARG
647 --msg=ARG
648 --no-notify-text
649 Add a custom text snippet to email/slack notifications
650
651 --notify-text-module ARG
652 --notify-text-module=ARG
653 --message_module ARG
654 --message_module=ARG
655 --no-notify-text-module
656 Use the specified module to generate messages for emails and/or
657 slack.
658
659 Run Options
660
661 --author-testing
662 -A
663 --no-author-testing
664 This will set the AUTHOR_TESTING environment to true
665
666 --dbi-profiling
667 --no-dbi-profiling
668 Use Test2::Plugin::DBIProfile to collect database profiling data
669
670 --env-var VAR=VAL
671 -EVAR=VAL
672 -E VAR=VAL
673 --no-env-var
674 Set environment variables to set when each test is run.
675
676 Can be specified multiple times
677
678 --event-uuids
679 --uuids
680 --no-event-uuids
681 Use Test2::Plugin::UUID inside tests (default: on)
682
683 --fields name:details
684 --fields JSON_STRING
685 -f name:details
686 -f JSON_STRING
687 --no-fields
688 Add custom data to the harness run
689
690 Can be specified multiple times
691
692 --input ARG
693 --input=ARG
694 --no-input
695 Input string to be used as standard input for ALL tests. See also:
696 --input-file
697
698 --input-file ARG
699 --input-file=ARG
700 --no-input-file
701 Use the specified file as standard input to ALL tests
702
703 --io-events
704 --no-io-events
705 Use Test2::Plugin::IOEvents inside tests to turn all prints into
706 test2 events (default: off)
707
708 --link 'https://travis.work/builds/42'
709 --link 'https://jenkins.work/job/42'
710 --link 'https://buildbot.work/builders/foo/builds/42'
711 --no-link
712 Provide one or more links people can follow to see more about this
713 run.
714
715 Can be specified multiple times
716
717 --load ARG
718 --load=ARG
719 --load-module ARG
720 --load-module=ARG
721 -m ARG
722 -m=ARG
723 --no-load
724 Load a module in each test (after fork). The "import" method is not
725 called.
726
727 Can be specified multiple times
728
729 --load-import Module
730 --load-import Module=import_arg1,arg2,...
731 --loadim Module
732 --loadim Module=import_arg1,arg2,...
733 -M Module
734 -M Module=import_arg1,arg2,...
735 --no-load-import
736 Load a module in each test (after fork). Import is called.
737
738 Can be specified multiple times. If the same key is listed multiple
739 times the value lists will be appended together.
740
741 --mem-usage
742 --no-mem-usage
743 Use Test2::Plugin::MemUsage inside tests (default: on)
744
745 --retry ARG
746 --retry=ARG
747 -r ARG
748 -r=ARG
749 --no-retry
750 Run any jobs that failed a second time. NOTE: --retry=1 means
751 failing tests will be attempted twice!
752
753 --retry-isolated
754 --retry-iso
755 --no-retry-isolated
756 If true then any job retries will be done in isolation (as though
757 -j1 was set)
758
759 --run-id
760 --id
761 --no-run-id
762 Set a specific run-id. (Default: a UUID)
763
764 --test-args ARG
765 --test-args=ARG
766 --no-test-args
767 Arguments to pass in as @ARGV for all tests that are run. These can
768 be provided easier using the '::' argument separator.
769
770 Can be specified multiple times
771
772 --stream
773 --no-stream
774 Use the stream formatter (default is on)
775
776 --tap
777 --TAP
778 ----no-stream
779 --no-tap
780 The TAP format is lossy and clunky. Test2::Harness normally uses a
781 newer streaming format to receive test results. There are
782 old/legacy tests where this causes problems, in which case setting
783 --TAP or --no-stream can help.
784
785 YathUI Options
786
787 --yathui-api-key ARG
788 --yathui-api-key=ARG
789 --no-yathui-api-key
790 Yath-UI API key. This is not necessary if your Yath-UI instance is
791 set to single-user
792
793 --yathui-coverage
794 --no-yathui-coverage
795 Poll coverage data from Yath-UI to determine what tests should be
796 run for changed files
797
798 --yathui-db
799 --no-yathui-db
800 Add the YathUI DB renderer in addition to other renderers
801
802 --yathui-durations
803 --no-yathui-durations
804 Poll duration data from Yath-UI to help order tests efficiently
805
806 --yathui-grace
807 --no-yathui-grace
808 If yath cannot connect to yath-ui it normally throws an error, use
809 this to make it fail gracefully. You get a warning, but things keep
810 going.
811
812 --yathui-long-duration 10
813 --no-yathui-long-duration
814 Minimum duration length (seconds) before a test goes from MEDIUM to
815 LONG
816
817 --yathui-medium-duration 5
818 --no-yathui-medium-duration
819 Minimum duration length (seconds) before a test goes from SHORT to
820 MEDIUM
821
822 --yathui-mode summary
823 --yathui-mode qvf
824 --yathui-mode qvfd
825 --yathui-mode complete
826 --no-yathui-mode
827 Set the upload mode (default 'qvfd')
828
829 --yathui-only
830 --no-yathui-only
831 Only use the YathUI renderer
832
833 --yathui-only-db
834 --no-yathui-only-db
835 Only use the YathUI DB renderer
836
837 --yathui-port 8080
838 --no-yathui-port
839 Port to use when running a local server
840
841 --yathui-port-command get_port.sh
842 --yathui-port-command get_port.sh --pid $$
843 --no-yathui-port-command
844 Use a command to get a port number. "$$" will be replaced with the
845 PID of the yath process
846
847 --yathui-project ARG
848 --yathui-project=ARG
849 --no-yathui-project
850 The Yath-UI project for your test results
851
852 --yathui-render
853 --no-yathui-render
854 Add the YathUI renderer in addition to other renderers
855
856 --yathui-retry
857 --no-yathui-retry
858 How many times to try an operation before giving up
859
860 Can be specified multiple times
861
862 --yathui-schema PostgreSQL
863 --yathui-schema MySQL
864 --yathui-schema MySQL56
865 --no-yathui-schema
866 What type of DB/schema to use when using a temporary database
867
868 --yathui-upload
869 --no-yathui-upload
870 Upload the log to Yath-UI
871
872 --yathui-url http://my-yath-ui.com/...
873 --uri http://my-yath-ui.com/...
874 --no-yathui-url
875 Yath-UI url
876
877 --yathui-user ARG
878 --yathui-user=ARG
879 --no-yathui-user
880 Username to attach to the data sent to the db
881
882 --yathui-db-buffering none
883 --yathui-db-buffering job
884 --yathui-db-buffering diag
885 --yathui-db-buffering run
886 --no-yathui-db-buffering
887 Type of buffering to use, if "none" then events are written to the
888 db one at a time, which is SLOW
889
890 --yathui-db-config ARG
891 --yathui-db-config=ARG
892 --no-yathui-db-config
893 Module that implements 'MODULE->yath_ui_config(%params)' which
894 should return a Test2::Harness::UI::Config instance.
895
896 --yathui-db-coverage
897 --no-yathui-db-coverage
898 Pull coverage data directly from the database (default: off)
899
900 --yathui-db-driver Pg
901 --yathui-db-drivermysql
902 --yathui-db-driverMariaDB
903 --no-yathui-db-driver
904 DBI Driver to use
905
906 --yathui-db-dsn ARG
907 --yathui-db-dsn=ARG
908 --no-yathui-db-dsn
909 DSN to use when connecting to the db
910
911 --yathui-db-duration-limit ARG
912 --yathui-db-duration-limit=ARG
913 --no-yathui-db-duration-limit
914 Limit the number of runs to look at for durations data (default:
915 10)
916
917 --yathui-db-durations
918 --no-yathui-db-durations
919 Pull duration data directly from the database (default: off)
920
921 --yathui-db-flush-interval 2
922 --yathui-db-flush-interval 1.5
923 --no-yathui-db-flush-interval
924 When buffering DB writes, force a flush when an event is recieved
925 at least N seconds after the last flush.
926
927 --yathui-db-host ARG
928 --yathui-db-host=ARG
929 --no-yathui-db-host
930 hostname to use when connecting to the db
931
932 --yathui-db-name ARG
933 --yathui-db-name=ARG
934 --no-yathui-db-name
935 Name of the database to use for yathui
936
937 --yathui-db-pass ARG
938 --yathui-db-pass=ARG
939 --no-yathui-db-pass
940 Password to use when connecting to the db
941
942 --yathui-db-port ARG
943 --yathui-db-port=ARG
944 --no-yathui-db-port
945 port to use when connecting to the db
946
947 --yathui-db-publisher ARG
948 --yathui-db-publisher=ARG
949 --no-yathui-db-publisher
950 When using coverage or duration data, only use data uploaded by
951 this user
952
953 --yathui-db-socket ARG
954 --yathui-db-socket=ARG
955 --no-yathui-db-socket
956 socket to use when connecting to the db
957
958 --yathui-db-user ARG
959 --yathui-db-user=ARG
960 --no-yathui-db-user
961 Username to use when connecting to the db
962
963 NO CATEGORY - FIX ME
964
965 --check-reload-state
966 --no-check-reload-state
967 Abort the run if there are unfixes reload errors and show a
968 confirmation dialogue for unfixed reload warnings.
969
971 The source code repository for Test2-Harness can be found at
972 http://github.com/Test-More/Test2-Harness/.
973
975 Chad Granum <exodist@cpan.org>
976
978 Chad Granum <exodist@cpan.org>
979
981 Copyright 2022 Chad Granum <exodist7@gmail.com>.
982
983 This program is free software; you can redistribute it and/or modify it
984 under the same terms as Perl itself.
985
986 See http://dev.perl.org/licenses/
987
988
989
990perl v5.36.0 2022-09-08 App::Yath::Command::run(3)