1App::Yath::Options::FinUdseerr(3C)ontributed Perl DocumeAnptpa:t:iYoanth::Options::Finder(3)
2
3
4

NAME

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

DESCRIPTION

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

PROVIDED OPTIONS

13   YATH OPTIONS (PRE-COMMAND)
14       Finder Options
15
16       --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
24   COMMAND OPTIONS
25       Finder Options
26
27       --changed path/to/file
28       --no-changed
29           Specify one or more files as having been changed.
30
31           Can be specified multiple times
32
33       --changed-only
34       --no-changed-only
35           Only search for tests for changed files (Requires a coverage data
36           source, also requires a list of changes either from the --changed
37           option, or a plugin that implements changed_files() or
38           changed_diff())
39
40       --changes-diff path/to/diff.diff
41       --no-changes-diff
42           Path to a diff file that should be used to find changed files for
43           use with --changed-only. This must be in the same format as `git
44           diff -W --minimal -U1000000`
45
46       --changes-filter-file path/to/file
47       --no-changes-filter-file
48           Specify one or more files to check for changes. Changes to other
49           files will be ignored
50
51           Can be specified multiple times
52
53       --changes-filter-pattern '(apple|pear|orange)'
54       --no-changes-filter-pattern
55           Specify a pattern for change checking. When only running tests for
56           changed files this will limit which files are checked for changes.
57           Only files that match this pattern will be checked. Your pattern
58           will be inserted unmodified into a `$file =~ m/$pattern/` check.
59
60           Can be specified multiple times
61
62       --changes-plugin Git
63       --changes-plugin +App::Yath::Plugin::Git
64       --no-changes-plugin
65           What plugin should be used to detect changed files.
66
67       --default-at-search ARG
68       --default-at-search=ARG
69       --no-default-at-search
70           Specify the default file/dir search when 'AUTHOR_TESTING' is set.
71           Defaults to './xt'. The default AT search is only used if no files
72           were specified at the command line
73
74           Can be specified multiple times
75
76       --default-search ARG
77       --default-search=ARG
78       --no-default-search
79           Specify the default file/dir search. defaults to './t', './t2', and
80           'test.pl'. The default search is only used if no files were
81           specified at the command line
82
83           Can be specified multiple times
84
85       --durations file.json
86       --durations http://example.com/durations.json
87       --no-durations
88           Point at a json file or url which has a hash of relative test
89           filenames as keys, and 'SHORT', 'MEDIUM', or 'LONG' as values. This
90           will override durations listed in the file headers. An exception
91           will be thrown if the durations file or url does not work.
92
93       --exclude-file t/nope.t
94       --no-exclude-file
95           Exclude a file from testing
96
97           Can be specified multiple times
98
99       --exclude-list file.txt
100       --exclude-list http://example.com/exclusions.txt
101       --no-exclude-list
102           Point at a file or url which has a new line separated list of test
103           file names to exclude from testing. Starting a line with a '#' will
104           comment it out (for compatibility with Test2::Aggregate list
105           files).
106
107           Can be specified multiple times
108
109       --exclude-pattern t/nope.t
110       --no-exclude-pattern
111           Exclude a pattern from testing, matched using m/$PATTERN/
112
113           Can be specified multiple times
114
115       --extension ARG
116       --extension=ARG
117       --ext ARG
118       --ext=ARG
119       --no-extension
120           Specify valid test filename extensions, default: t and t2
121
122           Can be specified multiple times
123
124       --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
132       --no-long
133       --no-no-long
134           Do not run tests that have their duration flag set to 'LONG'
135
136       --only-long
137       --no-only-long
138           Only run tests that have their duration flag set to 'LONG'
139
140       --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
147           Can be specified multiple times
148
149       --show-changed-files
150       --no-show-changed-files
151           Print a list of changed files if any are found
152

SOURCE

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

MAINTAINERS

158       Chad Granum <exodist@cpan.org>
159

AUTHORS

161       Chad Granum <exodist@cpan.org>
162
164       Copyright 2020 Chad Granum <exodist7@gmail.com>.
165
166       This program is free software; you can redistribute it and/or modify it
167       under the same terms as Perl itself.
168
169       See http://dev.perl.org/licenses/
170
171
172
173perl v5.34.0                      2021-11-05     App::Yath::Options::Finder(3)
Impressum