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.22 Friday 3rd October, 2003

add in ->extras hash for passing things through to File::Find::find

0.21 Monday 15th September, 2003

pod glitch in File::Find::Rule::Procedural spotted and fixed
by Tom Hukins

0.20 8th September, 2003

- relative flag

- Fix maxdepth? - this is undertested.

- MANIFEST fixes (thanks to the cpan smokers)

- split the documentation of the procedural interface out to
  File::Find::Rule::Procedural, as people often seem to get
  confused that the method calls don't take anonymous arrays
  after seeing the procedural code that did

- Chunky internal restructure.  Now we compile a match sub
  from code fragments.  Though more complex, this is a big
  speed win as it eliminates a lot of the subroutine dispatch.

- During the restructure we lost the ->test method.  I hope
  that it's not missed, since maintining it through a
  deprecation cycle would be fiddly with the current _compile code.

- Split the findrule tests into their own file, and just skip
  the tricky ones on Win32.

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