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 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 --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 --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 Can be specified multiple times
52 --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 Can be specified multiple times
61 --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 --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 Can be specified multiple times
75 --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 Can be specified multiple times
84 --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 --exclude-file t/nope.t
94 --no-exclude-file
95 Exclude a file from testing
96 Can be specified multiple times
98 --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 Can be specified multiple times
108 --exclude-pattern t/nope.t
110 --no-exclude-pattern
111 Exclude a pattern from testing, matched using m/$PATTERN/
112 Can be specified multiple times
114 --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 Can be specified multiple times
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.34.0 2021-11-05 App::Yath::Options::Finder(3)