Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
App::Yath::Options::FiUser(Contributed Perl DocumApp::Yath::Options::Finder(3)

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/

perl v5.32.0			  2020-08-24	 App::Yath::Options::Finder(3)

NAME | DESCRIPTION | PROVIDED OPTIONS | SOURCE | MAINTAINERS | AUTHORS | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=App::Yath::Options::Finder&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help