Grammar::Debugger and Grammer::Tracer Perl 6 modules
Perl6
Latest commit cfdd791 Feb 15, 2017 @jnthn committed on GitHub Merge pull request #30 from briandfoy/master
Some Pod docs
Permalink
Failed to load latest commit information.
lib/Grammar
t
.gitignore Tweak .gitignore. Feb 2, 2017
.travis.yml Add Travis config file. Nov 1, 2016
META.info Bump version, so it's easy to install the fixes. Feb 2, 2017
README.markdown Link to issues Feb 15, 2017

README.markdown

Grammar::Debugger Build Status

This module provides a simple debugger for grammars. Just use it:

use Grammar::Debugger;

And any grammar in the lexical scope of the use statement will automatically have debugging enabled. The debugger will break execution when you first enter the grammar, and provide a prompt. Type "h" for a list of commands.

If you are debugging a grammar and want to set up breakpoints in code rather than entering them manually at the debug prompt, you can apply the breakpoint trait to any rule:

token name is breakpoint { \w+ [\h+ \w+]* }

If you want to conditionally break, you can also do something like:

token name will break { $^m eq 'Russia' } { \w+ [\h+ \w+]* }

Which will only break after the name rule has matched "Russia".

Grammar::Tracer

This gives similar output to Grammar::Debugger, but just runs through the whole grammar without stopping until it is successful or fails. Once again, after a use:

use Grammar::Tracer;

It will apply to any grammars in the lexical scope of the use statement.

Bugs? Ideas?

Please file them in GitHub issues.