Class: RuboCop::AST::PairNode

Inherits:
Node
  • Object
show all
Includes:
HashElementNode
Defined in:
lib/rubocop/ast/node/pair_node.rb

Overview

A node extension for ‘pair` nodes. This will be used in place of a plain node when the builder constructs the AST, making its methods available to all `pair` nodes within RuboCop.

Constant Summary collapse

HASH_ROCKET =
'=>'.freeze
SPACED_HASH_ROCKET =
' => '.freeze
COLON =
':'.freeze
SPACED_COLON =
': '.freeze

Constants inherited from Node

Node::BASIC_LITERALS, Node::COMPARISON_OPERATORS, Node::COMPOSITE_LITERALS, Node::FALSEY_LITERALS, Node::IMMUTABLE_LITERALS, Node::KEYWORDS, Node::LITERALS, Node::MUTABLE_LITERALS, Node::OPERATOR_KEYWORDS, Node::REFERENCES, Node::SPECIAL_KEYWORDS, Node::TRUTHY_LITERALS, Node::VARIABLES

Instance Method Summary collapse

Methods included from HashElementNode

#delimiter_delta, #key, #key_delta, #same_line?, #value, #value_delta

Methods inherited from Node

#ancestors, #argument?, #asgn_method_call?, #basic_literal?, #binary_operation?, #chained?, #child_nodes, #complete!, #complete?, #const_name, def_matcher, #defined_module, #defined_module_name, #descendants, #each_ancestor, #each_child_node, #each_descendant, #each_node, #falsey_literal?, #immutable_literal?, #initialize, #keyword?, #keyword_bang?, #keyword_not?, #literal?, #multiline?, #mutable_literal?, #numeric_type?, #parent, #parent_module_name, #pure?, #receiver, #reference?, #sibling_index, #single_line?, #source, #source_range, #special_keyword?, #truthy_literal?, #unary_operation?, #updated, #value_used?, #variable?

Methods included from Sexp

#s

Constructor Details

This class inherits a constructor from RuboCop::AST::Node

Instance Method Details

#colon?Boolean

Checks whether the ‘pair` uses a colon delimiter.

Returns:

  • (Boolean)

    whether this ‘pair` uses a colon delimiter



26
27
28
# File 'lib/rubocop/ast/node/pair_node.rb', line 26

def colon?
  loc.operator.is?(COLON)
end

#delimiter(with_spacing = false) ⇒ String

Returns the delimiter of the ‘pair` as a string. Returns `=>` for a colon delimited `pair`, and `:` for a hash rocket delimited `pair`.

Parameters:

  • with_spacing (Boolean) (defaults to: false)

    whether to include spacing

Returns:

  • (String)

    the delimiter of the ‘pair`



35
36
37
38
39
40
41
# File 'lib/rubocop/ast/node/pair_node.rb', line 35

def delimiter(with_spacing = false)
  if with_spacing
    hash_rocket? ? SPACED_HASH_ROCKET : SPACED_COLON
  else
    hash_rocket? ? HASH_ROCKET : COLON
  end
end

#hash_rocket?Boolean

Checks whether the ‘pair` uses a hash rocket delimiter.

Returns:

  • (Boolean)

    whether this ‘pair` uses a hash rocket delimiter



19
20
21
# File 'lib/rubocop/ast/node/pair_node.rb', line 19

def hash_rocket?
  loc.operator.is?(HASH_ROCKET)
end

#inverse_delimiter(with_spacing = false) ⇒ String

Returns the inverse delimiter of the ‘pair` as a string.

Parameters:

  • with_spacing (Boolean) (defaults to: false)

    whether to include spacing

Returns:

  • (String)

    the inverse delimiter of the ‘pair`



47
48
49
50
51
52
53
# File 'lib/rubocop/ast/node/pair_node.rb', line 47

def inverse_delimiter(with_spacing = false)
  if with_spacing
    hash_rocket? ? SPACED_COLON : SPACED_HASH_ROCKET
  else
    hash_rocket? ? COLON : HASH_ROCKET
  end
end

#node_partsArray<Node>

Custom destructuring method. This is used to normalize the branches for ‘pair` and `kwsplat` nodes, to add duck typing to `hash` elements.

Returns:

  • (Array<Node>)

    the different parts of the ‘pair`



59
60
61
# File 'lib/rubocop/ast/node/pair_node.rb', line 59

def node_parts
  [*self]
end