NAME
preslurp - Analyze the regular expressions in a bunch of files
SYNOPSIS
preslurp -recurse .
For full details on usage, use
preslurp -help
DETAILS
This script makes PPI::Document objects out of files it deems are Perl, then does a PPIx::Regexp::Dumper dump on all PPI::Token::StringLike::Regexp, PPI::Token::Regexp::Match and PPI::Token::Regexp::Substitute objects it finds.
The following options control its use:
- -archive
-
If this option is asserted, it specifies that any archive files found should be expanded and their contents searched. This option implies
-recurse
. This option is only available if Archive::Any is installed. - -encoding name
-
This option specifies the encoding of the files. It is passed directly to PPIx::Regexp and PPIx::Regexp::Dumper.
- -failures
-
If this option is asserted, only regular expressions with parse failures are reported.
- -help
-
If this option is asserted, this documentation is displayed and the script exits.
- -ignore filename
-
This option specifies the name of a file containing a list of files to ignore. The files are specified as regular expressions, listed one per line. Blank lines and lines beginning with '#' are ignored.
- -include
-
If this option is asserted, it specifies that the contents of
@INC
be added to the files to be checked. It also causes -recurse to be asserted. - -ordinal
-
If this option is asserted, it specifies that the ordinal value of any PPIx::Regexp::Token::Literal objects be displayed in the dump. In reality, this option is simply passed to PPIx::Regexp::Dumper.
- -recurse
-
If this option is specified, this script recurses into any directories found.
- -significant
-
If this option is asserted, only significant
PPIx::Regexp
objects are dumped. In reality, this option is simply passed to PPIx::Regexp::Dumper. - -tokens
-
If this option is asserted, only PPIx::Regexp::Token objects are dumped. In reality, this option is simply passed to PPIx::Regexp::Dumper.
- -verbose
-
If this option is asserted, you get a more verbose dump, though what that means is undocumented. In reality, this option is simply passed to PPIx::Regexp::Dumper.
SUPPORT
Support is by the author. Please file bug reports at http://rt.cpan.org, or in electronic mail to the author.
AUTHOR
Thomas R. Wyant, III wyant at cpan dot org
COPYRIGHT AND LICENSE
Copyright (C) 2009-2010, Thomas R. Wyant, III
This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.
This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.