Provided by: libpegex-perl_0.70-1_all bug


       Pegex::Grammar - Pegex Grammar Base Class


       Define a Pegex grammar (for the Foo syntax):

           package Pegex::Foo::Grammar;
           use base 'Pegex::Base';
           extends 'Pegex::Grammar';

           has text => q{
           foo: bar baz
           ... rest of Foo grammar ...

       then use it to parse some Foo:

           use Pegex::Parser;
           my $parse_tree = Pegex::Parser->new(
               grammar => 'Pegex::Foo::Grammar',
               receiver => 'Pegex::Tree',


       Pegex::Grammar is a base class for defining your own Pegex grammar classes.  You just need
       to provide the grammar view the "text" or the "file" attributes.

       When Pegex::Parser uses your grammar, it will want it in the tree (compiled) form, so
       Pegex::Grammar provides automatic compilation support.


           This is the data structure containing the compiled grammar for your syntax. It is
           usually produced by "Pegex::Compiler". You can inline it in the "tree" method, or else
           the "make_tree" method will be called to produce it.

           The "make_tree" method will call on Pegex::Compiler to compile the "text" property by
           default. You can define your own "make_tree" method to do override this behavior.

           Often times you will want to generate your own Pegex::Grammar subclasses in an
           automated fashion. The Pegex and TestML modules do this to be performant. This also
           allows you to keep your grammar text in a separate file, and often in a separate
           repository, so it can be shared by multiple programming language's module

           See <> and

           This is simply the text of your grammar, if you define this, you should (probably) not
           define the "tree" property. This grammar text will be automatically compiled when the
           "tree" is required.

           This is the file where your Pegex grammar lives. It is usually used when you are
           making a Pegex module. The path is relative to your top level module directory.

           This method is called when the grammar needs the compiled version.


       Ingy döt Net <>


       Copyright 2010-2018. Ingy döt Net.

       This program is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.

       See <>