The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

File::Find::Rule - Alternative interface to File::Find

SYNOPSIS

  use File::Find::Rule;
  # find all the subdirectories of a given directory
  my @subdirs = File::Find::Rule->directory->in( $directory );

  # find all the .pm files in @INC
  my @files = File::Find::Rule->file()
                              ->name( '*.pm' )
                              ->in( @INC );

  # as above, but without method chaining
  my $rule =  File::Find::Rule->new;
  $rule->file;
  $rule->name( '*.pm' );
  my @files = $rule->in( @INC );

DEPENDENCIES

This module has external dependencies on the following modules:

 Cwd
 File::Find
 File::Spec
 Number::Compare
 Test::More
 Text::Glob

INSTALLATION

 perl Build.PL
 perl Build test

and if all goes well

 perl Build install

HISTORY

What changed over the last 3 revisions

0.28 Tuesday 18th May, 2004
        exposed %X_tests and @stat_tests as package variables, and make a
        _call_find method for File::Find::Rule::Filesys::Virtual
0.27 Wednesday 25th February, 2004
        Changed to write_makefile_pl to 'traditional' from
        'passthrough'.  Fixes INDIRECTLY REPORTED install problems
        caused by new Module::Build being backwards incompatible.
0.26 Monday 10th November, 2003
        Typo/thinko in File::Find::Rule::Extending corrected (spotted
        by Jim Cromie)

        Optimization to the stat-based tests.  They now compile to code
        fragments saving much subroutine dispatch.

AUTHOR

Richard Clamp <richardc@unixbeard.net> with input gained from this use.perl discussion: http://use.perl.org/~richardc/journal/6467

Additional proofreading and input provided by Kake, Greg McCarroll, and Andy Lester andy@petdance.com.

COPYRIGHT

Copyright (C) 2002,2003 Richard Clamp. All Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

File::Find, Text::Glob, Number::Compare, find(1)

If you want to know about the procedural interface, see File::Find::Rule::Procedural, and if you have an idea for a neat extension File::Find::Rule::Extending