Pegex - Acmeist PEG Parsing Framework
use Pegex; my $result = pegex($grammar)->parse($input);
or with options:
use Pegex; use ReceiverClass; my $parser = pegex($grammar, receiver => 'ReceiverClass'); my $result = $parser->parse($input);
or more explicitly:
use Pegex::Parser; use Pegex::Grammar; my $pegex_grammar = Pegex::Grammar->new( text => $grammar, ); my $parser = Pegex::Parser->new( grammar => $pegex_grammar, ); my $result = $parser->parse($input);
or customized explicitly:
{ package MyGrammar; use Pegex::Base; extends 'Pegex::Grammar'; has text => "your grammar definition text goes here"; has receiver => "MyReceiver"; } { package MyReceiver; use base 'Pegex::Receiver'; got_some_rule { ... } got_other_rule { ... } } use Pegex::Parser; my $parser = Pegex::Parser->new( grammar => MyGrammar->new, receiver => MyReceiver->new, ); $parser->parse($input); my $result = $parser->receiver->data;
Pegex is a Acmeist parser framework. It allows you to easily create parsers that will work equivalently in lots of programming languages!
Pegex gets it name by combining Parsing Expression Grammars (PEG), with Regular Expessions (Regex). That's actually what Pegex does.
PEG is the cool new way to elegantly specify recursive descent grammars. The Perl 6 language is defined in terms of a self modifying PEG language called Perl 6 Rules. Regexes are familiar to programmers of most modern programming languages. Pegex defines a simple PEG syntax, where all the terminals are regexes. This means that Pegex can be quite fast and powerful.
Pegex attempts to be the simplest way to define new (or old) Domain Specific Languages (DSLs) that need to be used in several programming languages and environments.
The Pegex.pm module itself (this module) is just a trivial way to use the Pegex framework. It is only intended for the simplest of uses.
Pegex.pm
This module exports a single function, pegex, which takes a Pegex grammar string as input. You may also pass named parameters after the grammar.
pegex
my $parser = pegex($grammar, receiver => 'MyReceiver');
The pegex function returns a Pegex::Parser object, on which you would typically call the parse() method, which (on success) will return a data structure of the parsed data.
parse()
See Pegex::API for more details.
Pegex::Overview
Pegex::API
Pegex::Syntax
Pegex::Tutorial
Pegex::Resources
http://github.com/ingydotnet/pegex-pm
irc.freenode.net#pegex
Ingy döt Net <ingy@cpan.org>
Copyright (c) 2010, 2011, 2012. 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 http://www.perl.com/perl/misc/Artistic.html
To install Pegex, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Pegex
CPAN shell
perl -MCPAN -e shell install Pegex
For more information on module installation, please visit the detailed CPAN module installation guide.