NAME

File::Find::Rule::Perl - Common rules for searching for Perl things

SYNOPSIS

  use File::Find::Rule       ();
  use File::Find::Rule::Perl ();
  
  # Find all Perl files smaller than 10k
  my @files = File::Find::Rule->perl_file
                              ->size('<10Ki')
                              ->in( $dir );

DESCRIPTION

I write a lot of things that muck with Perl files. And it always annoyed me that finding "perl files" requires a moderately complex the File::Find::Rule manpage pattern.

File::Find::Rule::Perl provides methods for finding various Perl-related files.

METHODS

perl_module

The perl_module rule locates perl modules. That is, files that are named *.pm.

This rule is equivalent to ->file->name( '*.pm' )> and is included primarily for completeness.

perl_test

The perl_test rule locates perl test scripts. That is, files that are named *.t.

This rule is equivalent to ->file->name( '*.t' )> and is included primarily for completeness.

perl_installer

The perl_installer rule locates perl distribution installers. That is, it locates Makefile.PL and Build.PL files.

perl_script

The perl_script rule locates perl scripts.

This is any file that ends in .pl, or any files without extensions that have a perl "hash-bang" line.

perl_file

The perl_file rule locates all files containing Perl code.

This includes all the files matching the above perl_module, perl_test, perl_installer and perl_script rules.

SUPPORT

Bugs should always be submitted via the CPAN bug tracker

http://rt.cpan.org/NoAuth/ReportBug.html

For other issues, contact the maintainer

AUTHOR

Adam Kennedy <cpan@ali.as>

SEE ALSO

http://ali.as/, the File::Find::Rule manpage, the File::Find::Rule::PPI manpage

COPYRIGHT

Copyright 2006 Adam Kennedy. All rights reserved.

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

The full text of the license can be found in the LICENSE file included with this module.