Library of core parsing functions for the JavaScript APG Version 2.0 parser generator and the parsers it generates.
JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
LICENSE Final updates for publication. Jun 21, 2017
README.md Final updates for publication. Jun 21, 2017
apg-lib-min.css Renamed export.js -> exports.js. Made compatible with the new apg-con… Apr 15, 2017
apg-lib-min.js Final updates for publication. Jun 21, 2017
apg-lib.css Renamed export.js -> exports.js. Made compatible with the new apg-con… Apr 15, 2017
apg-lib.js Final updates for publication. Jun 21, 2017
docco-gen Removed gulp. The build was simple enough to do with a bash script. Jan 20, 2017
index.md
package.json 3.2.0 Jun 21, 2017

README.md

JavaScript APG Parsing Library

Description

The JavaScript APG Parsing Library contains the basic core support code needed to run both apg, the parser generator, and the parsers that it generates.

Installation

github:

git clone https://github.com/ldthomas/apg-js2-lib.git /path/to/my-copy-of-apg-lib
mkdir my-project 
cd my-project 
npm init
npm install /path/to/my-copy-of-apg-lib --save

npm:

mkdir my-project 
cd my-project 
npm init
npm install apg-lib --save

In your application code you can now access the apg library with require("apg-lib") (see examples)

Web page use

git clone https://github.com/ldthomas/apg-js2-lib.git apg-dir

In the header of your web page now include the resources:

<link rel="stylesheet" href="./apg-dir/apglib.css">
<script src="./apg-dir/apglib.js" charset="utf-8"></script>
or
<link rel="stylesheet" href="./apg-dir/apglib-min.css">
<script src="./apg-dir/apglib-min.js" charset="utf-8"></script>

Note that some apg-lib functions return results as HTML strings. apglib.css is required to properly style the HTML elements. In your web page JavaSript code you can now access the apg-lib modules through the apglib object. For example, to create a parser

var my-parser = new apglib.parser();

See the browser example, for specifics. See, also, this CodePen.

Examples

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

Documentation

The full 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 under the BSD-3-Clause license.