libpath-iterator-rule-perl - 1.014-1 main

Path::Iterator::Rule iterates over files and directories to identify
ones matching a user-defined set of rules. The API is based heavily on
File::Find::Rule, but with more explicit distinction between matching
rules and options that influence how directories are searched. A
Path::Iterator::Rule object is a collection of rules (match criteria)
with methods to add additional criteria. Options that control
directory traversal are given as arguments to the method that generates
an iterator.
.
Here is a summary of features for comparison to other file finding
modules:
* provides many "helper" methods for specifying rules
* offers (lazy) iterator and flattened list interfaces
* custom rules implemented with callbacks
* breadth-first (default) or pre- or post-order depth-first searching
* follows symlinks (by default, but can be disabled)
* directories visited only once (no infinite loop; can be disabled)
* doesn't chdir during operation
* provides an API for extensions
.
As a convenience, the PIR module is an empty subclass of this one that
is less arduous to type for one-liners.