NAME¶
Dist::Zilla::Plugin::FileFinder::ByName - FileFinder matching on pathnames
VERSION¶
version 4.300020
SYNOPSIS¶
In your
dist.ini:
[FileFinder::ByName / MyFiles]
dir = bin ; look in the bin/ directory
dir = lib ; and the lib/ directory
file = *.pl ; for .pl files
match = \.pm$ ; and for .pm files
skip = ignore ; that don't have "ignore" in the path
DESCRIPTION¶
FileFinder::ByName is a FileFinder that selects files by matching the criteria
you specify against the pathname.
There are three types of criteria you can use. "dir" limits the search
to a particular directory. "match" is a regular expression that must
match the pathname. "skip" is a regular expression that must not
match the pathname.
Each key can be specified multiple times. Multiple occurrences of the same key
are ORed together. Different keys are ANDed together. That means that to be
selected, a file must be located in one of the "dir"s, must match
one of the "match" regexs, and must not match any of the
"skip" regexs.
Note that "file" and "match" are considered to be the
same key. They're just different ways to write a regex that the
pathname must match.
Omitting a particular key means that criterion will not apply to the search.
Omitting all keys will select every file in your dist.
Note: If you need to OR different types of criteria, then use more than one
instance of FileFinder::ByName. A FileFinderUser should allow you to specify
more than one FileFinder to use.
ATTRIBUTES¶
dir¶
The file must be located in one of the specified directories (relative to the
root directory of the dist).
file¶
The filename must match one of the specified patterns (which are converted to
regexs using Text::Glob and combined with any "match" rules).
match¶
The pathname must match one of these regular expressions.
skip¶
The pathname must
not match any of these regular expressions.
CREDITS¶
This plugin was originally contributed by Christopher J. Madsen.
AUTHOR¶
Ricardo SIGNES <rjbs@cpan.org>
COPYRIGHT AND LICENSE¶
This software is copyright (c) 2012 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under the same
terms as the Perl 5 programming language system itself.