README for File::Find::Rule 0.29
=head1 NAME
File::Find::Rule - Alternative interface to File::Find
=head1 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 );
=head1 DEPENDENCIES
This module has external dependencies on the following modules:
Cwd
File::Find
File::Spec
Number::Compare
Test::More
Text::Glob
=head1 INSTALLATION
perl Build.PL
perl Build test
and if all goes well
perl Build install
=head1 HISTORY
What changed over the last 3 revisions
=over
=item 0.29 Tuesday 16th May, 2006
Kludged around {min,max}depth and trailing slashes in path
names.
=item 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
=item 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.
=back
=head1 AUTHOR
Richard Clamp <
[email protected]> 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
[email protected].
=head1 COPYRIGHT
Copyright (C) 2002, 2003, 2004, 2006 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.
=head1 SEE ALSO
L<File::Find>, L<Text::Glob>, L<Number::Compare>, find(1)
If you want to know about the procedural interface, see
L<File::Find::Rule::Procedural>, and if you have an idea for a neat
extension L<File::Find::Rule::Extending>