NAME

App::Yath::Options::Finder - Finder options for Yath.

DESCRIPTION

This is where the command line options for discovering test files are defined.

PROVIDED OPTIONS

YATH OPTIONS (PRE-COMMAND)

Finder Options

--finder MyFinder

--finder +Test2::Harness::Finder::MyFinder

--no-finder

Specify what Finder subclass to use when searching for files/processing the file list. Use the "+" prefix to specify a fully qualified namespace, otherwise Test2::Harness::Finder::XXX namespace is assumed.

COMMAND OPTIONS

Finder Options

--changed path/to/file

--no-changed

Specify one or more files as having been changed.

Can be specified multiple times

--changed-only

--no-changed-only

Only search for tests for changed files (Requires --coverage-from, also requires a list of changes either from the --changed option, or a plugin that implements changed_files())

--changes-plugin Git

--changes-plugin +App::Yath::Plugin::Git

--no-changes-plugin

What plugin should be used to detect changed files.

--coverage-from path/to/log.jsonl

--coverage-from http://example.com/coverage

--coverage-from path/to/coverage.json

--no-coverage-from

Where to fetch coverage data. Can be a path to a .jsonl(.bz|.gz)? log file. Can be a path or url to a json file containing a hash where source files are key, and value is a list of tests to run.

--coverage-url-use-post

--no-coverage-url-use-post

If coverage_from is a url, use the http POST method with a list of changed files. This allows the server to tell us what tests to run instead of downloading all the coverage data and determining what tests to run from that.

--default-at-search ARG

--default-at-search=ARG

--no-default-at-search

Specify the default file/dir search when 'AUTHOR_TESTING' is set. Defaults to './xt'. The default AT search is only used if no files were specified at the command line

Can be specified multiple times

--default-search ARG

--default-search=ARG

--no-default-search

Specify the default file/dir search. defaults to './t', './t2', and 'test.pl'. The default search is only used if no files were specified at the command line

Can be specified multiple times

--durations file.json

--durations http://example.com/durations.json

--no-durations

Point at a json file or url which has a hash of relative test filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This will override durations listed in the file headers. An exception will be thrown if the durations file or url does not work.

--exclude-file t/nope.t

--no-exclude-file

Exclude a file from testing

Can be specified multiple times

--exclude-list file.txt

--exclude-list http://example.com/exclusions.txt

--no-exclude-list

Point at a file or url which has a new line separated list of test file names to exclude from testing. Starting a line with a '#' will comment it out (for compatibility with Test2::Aggregate list files).

Can be specified multiple times

--exclude-pattern t/nope.t

--no-exclude-pattern

Exclude a pattern from testing, matched using m/$PATTERN/

Can be specified multiple times

--extension ARG

--extension=ARG

--ext ARG

--ext=ARG

--no-extension

Specify valid test filename extensions, default: t and t2

Can be specified multiple times

--maybe-coverage-from path/to/log.jsonl

--maybe-coverage-from http://example.com/coverage

--maybe-coverage-from path/to/coverage.json

--no-maybe-coverage-from

Where to fetch coverage data. Can be a path to a .jsonl(.bz|.gz)? log file. Can be a path or url to a json file containing a hash where source files are key, and value is a list of tests to run.

--maybe-durations file.json

--maybe-durations http://example.com/durations.json

--no-maybe-durations

Point at a json file or url which has a hash of relative test filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This will override durations listed in the file headers. An exception will be thrown if the durations file or url does not work.

--no-long

--no-no-long

Do not run tests that have their duration flag set to 'LONG'

--only-long

--no-only-long

Only run tests that have their duration flag set to 'LONG'

--search ARG

--search=ARG

--no-search

List of tests and test directories to use instead of the default search paths. Typically these can simply be listed as command line arguments without the --search prefix.

Can be specified multiple times

--show-changed-files

--no-show-changed-files

Print a list of changed files if any are found

SOURCE

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

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

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/