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, 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.