File::Find::Rule::PPI.3pm

Langue: en

Autres versions - même langue

Version: 2006-09-10 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

File::Find::Rule::PPI - Add support for PPI queries to File::Find::Rule

SYNOPSIS

   use File::Find::Rule      ();
   use File::Find::Rule::PPI ();
 
   # Find all perl modules that use here-docs
   my $Find = File::Find::Rule->file
                              ->name('*.pm')
                              ->ppi_find_any('Token::HereDoc');
   my @heredoc = $Find->in( $dir );

DESCRIPTION

File::Find::Rule::PPI allows you to integrate PPI content queries into your File::Find::Rule searches.

Initially, it provides the one additional method "ppi_find_any", which takes an argument identical to the PPI::Node method "find_any" and checks each file as a perl document to see if matches the query.

METHODS

ppi_find_any $condition | $PPI::Find

The "ppi_find_any" method causes a query identical to (and implemented using) PPI::Node's "find_any" method.

It takes as argument any condition that would also be valid for the above method.

In addition, it can also take as argument an instantiated PPI::Find object, and will use that object's "any_matches" method to achieve the same effect.

If you provide no or an illegal condition to ppi_find_any, the check will always fail, and no files will be returned when you execute the search.

SUPPORT

Bugs should always be submitted via the CPAN bug tracker

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=File-Find-Rule-PPI <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=File-Find-Rule-PPI>

For other issues, contact the maintainer

AUTHOR

Adam Kennedy <adamk@cpan.org>

ACKNOWLEDGMENTS

Funding provided by The Perl Foundation

SEE ALSO

<http://ali.as/>, File::Find::Rule, PPI Copyright 2005, 2006 Adam Kennedy.

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.