NAME
App::Yath::Command::which - Locate the persistent test runner
DESCRIPTION
This will tell you about any persistent runners it can find.
USAGE
$ yath [YATH OPTIONS] which [COMMAND OPTIONS]
YATH OPTIONS
Developer
- --dev-lib
- --dev-lib=lib
- -D
- -D=lib
- -Dlib
- --no-dev-lib
-
Add paths to @INC before loading ANYTHING. This is what you use if you are developing yath or yath plugins to make sure the yath script finds the local code instead of the installed versions of the same code. You can provide an argument (-Dfoo) to provide a custom path, or you can just use -D without and arg to add lib, blib/lib and blib/arch.
Can be specified multiple times
Environment
- --persist-dir ARG
- --persist-dir=ARG
- --no-persist-dir
-
Where to find persistence files.
- --persist-file ARG
- --persist-file=ARG
- --pfile ARG
- --pfile=ARG
- --no-persist-file
-
Where to find the persistence file. The default is /{system-tempdir}/project-yath-persist.json. If no project is specified then it will fall back to the current directory. If the current directory is not writable it will default to /tmp/yath-persist.json which limits you to one persistent runner on your system.
- --project ARG
- --project=ARG
- --project-name ARG
- --project-name=ARG
- --no-project
-
This lets you provide a label for your current project/codebase. This is best used in a .yath.rc file. This is necessary for a persistent runner.
Help and Debugging
- --show-opts
- --no-show-opts
-
Exit after showing what yath thinks your options mean
- --version
- -V
- --no-version
-
Exit after showing a helpful usage message
Plugins
- --no-scan-plugins
- --no-no-scan-plugins
-
Normally yath scans for and loads all App::Yath::Plugin::* modules in order to bring in command-line options they may provide. This flag will disable that. This is useful if you have a naughty plugin that it loading other modules when it should not.
- --plugins PLUGIN
- --plugins +App::Yath::Plugin::PLUGIN
- --plugins PLUGIN=arg1,arg2,...
- --plugin PLUGIN
- --plugin +App::Yath::Plugin::PLUGIN
- --plugin PLUGIN=arg1,arg2,...
- -pPLUGIN
- --no-plugins
-
Load a yath plugin.
Can be specified multiple times
COMMAND OPTIONS
Help and Debugging
- --dummy
- -d
- --no-dummy
-
Dummy run, do not actually execute anything
Can also be set with the following environment variables:
T2_HARNESS_DUMMY
- --help
- -h
- --no-help
-
exit after showing help information
- --keep-dirs
- --keep_dir
- -k
- --no-keep-dirs
-
Do not delete directories when done. This is useful if you want to inspect the directories used for various commands.
- --summary
- --summary=/path/to/summary.json
- --no-summary
-
Write out a summary json file, if no path is provided 'summary.json' will be used. The .json extension is added automatically if omitted.
SOURCE
The source code repository for Test2-Harness can be found at http://github.com/Test-More/Test2-Harness/.
MAINTAINERS
AUTHORS
COPYRIGHT
Copyright 2020 Chad Granum <exodist7@gmail.com>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://dev.perl.org/licenses/