PEG parsing library for Open Dylan
Latest commit 02f43e2 Jul 20, 2014 @BarAgent BarAgent Merge pull request #5 from BarAgent/master
Removed dynamic-binding library from local registry and add docs.
Failed to load latest commit information.
.gitmodules Implement parser attributes using OD's dynamic-bind. Jul 6, 2014
parser-definers.dylan Fixed doc typos. Jul 20, 2014
parser-rules.dylan Clean up whitespace. Dec 10, 2012
peg-parser.lid Don't build an executable for peg-parser. Dec 10, 2012


=== Library: Peg-parser ===

This is a memoizing (or, more correctly, caching) recursive descent parser
that handles attributed parsing expression grammars (PEGs), as described at

It isn't too tricky to use. Basically, a PEG can act as both a lexical and
phrase grammar, and acts similarly to a forward-looking greedy regular
expression processor, except that it acts on tokens instead of characters.

This library allows for simple rules-based declarations and also custom parser
functions (you'll need some of these to get characters and literals from the

The parser can simplify and consolidate syntax elements in an upwards direction
along the syntax tree via token class slots, and downward or across the syntax
tree via dynamically-bound attributes. You can also define a context class to
keep global information for later semantic processing.

-- Dustin Voss

--- Compilation ---

Open Dylan currently has problems properly inferring types when compiling this
library into another project. It reports numerous spurious errors. To avoid
seeing these, pipe the compilation of libraries that 'use' [em] this library
through "egrep" [i] as follows:

| BASH: dylan-compiler ... 2>&1 | egrep -v '^$|^ |^[[:digit:]]|<parse-failure>|<parse-extent>'
| CSH:  dylan-compiler ... |& egrep -v '^$|^ |^[[:digit:]]|<parse-failure>|<parse-extent>'