Module: Rattler::BackEnd::ParserGenerator

Included in:
Optimizer::JoinMatchCapturingSequence
Defined in:
lib/rattler/back_end/parser_generator.rb,
lib/rattler/back_end/parser_generator/nested.rb,
lib/rattler/back_end/parser_generator/top_level.rb,
lib/rattler/back_end/parser_generator/group_match.rb,
lib/rattler/back_end/parser_generator/expr_generator.rb,
lib/rattler/back_end/parser_generator/fail_generator.rb,
lib/rattler/back_end/parser_generator/list_generator.rb,
lib/rattler/back_end/parser_generator/rule_generator.rb,
lib/rattler/back_end/parser_generator/skip_generator.rb,
lib/rattler/back_end/parser_generator/sub_generating.rb,
lib/rattler/back_end/parser_generator/apply_generator.rb,
lib/rattler/back_end/parser_generator/label_generator.rb,
lib/rattler/back_end/parser_generator/list1_generator.rb,
lib/rattler/back_end/parser_generator/list_generating.rb,
lib/rattler/back_end/parser_generator/match_generator.rb,
lib/rattler/back_end/parser_generator/token_generator.rb,
lib/rattler/back_end/parser_generator/assert_generator.rb,
lib/rattler/back_end/parser_generator/choice_generator.rb,
lib/rattler/back_end/parser_generator/gen_method_names.rb,
lib/rattler/back_end/parser_generator/skip_propogating.rb,
lib/rattler/back_end/parser_generator/repeat_generating.rb,
lib/rattler/back_end/parser_generator/token_propogating.rb,
lib/rattler/back_end/parser_generator/disallow_generator.rb,
lib/rattler/back_end/parser_generator/optional_generator.rb,
lib/rattler/back_end/parser_generator/rule_set_generator.rb,
lib/rattler/back_end/parser_generator/sequence_generator.rb,
lib/rattler/back_end/parser_generator/group_match_generator.rb,
lib/rattler/back_end/parser_generator/one_or_more_generator.rb,
lib/rattler/back_end/parser_generator/predicate_propogating.rb,
lib/rattler/back_end/parser_generator/zero_or_more_generator.rb,
lib/rattler/back_end/parser_generator/direct_action_generator.rb,
lib/rattler/back_end/parser_generator/back_reference_generator.rb,
lib/rattler/back_end/parser_generator/dispatch_action_generator.rb

Overview

A ParserGenerator generates ruby parsing code from parser models.

Author:

  • Jason Arhart

Defined Under Namespace

Modules: ListGenerating, Nested, NestedSubGenerating, PredicatePropogating, RepeatGenerating, SkipPropogating, SubGenerating, TokenPropogating, TopLevel, TopLevelSubGenerating Classes: ApplyGenerator, AssertGenerator, BackReferenceGenerator, ChoiceGenerator, DirectActionGenerator, DisallowGenerator, DispatchActionGenerator, ExprGenerator, FailGenerator, GroupMatch, GroupMatchGenerator, LabelGenerator, List1Generator, ListGenerator, MatchGenerator, NestedApplyGenerator, NestedAssertGenerator, NestedBackReferenceGenerator, NestedChoiceGenerator, NestedDirectActionGenerator, NestedDisallowGenerator, NestedDispatchActionGenerator, NestedFailGenerator, NestedGroupMatchGenerator, NestedLabelGenerator, NestedList1Generator, NestedListGenerator, NestedMatchGenerator, NestedOneOrMoreGenerator, NestedOptionalGenerator, NestedSequenceGenerator, NestedSkipGenerator, NestedTokenGenerator, NestedZeroOrMoreGenerator, OneOrMoreGenerator, OptionalGenerator, RuleGenerator, RuleSetGenerator, SequenceGenerator, SkipGenerator, TokenGenerator, TopLevelApplyGenerator, TopLevelAssertGenerator, TopLevelBackReferenceGenerator, TopLevelChoiceGenerator, TopLevelDirectActionGenerator, TopLevelDisallowGenerator, TopLevelDispatchActionGenerator, TopLevelFailGenerator, TopLevelGenerator, TopLevelGroupMatchGenerator, TopLevelLabelGenerator, TopLevelList1Generator, TopLevelListGenerator, TopLevelMatchGenerator, TopLevelOneOrMoreGenerator, TopLevelOptionalGenerator, TopLevelSequenceGenerator, TopLevelSkipGenerator, TopLevelTokenGenerator, TopLevelZeroOrMoreGenerator, ZeroOrMoreGenerator

Constant Summary collapse

GEN_METHOD_TYPES =
%w{
  basic assert disallow dispatch_action direct_action token skip
}
GEN_METHOD_NAMES =
GEN_METHOD_TYPES.map {|_| :"gen_#{_}" }

Class Method Summary collapse

Class Method Details

.code_for(grammar, opts) ⇒ String .code_for(rules, opts) ⇒ String .code_for(rule, opts) ⇒ String .code_for(parser, opts) ⇒ String

Generate parsing code for parser using a new RubyGenerator with the given options and return the generated code.

Overloads:

  • .code_for(grammar, opts) ⇒ String

    Returns the generated code.

    Parameters:

    Returns:

    • (String)

      the generated code

  • .code_for(rules, opts) ⇒ String

    Returns the generated code.

    Parameters:

    • rules (Rules)

      the parse rules

    Returns:

    • (String)

      the generated code

  • .code_for(rule, opts) ⇒ String

    Returns the generated code.

    Parameters:

    • rule (Rule)

      the parse rule

    Returns:

    • (String)

      the generated code

  • .code_for(parser, opts) ⇒ String

    Returns the generated code.

    Parameters:

    • parser (Parser)

      the parser model

    Returns:

    • (String)

      the generated code



103
104
105
# File 'lib/rattler/back_end/parser_generator.rb', line 103

def self.code_for(parser, opts={})
  ::Rattler::BackEnd::RubyGenerator.code(opts) {|g| generate g, parser, opts }
end

.generate(g, grammar) ⇒ Object .generate(g, rules) ⇒ Object .generate(g, rule) ⇒ Object .generate(g, parser) ⇒ Object

Generate parsing code for a parser model using a ruby generator g.

Overloads:

  • .generate(g, grammar) ⇒ Object

    Returns g.

    Parameters:

    Returns:

    • g

  • .generate(g, rules) ⇒ Object

    Returns g.

    Parameters:

    • g (RubyGenerator)

      the ruby generator to use

    • rules (Rules)

      the parse rules

    Returns:

    • g

  • .generate(g, rule) ⇒ Object

    Returns g.

    Parameters:

    • g (RubyGenerator)

      the ruby generator to use

    • rule (Rule)

      the parse rule

    Returns:

    • g

  • .generate(g, parser) ⇒ Object

    Returns g.

    Parameters:

    • g (RubyGenerator)

      the ruby generator to use

    • parser (Parser)

      the parser model

    Returns:

    • g



76
77
78
79
80
81
82
# File 'lib/rattler/back_end/parser_generator.rb', line 76

def self.generate(g, parser, opts={})
  unless opts[:no_optimize]
    parser = ::Rattler::BackEnd::Optimizer.optimize(parser, opts)
  end
  RuleSetGenerator.new(g).generate(parser, opts)
  g
end