1App::Yath::Options::FinUdseerr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Options::Finder(3)
2
6 App::Yath::Options::Finder - Finder options for Yath.
7
9 This is where the command line options for discovering test files are
10 defined.
11
13 YATH OPTIONS (PRE-COMMAND)
14 Finder Options
15 --finder MyFinder
17 --finder +Test2::Harness::Finder::MyFinder
18 --no-finder
19 Specify what Finder subclass to use when searching for
20 files/processing the file list. Use the "+" prefix to specify a
21 fully qualified namespace, otherwise Test2::Harness::Finder::XXX
22 namespace is assumed.
23 COMMAND OPTIONS
25 Finder Options
26 --changed path/to/file
28 --no-changed
29 Specify one or more files as having been changed.
30 Can be specified multiple times
32 --changed-only
34 --no-changed-only
35 Only search for tests for changed files (Requires --coverage-from,
36 also requires a list of changes either from the --changed option,
37 or a plugin that implements changed_files())
38 --changes-plugin Git
40 --changes-plugin +App::Yath::Plugin::Git
41 --no-changes-plugin
42 What plugin should be used to detect changed files.
43 --coverage-from path/to/log.jsonl
45 --coverage-from http://example.com/coverage
46 --coverage-from path/to/coverage.json
47 --no-coverage-from
48 Where to fetch coverage data. Can be a path to a .jsonl(.bz|.gz)?
49 log file. Can be a path or url to a json file containing a hash
50 where source files are key, and value is a list of tests to run.
51 --coverage-url-use-post
53 --no-coverage-url-use-post
54 If coverage_from is a url, use the http POST method with a list of
55 changed files. This allows the server to tell us what tests to run
56 instead of downloading all the coverage data and determining what
57 tests to run from that.
58 --default-at-search ARG
60 --default-at-search=ARG
61 --no-default-at-search
62 Specify the default file/dir search when 'AUTHOR_TESTING' is set.
63 Defaults to './xt'. The default AT search is only used if no files
64 were specified at the command line
65 Can be specified multiple times
67 --default-search ARG
69 --default-search=ARG
70 --no-default-search
71 Specify the default file/dir search. defaults to './t', './t2', and
72 'test.pl'. The default search is only used if no files were
73 specified at the command line
74 Can be specified multiple times
76 --durations file.json
78 --durations http://example.com/durations.json
79 --no-durations
80 Point at a json file or url which has a hash of relative test
81 filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This
82 will override durations listed in the file headers. An exception
83 will be thrown if the durations file or url does not work.
84 --exclude-file t/nope.t
86 --no-exclude-file
87 Exclude a file from testing
88 Can be specified multiple times
90 --exclude-list file.txt
92 --exclude-list http://example.com/exclusions.txt
93 --no-exclude-list
94 Point at a file or url which has a new line separated list of test
95 file names to exclude from testing. Starting a line with a '#' will
96 comment it out (for compatibility with Test2::Aggregate list
97 files).
98 Can be specified multiple times
100 --exclude-pattern t/nope.t
102 --no-exclude-pattern
103 Exclude a pattern from testing, matched using m/$PATTERN/
104 Can be specified multiple times
106 --extension ARG
108 --extension=ARG
109 --ext ARG
110 --ext=ARG
111 --no-extension
112 Specify valid test filename extensions, default: t and t2
113 Can be specified multiple times
115 --maybe-coverage-from path/to/log.jsonl
117 --maybe-coverage-from http://example.com/coverage
118 --maybe-coverage-from path/to/coverage.json
119 --no-maybe-coverage-from
120 Where to fetch coverage data. Can be a path to a .jsonl(.bz|.gz)?
121 log file. Can be a path or url to a json file containing a hash
122 where source files are key, and value is a list of tests to run.
123 --maybe-durations file.json
125 --maybe-durations http://example.com/durations.json
126 --no-maybe-durations
127 Point at a json file or url which has a hash of relative test
128 filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This
129 will override durations listed in the file headers. An exception
130 will be thrown if the durations file or url does not work.
131 --no-long
133 --no-no-long
134 Do not run tests that have their duration flag set to 'LONG'
135 --only-long
137 --no-only-long
138 Only run tests that have their duration flag set to 'LONG'
139 --search ARG
141 --search=ARG
142 --no-search
143 List of tests and test directories to use instead of the default
144 search paths. Typically these can simply be listed as command line
145 arguments without the --search prefix.
146 Can be specified multiple times
148 --show-changed-files
150 --no-show-changed-files
151 Print a list of changed files if any are found
152
154 The source code repository for Test2-Harness can be found at
155 http://github.com/Test-More/Test2-Harness/.
156
158 Chad Granum <exodist@cpan.org>
159
161 Chad Granum <exodist@cpan.org>
162
164 Copyright 2020 Chad Granum <exodist7@gmail.com>.
165 This program is free software; you can redistribute it and/or modify it
167 under the same terms as Perl itself.
168 See http://dev.perl.org/licenses/
170perl v5.32.1 2021-03-12 App::Yath::Options::Finder(3)