config.yml

tokens:
  - name: EOF
    value: 0
    comment: final token in the file
  - name: INVALID
    comment: "an invalid token"
  - name: MISSING
    comment: "a token that was expected but not found"
  - name: NOT_PROVIDED
    comment: "a token that was not present but it is okay"
  - name: AMPERSAND
    comment: "&"
  - name: AMPERSAND_AMPERSAND
    comment: "&&"
  - name: AMPERSAND_AMPERSAND_EQUAL
    comment: "&&="
  - name: AMPERSAND_DOT
    comment: "&."
  - name: AMPERSAND_EQUAL
    comment: "&="
  - name: BACK_REFERENCE
    comment: "a back reference"
  - name: BACKTICK
    comment: "`"
  - name: BANG
    comment: "!"
  - name: BANG_AT
    comment: "!@"
  - name: BANG_EQUAL
    comment: "!="
  - name: BANG_TILDE
    comment: "!~"
  - name: BRACE_LEFT
    comment: "{"
  - name: BRACE_RIGHT
    comment: "}"
  - name: BRACKET_LEFT
    comment: "["
  - name: BRACKET_LEFT_RIGHT
    comment: "[]"
  - name: BRACKET_RIGHT
    comment: "]"
  - name: CARET
    comment: "^"
  - name: CARET_EQUAL
    comment: "^="
  - name: CHARACTER_LITERAL
    comment: "a character literal"
  - name: CLASS_VARIABLE
    comment: "a class variable"
  - name: COLON
    comment: ":"
  - name: COLON_COLON
    comment: "::"
  - name: COMMA
    comment: ","
  - name: COMMENT
    comment: "a comment"
  - name: CONSTANT
    comment: "a constant"
  - name: DOT
    comment: "."
  - name: DOT_DOT
    comment: ".."
  - name: DOT_DOT_DOT
    comment: "..."
  - name: EMBDOC_BEGIN
    comment: "=begin"
  - name: EMBDOC_END
    comment: "=end"
  - name: EMBDOC_LINE
    comment: "a line inside of embedded documentation"
  - name: EMBEXPR_BEGIN
    comment: "#{"
  - name: EMBEXPR_END
    comment: "}"
  - name: EMBVAR
    comment: "#"
  - name: EQUAL
    comment: "="
  - name: EQUAL_EQUAL
    comment: "=="
  - name: EQUAL_EQUAL_EQUAL
    comment: "==="
  - name: EQUAL_GREATER
    comment: "=>"
  - name: EQUAL_TILDE
    comment: "=~"
  - name: FLOAT
    comment: "a floating point number"
  - name: GREATER
    comment: ">"
  - name: GREATER_EQUAL
    comment: ">="
  - name: GREATER_GREATER
    comment: ">>"
  - name: GREATER_GREATER_EQUAL
    comment: ">>="
  - name: GLOBAL_VARIABLE
    comment: "a global variable"
  - name: IDENTIFIER
    comment: "an identifier"
  - name: IMAGINARY_NUMBER
    comment: "an imaginary number literal"
  - name: INSTANCE_VARIABLE
    comment: "an instance variable"
  - name: INTEGER
    comment: "an integer (any base)"
  - name: KEYWORD___ENCODING__
    comment: "__ENCODING__"
  - name: KEYWORD___LINE__
    comment: "__LINE__"
  - name: KEYWORD___FILE__
    comment: "__FILE__"
  - name: KEYWORD_ALIAS
    comment: "alias"
  - name: KEYWORD_AND
    comment: "and"
  - name: KEYWORD_BEGIN
    comment: "begin"
  - name: KEYWORD_BEGIN_UPCASE
    comment: "BEGIN"
  - name: KEYWORD_BREAK
    comment: "break"
  - name: KEYWORD_CASE
    comment: "case"
  - name: KEYWORD_CLASS
    comment: "class"
  - name: KEYWORD_DEF
    comment: "def"
  - name: KEYWORD_DEFINED
    comment: "defined?"
  - name: KEYWORD_DO
    comment: "do"
  - name: KEYWORD_ELSE
    comment: "else"
  - name: KEYWORD_ELSIF
    comment: "elsif"
  - name: KEYWORD_END
    comment: "end"
  - name: KEYWORD_END_UPCASE
    comment: "END"
  - name: KEYWORD_ENSURE
    comment: "ensure"
  - name: KEYWORD_FALSE
    comment: "false"
  - name: KEYWORD_FOR
    comment: "for"
  - name: KEYWORD_IF
    comment: "if"
  - name: KEYWORD_IN
    comment: "in"
  - name: KEYWORD_MODULE
    comment: "module"
  - name: KEYWORD_NEXT
    comment: "next"
  - name: KEYWORD_NIL
    comment: "nil"
  - name: KEYWORD_NOT
    comment: "not"
  - name: KEYWORD_OR
    comment: "or"
  - name: KEYWORD_REDO
    comment: "redo"
  - name: KEYWORD_RESCUE
    comment: "rescue"
  - name: KEYWORD_RETRY
    comment: "retry"
  - name: KEYWORD_RETURN
    comment: "return"
  - name: KEYWORD_SELF
    comment: "self"
  - name: KEYWORD_SUPER
    comment: "super"
  - name: KEYWORD_THEN
    comment: "then"
  - name: KEYWORD_TRUE
    comment: "true"
  - name: KEYWORD_UNDEF
    comment: "undef"
  - name: KEYWORD_UNLESS
    comment: "unless"
  - name: KEYWORD_UNTIL
    comment: "until"
  - name: KEYWORD_WHEN
    comment: "when"
  - name: KEYWORD_WHILE
    comment: "while"
  - name: KEYWORD_YIELD
    comment: "yield"
  - name: LABEL
    comment: "a label"
  - name: LABEL_END
    comment: "the end of a label"
  - name: LAMBDA_BEGIN
    comment: "{"
  - name: LESS
    comment: "<"
  - name: LESS_EQUAL
    comment: "<="
  - name: LESS_EQUAL_GREATER
    comment: "<=>"
  - name: LESS_LESS
    comment: "<<"
  - name: LESS_LESS_EQUAL
    comment: "<<="
  - name: MINUS
    comment: "-"
  - name: MINUS_AT
    comment: "-@"
  - name: MINUS_EQUAL
    comment: "-="
  - name: MINUS_GREATER
    comment: "->"
  - name: NEWLINE
    comment: "a newline character outside of other tokens"
  - name: NTH_REFERENCE
    comment: "an nth global variable reference"
  - name: PARENTHESIS_LEFT
    comment: "("
  - name: PARENTHESIS_RIGHT
    comment: ")"
  - name: PERCENT
    comment: "%"
  - name: PERCENT_EQUAL
    comment: "%="
  - name: PERCENT_LOWER_I
    comment: "%i"
  - name: PERCENT_LOWER_W
    comment: "%w"
  - name: PERCENT_LOWER_X
    comment: "%x"
  - name: PERCENT_UPPER_I
    comment: "%I"
  - name: PERCENT_UPPER_W
    comment: "%W"
  - name: PIPE
    comment: "|"
  - name: PIPE_EQUAL
    comment: "|="
  - name: PIPE_PIPE
    comment: "||"
  - name: PIPE_PIPE_EQUAL
    comment: "||="
  - name: PLUS
    comment: "+"
  - name: PLUS_AT
    comment: "+@"
  - name: PLUS_EQUAL
    comment: "+="
  - name: QUESTION_MARK
    comment: "?"
  - name: RATIONAL_NUMBER
    comment: "a rational number literal"
  - name: REGEXP_BEGIN
    comment: "the beginning of a regular expression"
  - name: REGEXP_END
    comment: "the end of a regular expression"
  - name: SEMICOLON
    comment: ";"
  - name: SLASH
    comment: "/"
  - name: SLASH_EQUAL
    comment: "/="
  - name: STAR
    comment: "*"
  - name: STAR_EQUAL
    comment: "*="
  - name: STAR_STAR
    comment: "**"
  - name: STAR_STAR_EQUAL
    comment: "**="
  - name: STRING_BEGIN
    comment: "the beginning of a string"
  - name: STRING_CONTENT
    comment: "the contents of a string"
  - name: STRING_END
    comment: "the end of a string"
  - name: SYMBOL_BEGIN
    comment: "the beginning of a symbol"
  - name: TILDE
    comment: "~"
  - name: TILDE_AT
    comment: "~@"
  - name: WORDS_SEP
    comment: "a separator between words in a list"
  - name: __END__
    comment: "marker for the point in the file at which the parser should stop"
nodes:
  - name: AliasNode
    child_nodes:
      - name: keyword
        type: token
      - name: new_name
        type: node
      - name: old_name
        type: node
    location: keyword->old_name
    comment: |
      Represents the use of the `alias` keyword.

          alias foo bar
          ^^^^^^^^^^^^^
  - name: AndNode
    child_nodes:
      - name: left
        type: node
      - name: operator
        type: token
      - name: right
        type: node
    location: left->right
    comment: |
      Represents the use of the `&&` operator or the `and` keyword.

          left and right
          ^^^^^^^^^^^^^^
  - name: ArgumentsNode
    child_nodes:
      - name: arguments
        type: node[]
    location: arguments
    comment: |
      Represents a set of arguments to a method or a keyword.

          return foo, bar, baz
                 ^^^^^^^^^^^^^
  - name: ArrayNode
    child_nodes:
      - name: opening
        type: token
      - name: elements
        type: node[]
      - name: closing
        type: token
    location: opening->closing
    comment: |
      Represents an array literal. This can be a regular array using brackets or
      a special array using % like %w or %i.

          [1, 2, 3]
          ^^^^^^^^^
  - name: AssocNode
    child_nodes:
      - name: key
        type: node
      - name: operator
        type: token?
      - name: value
        type: node
    location: key->value
    comment: |
      Represents a hash key/value pair.

          { a => b }
            ^^^^^^
  - name: AssocSplatNode
    child_nodes:
      - name: operator
        type: token
      - name: value
        type: node
    location: operator->value
    comment: |
      Represents a splat in a hash literal.

          { **foo }
            ^^^^^
  - name: BeginNode
    child_nodes:
      - name: begin_keyword
        type: token
      - name: statements
        type: node
      - name: rescue_clause
        type: node?
      - name: else_clause
        type: node?
      - name: ensure_clause
        type: node?
      - name: end_keyword
        type: token?
    location: begin_keyword->ensure_clause|end_keyword|statements
    comment: |
      Represents a begin statement.

          begin
            foo
          end
          ^^^^^
  - name: BlockParameterNode
    child_nodes:
      - name: operator
        type: token
      - name: name
        type: token?
    location: operator->name|operator
    comment: |
      Represents a block parameter to a method, block, or lambda definition.

          def a(&b)
                ^^
          end
  - name: BreakNode
    child_nodes:
      - name: keyword
        type: token
      - name: arguments
        type: node?
    location: keyword->arguments|keyword
    comment: |
      Represents the use of the `break` keyword.

          break foo
          ^^^^^^^^^
  - name: CallNode
    child_nodes:
      - name: receiver
        type: node?
      - name: call_operator
        type: token?
      - name: message
        type: token
      - name: lparen
        type: token?
      - name: arguments
        type: node?
      - name: rparen
        type: token?
      - name: name
        type: string
    location: receiver|message->rparen|arguments|message
    comment: |
      Represents a method call, in all of the various forms that that can take.

          foo
          ^^^

          +foo
          ^^^^

          foo + bar
          ^^^^^^^^^

          foo.bar
          ^^^^^^^
  - name: ClassNode
    child_nodes:
      - name: scope
        type: node
      - name: class_keyword
        type: token
      - name: constant_path
        type: node
      - name: inheritance_operator
        type: token?
      - name: superclass
        type: node?
      - name: statements
        type: node
      - name: end_keyword
        type: token
    location: class_keyword->end_keyword
    comment: |
      Represents a class declaration involving the `class` keyword.

          class Foo end
          ^^^^^^^^^^^^^
  - name: ClassVariableRead
    child_nodes:
      - name: name
        type: token
    location: name
    comment: |
      Represents referencing a class variable.

          @@foo
          ^^^^^
  - name: ClassVariableWrite
    child_nodes:
      - name: name
        type: token
      - name: operator
        type: token
      - name: value
        type: node
    location: name->value
    comment: |
      Represents writing to a class variable.

          @@foo = 1
          ^^^^^^^^^
  - name: ConstantPathNode
    child_nodes:
      - name: parent
        type: node?
      - name: delimiter
        type: token
      - name: child
        type: node
    location: parent|delimiter->child
    comment: |
      Represents accessing a constant through a path of `::` operators.

          Foo::Bar
          ^^^^^^^^
  - name: ConstantPathWriteNode
    child_nodes:
      - name: target
        type: node
      - name: operator
        type: token
      - name: value
        type: node
    location: target->value
    comment: |
      Represents writing to a constant.

          Foo = 1
          ^^^^^^^

          Foo::Bar = 1
          ^^^^^^^^^^^^
  - name: ConstantRead
    child_nodes:
      - name: name
        type: token
    location: name
    comment: |
      Represents referencing a constant.

          Foo
          ^^^
  - name: DefNode
    child_nodes:
      - name: def_keyword
        type: token
      - name: name
        type: token
      - name: lparen
        type: token?
      - name: parameters
        type: node
      - name: rparen
        type: token?
      - name: equal
        type: token?
      - name: statements
        type: node
      - name: end_keyword
        type: token?
      - name: scope
        type: node
    location: def_keyword->end_keyword|statements
    comment: |
      Represents a method definition.

          def method
          end
          ^^^^^^^^^^
  - name: DefinedNode
    child_nodes:
      - name: keyword
        type: token
      - name: lparen
        type: token?
      - name: value
        type: node
      - name: rparen
        type: token?
    location: keyword->rparen|value
    comment: |
      Represents the use of the `defined?` keyword.

          defined?(a)
          ^^^^^^^^^^^
  - name: ElseNode
    child_nodes:
      - name: else_keyword
        type: token
      - name: statements
        type: node
      - name: end_keyword
        type: token
    location: else_keyword->end_keyword
    comment: |
      Represents an `else` clause in a `case`, `if`, or `unless` statement.

          if a then b else c end
                      ^^^^^^^^^^
  - name: EnsureNode
    child_nodes:
      - name: ensure_keyword
        type: token
      - name: statements
        type: node
      - name: end_keyword
        type: token
    location: ensure_keyword->end_keyword
    comment: |
      Represents an `ensure` clause in a `begin` statement.

          begin
            foo
          ensure
          ^^^^^^
            bar
          end
  - name: FalseNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of the literal `false` keyword.

          false
          ^^^^^
  - name: FloatLiteral
    child_nodes:
      - name: value
        type: token
    location: value
    comment: |
      Represents a floating point number literal.

          1.0
          ^^^
  - name: ForNode
    child_nodes:
      - name: for_keyword
        type: token
      - name: index
        type: node
      - name: in_keyword
        type: token
      - name: collection
        type: node
      - name: do_keyword
        type: token?
      - name: statements
        type: node
      - name: end_keyword
        type: token
    location: for_keyword->statements
    comment: |
      Represents the use of the `for` keyword.

          for i in a end
          ^^^^^^^^^^^^^^
  - name: ForwardingArgumentsNode
    child_nodes:
      - name: operator
        type: token
    location: operator
    comment: |
      Represents forwarding all arguments to this method to another method.

          def foo(...)
            bar(...)
            ^^^^^^^^
          end
  - name: ForwardingParameterNode
    child_nodes:
      - name: operator
        type: token
    location: operator
    comment: |
      Represents the use of the forwarding parameter in a method, block, or lambda declaration.

          def foo(...)
                  ^^^
          end
  - name: ForwardingSuperNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of the `super` keyword without parentheses or arguments.

          super
          ^^^^^
  - name: GlobalVariableRead
    child_nodes:
      - name: name
        type: token
    location: name
    comment: |
      Represents referencing a global variable.

          $foo
          ^^^^
  - name: GlobalVariableWrite
    child_nodes:
      - name: name
        type: token
      - name: operator
        type: token
      - name: value
        type: node
    location: name->value
    comment: |
      Represents writing to a global variable.

          $foo = 1
          ^^^^^^^^
  - name: HashNode
    child_nodes:
      - name: opening
        type: token?
      - name: elements
        type: node[]
      - name: closing
        type: token?
    location: opening|elements->closing|elements
    comment: |
      Represents a hash literal.

          { a => b }
          ^^^^^^^^^^
  - name: IfNode
    child_nodes:
      - name: if_keyword
        type: token
      - name: predicate
        type: node
      - name: statements
        type: node
      - name: consequent
        type: node?
      - name: end_keyword
        type: token?
    location: if_keyword->end_keyword|consequent|statements
    comment: |
      Represents the use of the `if` keyword, either in the block form or the modifier form.

          bar if foo
          ^^^^^^^^^^

          if foo then bar end
          ^^^^^^^^^^^^^^^^^^^
  - name: ImaginaryLiteral
    child_nodes:
      - name: value
        type: token
    location: value
    comment: |
      Represents an imaginary number literal.

          1.0i
          ^^^^
  - name: InstanceVariableRead
    child_nodes:
      - name: name
        type: token
    location: name
    comment: |
      Represents referencing an instance variable.

          @foo
          ^^^^
  - name: InstanceVariableWrite
    child_nodes:
      - name: name
        type: token
      - name: operator
        type: token
      - name: value
        type: node
    location: name->value
    comment: |
      Represents writing to an instance variable.

          @foo = 1
          ^^^^^^^^
  - name: IntegerLiteral
    child_nodes:
      - name: value
        type: token
    location: value
    comment: |
      Represents an integer number literal.

          1
          ^
  - name: InterpolatedRegularExpressionNode
    child_nodes:
      - name: opening
        type: token
      - name: parts
        type: node[]
      - name: closing
        type: token
    location: opening->closing
    comment: |
      Represents a regular expression literal that contains interpolation.

          /foo #{bar} baz/
          ^^^^^^^^^^^^^^^^
  - name: InterpolatedXStringNode
    child_nodes:
      - name: opening
        type: token
      - name: parts
        type: node[]
      - name: closing
        type: token
    location: opening->closing
    comment: |
      Represents an xstring literal that contains interpolation.

          `foo #{bar} baz`
          ^^^^^^^^^^^^^^^^
  - name: InterpolatedStringNode
    child_nodes:
      - name: opening
        type: token?
      - name: parts
        type: node[]
      - name: closing
        type: token?
    location: opening|parts->closing|parts
    comment: |
      Represents a string literal that contains interpolation.

          "foo #{bar} baz"
          ^^^^^^^^^^^^^^^^
  - name: InterpolatedSymbolNode
    child_nodes:
      - name: opening
        type: token?
      - name: parts
        type: node[]
      - name: closing
        type: token?
    location: opening|parts->closing|parts
    comment: |
      Represents a symbol literal that contains interpolation.

          :"foo #{bar} baz"
          ^^^^^^^^^^^^^^^^^
  - name: KeywordParameterNode
    child_nodes:
      - name: name
        type: token
    location: name
    comment: |
      Represents an required keyword parameter to a method, block, or lambda definition.

          def a(b:)
                ^^
          end
  - name: KeywordRestParameterNode
    child_nodes:
      - name: operator
        type: token
      - name: name
        type: token?
    location: operator->name|operator
    comment: |
      Represents a keyword rest parameter to a method, block, or lambda definition.

          def a(**b)
                ^^^
          end
  - name: LocalVariableRead
    child_nodes:
      - name: name
        type: token
    location: name
    comment: |
      Represents reading a local variable. Note that this requires that a local
      variable of the same name has already been written to in the same scope,
      otherwise it is parsed as a method call.

          foo
          ^^^
  - name: LocalVariableWrite
    child_nodes:
      - name: name
        type: token
      - name: operator
        type: token
      - name: value
        type: node
    location: name->value
    comment: |
      Represents writing to a local variable.

          foo = 1
          ^^^^^^^
  - name: MissingNode
    child_nodes: []
    location: provided
    comment: |
      Represents a node that is missing from the source and results in a syntax
      error.
  - name: ModuleNode
    child_nodes:
      - name: scope
        type: node
      - name: module_keyword
        type: token
      - name: constant_path
        type: node
      - name: statements
        type: node
      - name: end_keyword
        type: token
    location: module_keyword->end_keyword
    comment: |
      Represents a module declaration involving the `module` keyword.

          module Foo end
          ^^^^^^^^^^^^^^
  - name: MultiTargetNode
    child_nodes:
      - name: targets
        type: node[]
    location: targets
    comment: |
      Represents a multi-left-hand expression.

        a, b, c = 1, 2, 3
        ^^^^^^^
  - name: NextNode
    child_nodes:
      - name: keyword
        type: token
      - name: arguments
        type: node?
    location: keyword->arguments|keyword
    comment: |
      Represents the use of the `next` keyword.

          next 1
          ^^^^^^
  - name: NilNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of the `nil` keyword.

          nil
          ^^^
  - name: NoKeywordsParameterNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of `**nil` inside method arguments.

          def a(**nil)
                ^^^^^
          end
  - name: OperatorAndAssignmentNode
    child_nodes:
      - name: target
        type: node
      - name: operator
        type: token
      - name: value
        type: node
    location: target->value
    comment: |
      Represents the use of the `&&=` operator for assignment.

          target &&= value
          ^^^^^^^^^^^^^^^^
  - name: OperatorAssignmentNode
    child_nodes:
      - name: target
        type: node
      - name: operator
        type: token
      - name: value
        type: node
    location: target->value
    comment: |
      Represents assigning to a value using an operator that isn't `=`.

          foo += bar
          ^^^^^^^^^^
  - name: OperatorOrAssignmentNode
    child_nodes:
      - name: target
        type: node
      - name: operator
        type: token
      - name: value
        type: node
    location: target->value
    comment: |
      Represents the use of the `||=` operator for assignment.

          target ||= value
          ^^^^^^^^^^^^^^^^
  - name: OptionalParameterNode
    child_nodes:
      - name: name
        type: token
      - name: equal_operator
        type: token
      - name: value
        type: node
    location: name->value
    comment: |
      Represents an optional parameter to a method, block, or lambda definition.

          def a(b = 1)
                ^^^^^
          end
  - name: OrNode
    child_nodes:
      - name: left
        type: node
      - name: operator
        type: token
      - name: right
        type: node
    location: left->right
    comment: |
      Represents the use of the `||` operator or the `or` keyword.

          left or right
          ^^^^^^^^^^^^^
  - name: ParametersNode
    child_nodes:
      - name: requireds
        type: node[]
      - name: optionals
        type: node[]
      - name: rest
        type: node?
      - name: keywords
        type: node[]
      - name: keyword_rest
        type: node?
      - name: block
        type: node?
    location: requireds->block|keyword_rest|keywords
    comment: |
      Represents the list of parameters on a method, block, or lambda definition.

          def a(b, c, d)
                ^^^^^^^
          end
  - name: ParenthesesNode
    child_nodes:
      - name: opening
        type: token
      - name: statements
        type: node
      - name: closing
        type: token
    location: opening->closing
    comment: |
      Represents a parentesized expression

          (10 + 34)
          ^^^^^^^^^
  - name: PostExecutionNode
    child_nodes:
      - name: keyword
        type: token
      - name: opening
        type: token
      - name: statements
        type: node
      - name: closing
        type: token
    location: keyword->closing
    comment: |
      Represents the use of the `END` keyword.

          BEGIN { foo }
          ^^^^^^^^^^^^^
  - name: PreExecutionNode
    child_nodes:
      - name: keyword
        type: token
      - name: opening
        type: token
      - name: statements
        type: node
      - name: closing
        type: token
    location: keyword->closing
    comment: |
      Represents the use of the `END` keyword.

          END { foo }
          ^^^^^^^^^^^
  - name: Program
    child_nodes:
      - name: scope
        type: node
      - name: statements
        type: node
    location: statements
    comment: The top level node of any parse tree.
  - name: RangeNode
    child_nodes:
      - name: left
        type: node?
      - name: range_operator
        type: token
      - name: right
        type: node?
    location: left|range_operator->right|range_operator
    comment: |
      Represents the use of the `..` or `...` operators.

          1..2
          ^^^^

          c if a =~ /left/ ... b =~ /right/
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  - name: RationalLiteral
    child_nodes:
      - name: value
        type: token
    location: value
    comment: |
      Represents a rational number literal.

          1.0r
          ^^^^
  - name: RedoNode
    child_nodes:
      - name: value
        type: token
    location: value
    comment: |
      Represents the use of the `redo` keyword.

          redo
          ^^^^
  - name: RegularExpressionNode
    child_nodes:
      - name: opening
        type: token
      - name: content
        type: token
      - name: closing
        type: token
    location: opening->closing
    comment: |
      Represents a regular expression literal with no interpolation.

          /foo/i
          ^^^^^^
  - name: RequiredParameterNode
    child_nodes:
      - name: name
        type: token
    location: name
    comment: |
      Represents a required parameter to a method, block, or lambda definition.

          def a(b)
                ^
          end
  - name: RescueModifierNode
    child_nodes:
      - name: expression
        type: node
      - name: rescue_keyword
        type: token
      - name: rescue_expression
        type: node
    location: expression->rescue_expression
    comment: |
      Represents an expression modified with a rescue.

        foo rescue nil
        ^^^^^^^^^^^^^^
  - name: RescueNode
    child_nodes:
      - name: rescue_keyword
        type: token
      - name: exception_classes
        type: node[]
      - name: equal_greater
        type: token?
      - name: exception_variable
        type: token?
      - name: statements
        type: node
      - name: consequent
        type: node?
    location: rescue_keyword->statements|consequent
    comment: |
      Represents a rescue statement.

          rescue
            foo
          ^^^^^^
  - name: RestParameterNode
    child_nodes:
      - name: operator
        type: token
      - name: name
        type: token?
    location: operator->name|operator
    comment: |
      Represents a rest parameter to a method, block, or lambda definition.

          def a(*b)
                ^^
          end
  - name: StarNode
    child_nodes:
      - name: operator
        type: token
      - name: expression
        type: node?
    location: operator->expression|operator
    comment: |
      Represents array splats.

          [*a]
           ^^
  - name: RetryNode
    child_nodes:
      - name: value
        type: token
    location: value
    comment: |
      Represents the use of the `retry` keyword.

          retry
          ^^^^^
  - name: ReturnNode
    child_nodes:
      - name: keyword
        type: token
      - name: arguments
        type: node?
    location: keyword->arguments|keyword
    comment: |
      Represents the use of the `return` keyword.

          return 1
          ^^^^^^^^
  - name: SClassNode
    child_nodes:
      - name: scope
        type: node
      - name: class_keyword
        type: token
      - name: operator
        type: token
      - name: expression
        type: node
      - name: statements
        type: node
      - name: end_keyword
        type: token
    location: class_keyword->end_keyword
    comment: |
      Represents a singleton class declaration involving the `class` keyword.

          class << self end
          ^^^^^^^^^^^^^^^^^
  - name: Scope
    child_nodes:
      - name: locals
        type: token[]
    location: locals
    comment: |
      Represents the local variables within a given lexical scope. These are
      attached to nodes where a new scope is created.
  - name: SelfNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the `self` keyword.

          self
          ^^^^
  - name: SourceEncodingNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of the `__ENCODING__` keyword.

          __ENCODING__
          ^^^^^^^^^^^^
  - name: SourceFileNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of the `__FILE__` keyword.

          __FILE__
          ^^^^^^^^
  - name: SourceLineNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of the `__LINE__` keyword.

          __LINE__
          ^^^^^^^^
  - name: Statements
    child_nodes:
      - name: body
        type: node[]
    location: body
    comment: |
      Represents a set of statements contained within some scope.

          foo; bar; baz
          ^^^^^^^^^^^^^
  - name: StringInterpolatedNode
    child_nodes:
      - name: opening
        type: token
      - name: statements
        type: node
      - name: closing
        type: token
    location: opening->closing
    comment: |
      Represents an interpolated set of statements within a string.

          "foo #{bar}"
               ^^^^^^
  - name: StringNode
    child_nodes:
      - name: opening
        type: token?
      - name: content
        type: token
      - name: closing
        type: token?
      - name: unescaped
        type: string
    location: opening|content->closing|content
    comment: |
      Represents a string literal, a string contained within a `%w` list, or
      plain string content within an interpolated string.

          "foo"
          ^^^^^

          %w[foo]
             ^^^

          "foo #{bar} baz"
           ^^^^      ^^^^
  - name: SuperNode
    child_nodes:
      - name: keyword
        type: token
      - name: lparen
        type: token?
      - name: arguments
        type: node?
      - name: rparen
        type: token?
    location: keyword->rparen|arguments|lparen|keyword
    comment: |
      Represents the use of the `super` keyword with parentheses or arguments.

          super()
          ^^^^^^^

          super foo, bar
          ^^^^^^^^^^^^^^
  - name: SymbolNode
    child_nodes:
      - name: opening
        type: token?
      - name: value
        type: token
      - name: closing
        type: token?
    location: opening|value->closing|value
    comment: |
      Represents a symbol literal or a symbol contained within a `%i` list.

          :foo
          ^^^^

          %i[foo]
             ^^^
  - name: Ternary
    child_nodes:
      - name: predicate
        type: node
      - name: question_mark
        type: token
      - name: true_expression
        type: node
      - name: colon
        type: token
      - name: false_expression
        type: node
    location: predicate->false_expression
    comment: |
      Represents the use of the ternary operators.

          foo ? bar : baz
          ^^^^^^^^^^^^^^^
  - name: TrueNode
    child_nodes:
      - name: keyword
        type: token
    location: keyword
    comment: |
      Represents the use of the literal `true` keyword.

          true
          ^^^^
  - name: UndefNode
    child_nodes:
      - name: keyword
        type: token
      - name: names
        type: node[]
    location: keyword->names
    comment: |
      Represents the use of the `undef` keyword.

          undef :foo, :bar, :baz
          ^^^^^^^^^^^^^^^^^^^^^^
  - name: UnlessNode
    child_nodes:
      - name: keyword
        type: token
      - name: predicate
        type: node
      - name: statements
        type: node
      - name: consequent
        type: node?
      - name: end_keyword
        type: token?
    location: keyword->statements
    comment: |
      Represents the use of the `unless` keyword, either in the block form or the modifier form.

          bar unless foo
          ^^^^^^^^^^^^^^

          unless foo then bar end
          ^^^^^^^^^^^^^^^^^^^^^^^
  - name: UntilNode
    child_nodes:
      - name: keyword
        type: token
      - name: predicate
        type: node
      - name: statement
        type: node
    location: keyword->statement
    comment: |
      Represents the use of the `until` keyword, either in the block form or the modifier form.

          bar until foo
          ^^^^^^^^^^^^^

          until foo do bar end
          ^^^^^^^^^^^^^^^^^^^^
  - name: WhileNode
    child_nodes:
      - name: keyword
        type: token
      - name: predicate
        type: node
      - name: statement
        type: node
    location: keyword->statement
    comment: |
      Represents the use of the `while` keyword, either in the block form or the modifier form.

          bar while foo
          ^^^^^^^^^^^^^

          while foo do bar end
          ^^^^^^^^^^^^^^^^^^^^
  - name: XStringNode
    child_nodes:
      - name: opening
        type: token
      - name: content
        type: token
      - name: closing
        type: token
    location: opening->closing
    comment: |
      Represents an xstring literal with no interpolation.

          `foo`
          ^^^^^
  - name: YieldNode
    child_nodes:
      - name: keyword
        type: token
      - name: lparen
        type: token?
      - name: arguments
        type: node?
      - name: rparen
        type: token?
    location: keyword->rparen|arguments|lparen|keyword
    comment: |
      Represents the use of the `yield` keyword.

          yield 1
          ^^^^^^^