NAME

prenav - Navigate a PPIx::Regexp parse tree

SYNOPSIS

 prenav 's/(\w+)/\u$1/g'
 prenav> find_first Token::CharClass::Simple
 PPIx::Regexp::Token::CharClass::Simple  \w
 prenav> dump verbose 1
 PPIx::Regexp::Token::CharClass::Simple  '\\w'  significant
     can_be_quantified
 prenav> parent
 PPIx::Regexp::Structure::Capture    (\w+)
 prenav> exit

DESCRIPTION

This script takes as its argument a string to be parsed as a regular expression, and prompts the user for navigation commands. A navigation command is any method that returns another element in the parse tree.

Unless documented otherwise, all commands apply to the current object. Initially the current object is the PPIx::Regexp object generated by the parse. Once a navigation command is issued, the object navigated to becomes the current object. If the navigation command does not specify an object (e.g. child 5 when the current object has fewer than 5 children) the current object remains unchanged.

In addition to the navigation methods, any method that returns a scalar value can be used as a command. The value returned will be displayed.

In addition to all the above, the following commands are recognized:

capture_names

This command wraps the PPIx::Regexp->capture_names() method, joining the results into a comma-delimited string.

dump

This command dumps the current object. Options to PPIx::Regexp::Dumper->new()

exit

This comamnd terminates the script.

help

This command displays this documentation.

 nav

This command displays the method calls and arguments needed to navigate from the root of the parse tree to the current object. Yes, this is a perfectly good method, but we wrap the results of that method in some semi-nice formatting.

Any arguments are ignored

parse
 parse s/ ( \w+ ) foo \1 /bar/smx

This command provides another regular expression to parse. If the parse succeeds, the previous regular expression is abandoned, and the new PPIx::Regexp object becomes the current object.

The new regular expression is taken to be everything on the line after the whit espace after the word parse. It should not be quoted.

reset

This command selects the top-level object as the current object. The top command does the same thing, but top does it by running through the parent chain, where reset simply slam-dunks the retained PPIx::Regexp object.

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.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 160:

Nested L<> are illegal. Pretending inner one is X<...> so can continue looking for other errors.

Unterminated L< ... > sequence