(Deprecated: use apg-js instead.) An ABNF Parser Generator - generates recursive-descent parsers from grammars written in a superset of Augmented Backus-Naur Form (ABNF)
npm install 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:
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.
npm prefix -g) is left-most in the $PATH variable and clear the cache withhash -r/my/npm/prefix, create an aliasalias apg='/my/npm/prefix/bin/apg'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.