pegjs-override-action

Override action (PEGjs plugin)

PEGjs override action

Override action (PEGjs plugin)

Reason

This plugin came to life, as part of a process of referencing basic PEGs and build structure outside of the PEGs. In essence, it gives the possibility for reusable PEGs.

E.g. A collection of core PEGjs grammars (RFC, ISO, etc.)

Usage

npm install pegjs-override-action

PEG = require 'pegjs'
overrideAction = require 'pegjs-override-action'
 
parser = PEG.buildParser "start = 'a' / 'b' / 'c' / 'd' { return 'd' } / 'e'",
  plugins: [overrideAction]
  overrideActionPlugin:
    initializer: "_ = require('lodash');"
    rules:
      start: [
        () -> "b"
        "return 'a';"
        undefined
        '__skip__' # equivalent to undefined atm 
        () -> _.VERSION
      ]
 
parser.parse 'a' # 'b' 
parser.parse 'b' # 'a' 
parser.parse 'c' # 'c' 
parser.parse 'd' # 'd' 
parser.parse 'e' # e.g. 1.3.1

When defining an action as a function, it will be stringified and injected into a different scope, which breaks variable closure. Any data or functions that need to be shared between rule actions should be defined in your initializer block. When using require in your actions or initializer, it is a good idea to resolve an absolute path (e.g. using require.resolve as the code is also executed in a different path than where it is defined.

Convenience

PEG = require 'pegjs'
{makeBuildParser} = require 'pegjs-override-action'
 
buildParser = makeParser {
  PEG
  grammar: "start = 'a' / 'b' / 'c' / 'd' { return 'd' } / 'e'"
  initializer: "_ = require('lodash');"
  rules:
    start: [
      () -> "b"
      "return 'a';"
      undefined
      '__skip__' # equivalent to undefined atm 
      () -> _.VERSION
    ]
  mixins: {} # list of default rules 
 
parser = buildParser {
  startRule: 'start'
  options: {} # 
}
 
parser.parse 'a' # 'b' 
parser.parse 'b' # 'a' 
parser.parse 'c' # 'c' 
parser.parse 'd' # 'd' 
parser.parse 'e' # e.g. 1.3.1

License

UNLICENSE

Develop front-end JavaScript?

Help us make npm better.

Tell us how you develop, build, and ship front-end JavaScript, and we’ll help make it easier. Take the survey »

how? learn more

andreineculau published 2014-05-31T22:09:36.288Z
0.2.3 is the latest of 15 releases
github.com/andreineculau/pegjs-override-action
Unlicense

Collaborators

Stats

0 downloads in the last day
46 downloads in the last week
192 downloads in the last month
Have an issue? File it. on GitHub
on GitHub

Stats

Try it out

Keywords

Dependencies (2)