pegjs/lib/compiler/index.js

"use strict";

var arrays  = require("../utils/arrays"),
    objects = require("../utils/objects");

var compiler = {
  /*
   * AST node visitor builder. Useful mainly for plugins which manipulate the
   * AST.
   */
  visitor: require("./visitor"),

  /*
   * Compiler passes.
   *
   * Each pass is a function that is passed the AST. It can perform checks on it
   * or modify it as needed. If the pass encounters a semantic error, it throws
   * |peg.GrammarError|.
   */
  passes: {
    check: {
      reportMissingRules:  require("./passes/report-missing-rules"),
      reportLeftRecursion: require("./passes/report-left-recursion"),
      reportInfiniteLoops: require("./passes/report-infinite-loops")
    },
    transform: {
      removeProxyRules:    require("./passes/remove-proxy-rules")
    },
    generate: {
      generateBytecode:    require("./passes/generate-bytecode"),
      generateJS:          require("./passes/generate-js")
    }
  },

  /*
   * Generates a parser from a specified grammar AST. Throws |peg.GrammarError|
   * if the AST contains a semantic error. Note that not all errors are detected
   * during the generation and some may protrude to the generated parser and
   * cause its malfunction.
   */
  compile: function(ast, passes, options) {
    options = options !== void 0 ? options : {};

    var stage;

    options = objects.clone(options);
    objects.defaults(options, {
      allowedStartRules: [ast.rules[0].name],
      cache:             false,
      trace:             false,
      optimize:          "speed",
      output:            "parser",
      format:            "bare",
      dependencies:      {},
      exportVar:         null
    });

    for (stage in passes) {
      if (passes.hasOwnProperty(stage)) {
        arrays.each(passes[stage], function(p) { p(ast, options); });
      }
    }

    switch (options.output) {
      case "parser": return eval(ast.code);
      case "source": return ast.code;
    }
  }
};

module.exports = compiler;