JavaScript APG

Deprecated: Use apg-js instead. See apg-js-examples for usage.

See release notes

Description:

APG is an acronym for "ABNF Parser Generator". Originally written to generate parsers directly from ABNF syntax (RFC 5234) it has since grown to include a number of additional features requiring additional syntax terms. The resulting syntax is a superset of ABNF or SABNF. Some features have been primarily developed to support the new apg-exp pattern-matching application. A general description of how APG works is given here.

apg-exp features:

Other features:

Installation:
For command line usage:

git clone https://github.com/ldthomas/apg-js2.git apg
cd apg
npm install -g ./
apg -v

or just

npm install -g apg
apg -v

You should see something like:

JavaScript APG, version 3.0.0, Copyright (C) 2017 Lowell D. Thomas, all rights reserved

Note: If there is a name conflict on your system (for example, Automated Password Generator) there are a couple of options for resolving the conflict.

For the GUI version:

git clone https://github.com/ldthomas/apg-js2.git apg
cd apg
(double click the apg.html file)

Examples:
See apg-js2-examples for examples of running JavaScript APG and the parsers it generates.

Documentation:
The documentation is in the code in docco format. To generate the documentation, from the package directory:

npm install -g docco
./docco-gen

View docs/index.html in any web browser to get started. Or view it on the APG website

Copyright:
Copyright © 2017 Lowell D. Thomas, all rights reserved

License:
Released with the BSD-3-Clause license.