jison-helpers-lib

![npm]()

Helper functions shared among the jison repositories (jison, ebnf-parser, lex-parser, jison-lex)

install

npm install @gerhobbelt/jison-helpers-lib

or the entire bundle via

npm install jison-gho

Then the jison-helpers library is located in the subdirectory packages/helpers-lib/ of the jison-gho monorepo, i.e. .../node_modules/jison-gho/packages/helpers-lib/.

Alternatively, most parts of the helpers-lib API are also available via the jison API itself as can be seen from this internal jison code snippet:

``
import Lexer from '../packages/jison-lex';
import ebnfParser from '../packages/ebnf-parser';
import lexParser from '../packages/lex-parser';
import grammarPrinter from './util/grammar-printer.js';
import helpers from '../packages/helpers-lib';
var rmCommonWS = helpers.rmCommonWS;
var camelCase = helpers.camelCase;
var code_exec = helpers.exec;
import XRegExp from '@gerhobbelt/xregexp';
import recast from '@gerhobbelt/recast';
import astUtils from '@gerhobbelt/ast-util';
import json5 from '@gerhobbelt/json5';

// Also export other APIs: the JISON module should act as a 'facade' for the others,
// so applications using the JISON compiler itself can rely on it providing everything
// in a guaranteed compatible version as it allows userland code to use the precise
// same APIs as JISON will be using itself:
Jison.Lexer = Lexer;
Jison.ebnfParser = ebnfParser;
Jison.lexParser = lexParser;
Jison.codeExec = code_exec;
Jison.XRegExp = XRegExp;
Jison.recast = recast;
Jison.astUtils = astUtils;
Jison.JSON5 = json5;
Jison.prettyPrint = grammarPrinter;
Jison.rmCommonWS = rmCommonWS;
Jison.mkStdOptions = mkStdOptions;
Jison.camelCase = camelCase;
Jison.autodetectAndConvertToJSONformat = autodetectAndConvertToJSONformat;
...
Jison.Parser = Parser;

export default Jison;
`

hence you can get at it this way, for example:

`
import jisonAPI from 'jison-gho';
// get a reference to the parts of the jison-helpers-lib API:
const codeExec = jisonAPI.codeExec;
...etc...
`

build

Follow the install & build directions of the monorepo.

You can also only build this particular subpackage by cd-ing into this directory
and then invoking the local make:

cd packages/helpers-lib
make

This will generate the rollup/babel-postprocessed ES6 and ES5
compatible libraries in the local dist/ directory.

>
> ### Note about ES6/rollup usage vs. ES5
>
> All dist/ library files are 'self-contained': they include all 'local imports'
> from within this jison monorepo in order to deliver a choice of source files
> for your perusal where you only need to worry about importing external dependencies
> (such as recast).
>
> As such, these dist/ files should be easier to minify and/or use in older
> (ES5) environments.
>
> #### rollup
>
> Iff you use rollup or similar tools in an ES6/ES2015/ES2017 setting, then the
> package.json::module has
> already been set up for you to use the original sources instead!
>

usage

`
var helpers = require('jison-helpers-lib');

...
``

license

MIT

related repositories

- jison / jison-gho @ NPM
- jison-lex @ NPM
- lex-parser @ NPM
- ebnf-parser @ NPM
- jison2json @ NPM
- json2jison @ NPM
- jison-helpers-lib @ NPM
- ### secondary source repositories
+ jison-lex
+ lex-parser
+ ebnf-parser
+ jison2json
+ json2jison
+ jison-helpers-lib