1App::Yath::Command::runU(s3e)r Contributed Perl DocumentaAtpipo:n:Yath::Command::run(3)
2
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 YATH OPTIONS
17 Developer
18 --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 Can be specified multiple times
33 Environment
35 --persist-dir ARG
37 --persist-dir=ARG
38 --no-persist-dir
39 Where to find persistence files.
40 --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 --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 Finder Options
63 --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 Help and Debugging
73 --show-opts
75 --no-show-opts
76 Exit after showing what yath thinks your options mean
77 --version
79 -V
80 --no-version
81 Exit after showing a helpful usage message
82 Plugins
84 --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 it loading other modules when it should not.
91 --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 Can be specified multiple times
103 COMMAND OPTIONS
105 Cover Options
106 --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 --cover-class ARG
117 --cover-class=ARG
118 --no-cover-class
119 Choose a Test2::Plugin::Cover subclass
120 --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 Can be specified multiple times
129 --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 --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 --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 --cover-manager My::Coverage::Manager
156 --no-cover-manager
157 Coverage 'from' manager to use when coverage data does not provide
158 one
159 --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 --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 --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 Can be specified multiple times
185 --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 Display Options
194 --color
196 --no-color
197 Turn color on, default is true if STDOUT is a TTY.
198 --no-wrap
200 --no-no-wrap
201 Do not do fancy text-wrapping, let the terminal handle it
202 --progress
204 --no-progress
205 Toggle progress indicators. On by default if STDOUT is a TTY. You
206 can use --no-progress to disable the 'events seen' counter and
207 buffered event pre-display
208 --quiet
210 -q
211 --no-quiet
212 Be very quiet.
213 Can be specified multiple times
215 --renderers +My::Renderer
217 --renderers Renderer=arg1,arg2,...
218 --renderer +My::Renderer
219 --renderer Renderer=arg1,arg2,...
220 --no-renderers
221 Specify renderers, (Default: "Formatter=Test2"). Use "+" to give a
222 fully qualified module name. Without "+"
223 "Test2::Harness::Renderer::" will be prepended to your argument.
224 Can be specified multiple times. If the same key is listed multiple
226 times the value lists will be appended together.
227 --show-times
229 -T
230 --no-show-times
231 Show the timing data for each job
232 --term-width 80
234 --term-width 200
235 --term-size 80
236 --term-size 200
237 --no-term-width
238 Alternative to setting $TABLE_TERM_SIZE. Setting this will override
239 the terminal width detection to the number of characters specified.
240 --verbose
242 -v
243 --no-verbose
244 Be more verbose
245 Can be specified multiple times
247 Finder Options
249 --changed path/to/file
251 --no-changed
252 Specify one or more files as having been changed.
253 Can be specified multiple times
255 --changed-only
257 --no-changed-only
258 Only search for tests for changed files (Requires a coverage data
259 source, also requires a list of changes either from the --changed
260 option, or a plugin that implements changed_files() or
261 changed_diff())
262 --changes-diff path/to/diff.diff
264 --no-changes-diff
265 Path to a diff file that should be used to find changed files for
266 use with --changed-only. This must be in the same format as `git
267 diff -W --minimal -U1000000`
268 --changes-filter-file path/to/file
270 --no-changes-filter-file
271 Specify one or more files to check for changes. Changes to other
272 files will be ignored
273 Can be specified multiple times
275 --changes-filter-pattern '(apple|pear|orange)'
277 --no-changes-filter-pattern
278 Specify a pattern for change checking. When only running tests for
279 changed files this will limit which files are checked for changes.
280 Only files that match this pattern will be checked. Your pattern
281 will be inserted unmodified into a `$file =~ m/$pattern/` check.
282 Can be specified multiple times
284 --changes-plugin Git
286 --changes-plugin +App::Yath::Plugin::Git
287 --no-changes-plugin
288 What plugin should be used to detect changed files.
289 --default-at-search ARG
291 --default-at-search=ARG
292 --no-default-at-search
293 Specify the default file/dir search when 'AUTHOR_TESTING' is set.
294 Defaults to './xt'. The default AT search is only used if no files
295 were specified at the command line
296 Can be specified multiple times
298 --default-search ARG
300 --default-search=ARG
301 --no-default-search
302 Specify the default file/dir search. defaults to './t', './t2', and
303 'test.pl'. The default search is only used if no files were
304 specified at the command line
305 Can be specified multiple times
307 --durations file.json
309 --durations http://example.com/durations.json
310 --no-durations
311 Point at a json file or url which has a hash of relative test
312 filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This
313 will override durations listed in the file headers. An exception
314 will be thrown if the durations file or url does not work.
315 --exclude-file t/nope.t
317 --no-exclude-file
318 Exclude a file from testing
319 Can be specified multiple times
321 --exclude-list file.txt
323 --exclude-list http://example.com/exclusions.txt
324 --no-exclude-list
325 Point at a file or url which has a new line separated list of test
326 file names to exclude from testing. Starting a line with a '#' will
327 comment it out (for compatibility with Test2::Aggregate list
328 files).
329 Can be specified multiple times
331 --exclude-pattern t/nope.t
333 --no-exclude-pattern
334 Exclude a pattern from testing, matched using m/$PATTERN/
335 Can be specified multiple times
337 --extension ARG
339 --extension=ARG
340 --ext ARG
341 --ext=ARG
342 --no-extension
343 Specify valid test filename extensions, default: t and t2
344 Can be specified multiple times
346 --maybe-durations file.json
348 --maybe-durations http://example.com/durations.json
349 --no-maybe-durations
350 Point at a json file or url which has a hash of relative test
351 filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This
352 will override durations listed in the file headers. An exception
353 will be thrown if the durations file or url does not work.
354 --no-long
356 --no-no-long
357 Do not run tests that have their duration flag set to 'LONG'
358 --only-long
360 --no-only-long
361 Only run tests that have their duration flag set to 'LONG'
362 --search ARG
364 --search=ARG
365 --no-search
366 List of tests and test directories to use instead of the default
367 search paths. Typically these can simply be listed as command line
368 arguments without the --search prefix.
369 Can be specified multiple times
371 --show-changed-files
373 --no-show-changed-files
374 Print a list of changed files if any are found
375 Formatter Options
377 --formatter ARG
379 --formatter=ARG
380 --no-formatter
381 NO DESCRIPTION - FIX ME
382 --qvf
384 --no-qvf
385 [Q]uiet, but [V]erbose on [F]ailure. Hide all output from tests
386 when they pass, except to say they passed. If a test fails then ALL
387 output from the test is verbosely output.
388 --show-job-end
390 --no-show-job-end
391 Show output when a job ends. (Default: on)
392 --show-job-info
394 --no-show-job-info
395 Show the job configuration when a job starts. (Default: off, unless
396 -vv)
397 --show-job-launch
399 --no-show-job-launch
400 Show output for the start of a job. (Default: off unless -v)
401 --show-run-info
403 --no-show-run-info
404 Show the run configuration when a run starts. (Default: off, unless
405 -vv)
406 Git Options
408 --git-change-base master
410 --git-change-base HEAD^
411 --git-change-base df22abe4
412 --no-git-change-base
413 Find files changed by all commits in the current branch from most
414 recent stopping when a commit is found that is also present in the
415 history of the branch/commit specified as the change base.
416 Help and Debugging
418 --dummy
420 -d
421 --no-dummy
422 Dummy run, do not actually execute anything
423 Can also be set with the following environment variables:
425 "T2_HARNESS_DUMMY"
426 --help
428 -h
429 --no-help
430 exit after showing help information
431 --interactive
433 -i
434 --no-interactive
435 Use interactive mode, 1 test at a time, stdin forwarded to it
436 --keep-dirs
438 --keep_dir
439 -k
440 --no-keep-dirs
441 Do not delete directories when done. This is useful if you want to
442 inspect the directories used for various commands.
443 --summary
445 --summary=/path/to/summary.json
446 --no-summary
447 Write out a summary json file, if no path is provided
448 'summary.json' will be used. The .json extension is added
449 automatically if omitted.
450 Logging Options
452 --bzip2
454 --bz2
455 --bzip2_log
456 -B
457 --no-bzip2
458 Use bzip2 compression when writing the log. This option implies -L.
459 The .bz2 prefix is added to log file name for you
460 --gzip
462 --gz
463 --gzip_log
464 -G
465 --no-gzip
466 Use gzip compression when writing the log. This option implies -L.
467 The .gz prefix is added to log file name for you
468 --log
470 -L
471 --no-log
472 Turn on logging
473 --log-dir ARG
475 --log-dir=ARG
476 --no-log-dir
477 Specify a log directory. Will fall back to the system temp dir.
478 --log-file ARG
480 --log-file=ARG
481 -F ARG
482 -F=ARG
483 --no-log-file
484 Specify the name of the log file. This option implies -L.
485 --log-file-format ARG
487 --log-file-format=ARG
488 --lff ARG
489 --lff=ARG
490 --no-log-file-format
491 Specify the format for automatically-generated log files.
492 Overridden by --log-file, if given. This option implies -L
493 (Default: \$YATH_LOG_FILE_FORMAT, if that is set, or else
494 "%!P%Y-%m-%d~%H:%M:%S~%!U~%!p.jsonl"). This is a string in which
495 percent-escape sequences will be replaced as per POSIX::strftime.
496 The following special escape sequences are also replaced: (%!P :
497 Project name followed by a ~, if a project is defined, otherwise
498 empty string) (%!U : the unique test run ID) (%!p : the process ID)
499 (%!S : the number of seconds since local midnight UTC)
500 Can also be set with the following environment variables:
502 "YATH_LOG_FILE_FORMAT", "TEST2_HARNESS_LOG_FORMAT"
503 Notification Options
505 --notify-email foo@example.com
507 --no-notify-email
508 Email the test results to the specified email address(es)
509 Can be specified multiple times
511 --notify-email-fail foo@example.com
513 --no-notify-email-fail
514 Email failing results to the specified email address(es)
515 Can be specified multiple times
517 --notify-email-from foo@example.com
519 --no-notify-email-from
520 If any email is sent, this is who it will be from
521 --notify-email-owner
523 --no-notify-email-owner
524 Email the owner of broken tests files upon failure. Add `# HARNESS-
525 META-OWNER foo@example.com` to the top of a test file to give it an
526 owner
527 --notify-no-batch-email
529 --no-notify-no-batch-email
530 Usually owner failures are sent as a single batch at the end of
531 testing. Toggle this to send failures as they happen.
532 --notify-no-batch-slack
534 --no-notify-no-batch-slack
535 Usually owner failures are sent as a single batch at the end of
536 testing. Toggle this to send failures as they happen.
537 --notify-slack '#foo'
539 --notify-slack '@bar'
540 --no-notify-slack
541 Send results to a slack channel and/or user
542 Can be specified multiple times
544 --notify-slack-fail '#foo'
546 --notify-slack-fail '@bar'
547 --no-notify-slack-fail
548 Send failing results to a slack channel and/or user
549 Can be specified multiple times
551 --notify-slack-owner
553 --no-notify-slack-owner
554 Send slack notifications to the slack channels/users listed in test
555 meta-data when tests fail.
556 --notify-slack-url https://hooks.slack.com/...
558 --no-notify-slack-url
559 Specify an API endpoint for slack webhook integrations
560 --notify-text ARG
562 --notify-text=ARG
563 --message ARG
564 --message=ARG
565 --msg ARG
566 --msg=ARG
567 --no-notify-text
568 Add a custom text snippet to email/slack notifications
569 --notify-text-module ARG
571 --notify-text-module=ARG
572 --message_module ARG
573 --message_module=ARG
574 --no-notify-text-module
575 Use the specified module to generate messages for emails and/or
576 slack.
577 Run Options
579 --author-testing
581 -A
582 --no-author-testing
583 This will set the AUTHOR_TESTING environment to true
584 --dbi-profiling
586 --no-dbi-profiling
587 Use Test2::Plugin::DBIProfile to collect database profiling data
588 --env-var VAR=VAL
590 -EVAR=VAL
591 -E VAR=VAL
592 --no-env-var
593 Set environment variables to set when each test is run.
594 Can be specified multiple times
596 --event-uuids
598 --uuids
599 --no-event-uuids
600 Use Test2::Plugin::UUID inside tests (default: on)
601 --fields name:details
603 --fields JSON_STRING
604 -f name:details
605 -f JSON_STRING
606 --no-fields
607 Add custom data to the harness run
608 Can be specified multiple times
610 --input ARG
612 --input=ARG
613 --no-input
614 Input string to be used as standard input for ALL tests. See also:
615 --input-file
616 --input-file ARG
618 --input-file=ARG
619 --no-input-file
620 Use the specified file as standard input to ALL tests
621 --io-events
623 --no-io-events
624 Use Test2::Plugin::IOEvents inside tests to turn all prints into
625 test2 events (default: off)
626 --link 'https://travis.work/builds/42'
628 --link 'https://jenkins.work/job/42'
629 --link 'https://buildbot.work/builders/foo/builds/42'
630 --no-link
631 Provide one or more links people can follow to see more about this
632 run.
633 Can be specified multiple times
635 --load ARG
637 --load=ARG
638 --load-module ARG
639 --load-module=ARG
640 -m ARG
641 -m=ARG
642 --no-load
643 Load a module in each test (after fork). The "import" method is not
644 called.
645 Can be specified multiple times
647 --load-import Module
649 --load-import Module=import_arg1,arg2,...
650 --loadim Module
651 --loadim Module=import_arg1,arg2,...
652 -M Module
653 -M Module=import_arg1,arg2,...
654 --no-load-import
655 Load a module in each test (after fork). Import is called.
656 Can be specified multiple times. If the same key is listed multiple
658 times the value lists will be appended together.
659 --mem-usage
661 --no-mem-usage
662 Use Test2::Plugin::MemUsage inside tests (default: on)
663 --retry ARG
665 --retry=ARG
666 -r ARG
667 -r=ARG
668 --no-retry
669 Run any jobs that failed a second time. NOTE: --retry=1 means
670 failing tests will be attempted twice!
671 --retry-isolated
673 --retry-iso
674 --no-retry-isolated
675 If true then any job retries will be done in isolation (as though
676 -j1 was set)
677 --run-id
679 --id
680 --no-run-id
681 Set a specific run-id. (Default: a UUID)
682 --test-args ARG
684 --test-args=ARG
685 --no-test-args
686 Arguments to pass in as @ARGV for all tests that are run. These can
687 be provided easier using the '::' argument separator.
688 Can be specified multiple times
690 --stream
692 --no-stream
693 Use the stream formatter (default is on)
694 --tap
696 --TAP
697 ----no-stream
698 --no-tap
699 The TAP format is lossy and clunky. Test2::Harness normally uses a
700 newer streaming format to receive test results. There are
701 old/legacy tests where this causes problems, in which case setting
702 --TAP or --no-stream can help.
703 YathUI Options
705 --yathui-api-key ARG
707 --yathui-api-key=ARG
708 --no-yathui-api-key
709 Yath-UI API key. This is not necessary if your Yath-UI instance is
710 set to single-user
711 --yathui-coverage
713 --no-yathui-coverage
714 Poll coverage data from Yath-UI to determine what tests should be
715 run for changed files
716 --yathui-db
718 --no-yathui-db
719 Add the YathUI DB renderer in addition to other renderers
720 --yathui-durations
722 --no-yathui-durations
723 Poll duration data from Yath-UI to help order tests efficiently
724 --yathui-grace
726 --no-yathui-grace
727 If yath cannot connect to yath-ui it normally throws an error, use
728 this to make it fail gracefully. You get a warning, but things keep
729 going.
730 --yathui-long-duration 10
732 --no-yathui-long-duration
733 Minimum duration length (seconds) before a test goes from MEDIUM to
734 LONG
735 --yathui-medium-duration 5
737 --no-yathui-medium-duration
738 Minimum duration length (seconds) before a test goes from SHORT to
739 MEDIUM
740 --yathui-mode summary
742 --yathui-mode qvf
743 --yathui-mode qvfd
744 --yathui-mode complete
745 --no-yathui-mode
746 Set the upload mode (default 'qvfd')
747 --yathui-only
749 --no-yathui-only
750 Only use the YathUI renderer
751 --yathui-only-db
753 --no-yathui-only-db
754 Only use the YathUI DB renderer
755 --yathui-port 8080
757 --no-yathui-port
758 Port to use when running a local server
759 --yathui-port-command get_port.sh
761 --yathui-port-command get_port.sh --pid $$
762 --no-yathui-port-command
763 Use a command to get a port number. "$$" will be replaced with the
764 PID of the yath process
765 --yathui-project ARG
767 --yathui-project=ARG
768 --no-yathui-project
769 The Yath-UI project for your test results
770 --yathui-render
772 --no-yathui-render
773 Add the YathUI renderer in addition to other renderers
774 --yathui-retry
776 --no-yathui-retry
777 How many times to try an operation before giving up
778 Can be specified multiple times
780 --yathui-schema PostgreSQL
782 --yathui-schema MySQL
783 --yathui-schema MySQL56
784 --no-yathui-schema
785 What type of DB/schema to use when using a temporary database
786 --yathui-upload
788 --no-yathui-upload
789 Upload the log to Yath-UI
790 --yathui-url http://my-yath-ui.com/...
792 --uri http://my-yath-ui.com/...
793 --no-yathui-url
794 Yath-UI url
795 --yathui-user ARG
797 --yathui-user=ARG
798 --no-yathui-user
799 Username to attach to the data sent to the db
800 --yathui-db-buffering none
802 --yathui-db-buffering job
803 --yathui-db-buffering diag
804 --yathui-db-buffering run
805 --no-yathui-db-buffering
806 Type of buffering to use, if "none" then events are written to the
807 db one at a time, which is SLOW
808 --yathui-db-config ARG
810 --yathui-db-config=ARG
811 --no-yathui-db-config
812 Module that implements 'MODULE->yath_ui_config(%params)' which
813 should return a Test2::Harness::UI::Config instance.
814 --yathui-db-coverage
816 --no-yathui-db-coverage
817 Pull coverage data directly from the database (default: off)
818 --yathui-db-driver Pg
820 --yathui-db-drivermysql
821 --yathui-db-driverMariaDB
822 --no-yathui-db-driver
823 DBI Driver to use
824 --yathui-db-dsn ARG
826 --yathui-db-dsn=ARG
827 --no-yathui-db-dsn
828 DSN to use when connecting to the db
829 --yathui-db-durations
831 --no-yathui-db-durations
832 Pull duration data directly from the database (default: off)
833 --yathui-db-flush-interval 2
835 --yathui-db-flush-interval 1.5
836 --no-yathui-db-flush-interval
837 When buffering DB writes, force a flush when an event is recieved
838 at least N seconds after the last flush.
839 --yathui-db-host ARG
841 --yathui-db-host=ARG
842 --no-yathui-db-host
843 hostname to use when connecting to the db
844 --yathui-db-name ARG
846 --yathui-db-name=ARG
847 --no-yathui-db-name
848 Name of the database to use for yathui
849 --yathui-db-pass ARG
851 --yathui-db-pass=ARG
852 --no-yathui-db-pass
853 Password to use when connecting to the db
854 --yathui-db-port ARG
856 --yathui-db-port=ARG
857 --no-yathui-db-port
858 port to use when connecting to the db
859 --yathui-db-publisher ARG
861 --yathui-db-publisher=ARG
862 --no-yathui-db-publisher
863 When using coverage or duration data, only use data uploaded by
864 this user
865 --yathui-db-socket ARG
867 --yathui-db-socket=ARG
868 --no-yathui-db-socket
869 socket to use when connecting to the db
870 --yathui-db-user ARG
872 --yathui-db-user=ARG
873 --no-yathui-db-user
874 Username to use when connecting to the db
875
877 The source code repository for Test2-Harness can be found at
878 http://github.com/Test-More/Test2-Harness/.
879
881 Chad Granum <exodist@cpan.org>
882
884 Chad Granum <exodist@cpan.org>
885
887 Copyright 2021 Chad Granum <exodist7@gmail.com>.
888 This program is free software; you can redistribute it and/or modify it
890 under the same terms as Perl itself.
891 See http://dev.perl.org/licenses/
893perl v5.34.0 2021-11-05 App::Yath::Command::run(3)