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.