1File::Find::Rule::PPI(3U)ser Contributed Perl DocumentatiFoinle::Find::Rule::PPI(3)
2
3
4
6 File::Find::Rule::PPI - Add support for PPI queries to File::Find::Rule
7
9 use File::Find::Rule ();
10 use File::Find::Rule::PPI ();
11
12 # Find all perl modules that use here-docs
13 my $Find = File::Find::Rule->file
14 ->name('*.pm')
15 ->ppi_find_any('Token::HereDoc');
16 my @heredoc = $Find->in( $dir );
17
19 File::Find::Rule::PPI allows you to integrate PPI content queries into
20 your File::Find::Rule searches.
21
22 Initially, it provides the one additional method "ppi_find_any", which
23 takes an argument identical to the PPI::Node method "find_any" and
24 checks each file as a perl document to see if matches the query.
25
27 ppi_find_any $condition | $PPI::Find
28 The "ppi_find_any" method causes a query identical to (and implemented
29 using) PPI::Node's "find_any" method.
30
31 It takes as argument any condition that would also be valid for the
32 above method.
33
34 In addition, it can also take as argument an instantiated PPI::Find
35 object, and will use that object's "any_matches" method to achieve the
36 same effect.
37
38 If you provide no or an illegal condition to ppi_find_any, the check
39 will always fail, and no files will be returned when you execute the
40 search.
41
43 Bugs should always be submitted via the CPAN bug tracker
44
45 <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=File-Find-Rule-PPI>
46
47 For other issues, contact the maintainer
48
50 Adam Kennedy <adamk@cpan.org>
51
53 Funding provided by The Perl Foundation
54
56 <http://ali.as/>, File::Find::Rule, PPI
57
59 Copyright 2005 - 2010 Adam Kennedy.
60
61 This program is free software; you can redistribute it and/or modify it
62 under the same terms as Perl itself.
63
64 The full text of the license can be found in the LICENSE file included
65 with this module.
66
67
68
69perl v5.28.0 2010-10-06 File::Find::Rule::PPI(3)