1Dist::Zilla::Plugin::FiUlseeFrinCdoenrt:r:iBbyuNtaeDmdies(Pt3e:)r:lZiDlolcau:m:ePnltuagtiino:n:FileFinder::ByName(3)
2
3
4

NAME

6       Dist::Zilla::Plugin::FileFinder::ByName - FileFinder matching on
7       pathnames
8

VERSION

10       version 6.031
11

SYNOPSIS

13       In your dist.ini:
14
15         [FileFinder::ByName / MyFiles]
16         dir   = bin     ; look in the bin/ directory
17         dir   = lib     ; and the lib/ directory
18         file  = *.pl    ; for .pl files
19         match = \.pm$   ; and for .pm files
20         skip  = ignore  ; that don't have "ignore" in the path
21

DESCRIPTION

23       FileFinder::ByName is a FileFinder that selects files by matching the
24       criteria you specify against the pathname.
25
26       There are three types of criteria you can use.  "dir" limits the search
27       to a particular directory.  "match" is a regular expression that must
28       match the pathname.  "skip" is a regular expression that must not match
29       the pathname.
30
31       Each key can be specified multiple times.  Multiple occurrences of the
32       same key are ORed together.  Different keys are ANDed together.  That
33       means that to be selected, a file must be located in one of the "dir"s,
34       must match one of the "match" regexs, and must not match any of the
35       "skip" regexs.
36
37       Note that "file" and "match" are considered to be the same key.
38       They're just different ways to write a regex that the pathname must
39       match.
40
41       Omitting a particular key means that criterion will not apply to the
42       search.  Omitting all keys will select every file in your dist.
43
44       Note: If you need to OR different types of criteria, then use more than
45       one instance of FileFinder::ByName.  A FileFinderUser should allow you
46       to specify more than one FileFinder to use.
47

PERL VERSION

49       This module should work on any version of perl still receiving updates
50       from the Perl 5 Porters.  This means it should work on any version of
51       perl released in the last two to three years.  (That is, if the most
52       recently released version is v5.40, then this module should work on
53       both v5.40 and v5.38.)
54
55       Although it may work on older versions of perl, no guarantee is made
56       that the minimum required version will not be increased.  The version
57       may be increased for any reason, and there is no promise that patches
58       will be accepted to lower the minimum required perl.
59

ATTRIBUTES

61   dir
62       The file must be located in one of the specified directories (relative
63       to the root directory of the dist).
64
65   file
66       The filename must match one of the specified patterns (which are
67       converted to regexs using Text::Glob and combined with any "match"
68       rules).
69
70   match
71       The pathname must match one of these regular expressions.
72
73   skip
74       The pathname must not match any of these regular expressions.
75

CREDITS

77       This plugin was originally contributed by Christopher J. Madsen.
78

AUTHOR

80       Ricardo SIGNES 😏 <cpan@semiotic.systems>
81

83       This software is copyright (c) 2023 by Ricardo SIGNES.
84
85       This is free software; you can redistribute it and/or modify it under
86       the same terms as the Perl 5 programming language system itself.
87
88
89
90perl v5.36.1                      202D3i-s1t1:-:2Z1illa::Plugin::FileFinder::ByName(3)
Impressum