lib/rubocop/ast/builder.rb



# frozen_string_literal: true

module RuboCop
  module AST
    # `RuboCop::AST::Builder` is an AST builder that is utilized to let `Parser`
    # generate ASTs with {RuboCop::AST::Node}.
    #
    # @example
    #   buffer = Parser::Source::Buffer.new('(string)')
    #   buffer.source = 'puts :foo'
    #
    #   builder = RuboCop::AST::Builder.new
    #   require 'parser/ruby25'
    #   parser = Parser::Ruby25.new(builder)
    #   root_node = parser.parse(buffer)
    class Builder < Parser::Builders::Default
      self.emit_forward_arg = true

      # @api private
      NODE_MAP = {
        and:          AndNode,
        alias:        AliasNode,
        args:         ArgsNode,
        array:        ArrayNode,
        block:        BlockNode,
        numblock:     BlockNode,
        break:        BreakNode,
        case_match:   CaseMatchNode,
        case:         CaseNode,
        class:        ClassNode,
        const:        ConstNode,
        def:          DefNode,
        defined?:     DefinedNode,
        defs:         DefNode,
        ensure:       EnsureNode,
        for:          ForNode,
        forward_args: ForwardArgsNode,
        float:        FloatNode,
        hash:         HashNode,
        if:           IfNode,
        int:          IntNode,
        index:        IndexNode,
        indexasgn:    IndexasgnNode,
        irange:       RangeNode,
        erange:       RangeNode,
        kwsplat:      KeywordSplatNode,
        lambda:       LambdaNode,
        module:       ModuleNode,
        next:         NextNode,
        or:           OrNode,
        pair:         PairNode,
        regexp:       RegexpNode,
        rescue:       RescueNode,
        resbody:      ResbodyNode,
        return:       ReturnNode,
        csend:        SendNode,
        send:         SendNode,
        str:          StrNode,
        dstr:         StrNode,
        xstr:         StrNode,
        sclass:       SelfClassNode,
        super:        SuperNode,
        zsuper:       SuperNode,
        sym:          SymbolNode,
        until:        UntilNode,
        until_post:   UntilNode,
        when:         WhenNode,
        while:        WhileNode,
        while_post:   WhileNode,
        yield:        YieldNode
      }.freeze

      # Generates {Node} from the given information.
      #
      # @return [Node] the generated node
      def n(type, children, source_map)
        node_klass(type).new(type, children, location: source_map)
      end

      # TODO: Figure out what to do about literal encoding handling...
      # More details here https://github.com/whitequark/parser/issues/283
      def string_value(token)
        value(token)
      end

      private

      def node_klass(type)
        NODE_MAP[type] || Node
      end
    end
  end
end