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 =
'=>'
SPACED_HASH_ROCKET =
' => '
COLON =
':'
SPACED_COLON =
': '

Constants inherited from Node

Node::ASSIGNMENTS, Node::BASIC_CONDITIONALS, Node::BASIC_LITERALS, Node::COMPARISON_OPERATORS, Node::COMPOSITE_LITERALS, Node::CONDITIONALS, Node::EQUALS_ASSIGNMENTS, Node::FALSEY_LITERALS, Node::IMMUTABLE_LITERALS, Node::KEYWORDS, Node::LITERALS, Node::MUTABLE_LITERALS, Node::OPERATOR_KEYWORDS, Node::REFERENCES, Node::SHORTHAND_ASSIGNMENTS, 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?, #assignment?, #basic_conditional?, #basic_literal?, #call_type?, #chained?, #child_nodes, #complete!, #complete?, #conditional?, #const_name, #defined_module, #defined_module_name, #descendants, #each_ancestor, #each_child_node, #each_descendant, #each_node, #empty_source?, #equals_asgn?, #falsey_literal?, #first_line, #immutable_literal?, #initialize, #keyword?, #last_line, #line_count, #literal?, #multiline?, #mutable_literal?, #node_parts, #nonempty_line_count, #numeric_type?, #operator_keyword?, #parent, #parent_module_name, #parenthesized_call?, #pure?, #range_type?, #receiver, #reference?, #shorthand_asgn?, #sibling_index, #single_line?, #source, #source_length, #source_range, #special_keyword?, #truthy_literal?, #updated, #value_used?, #variable?

Methods included from NodePattern::Macros

#def_node_matcher, #def_node_search, #node_search, #node_search_all, #node_search_body, #node_search_first

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

#value_on_new_line?Boolean

Checks whether the value starts on its own line.

Returns:

  • (Boolean)

    whether the value in the ‘pair` starts its own line



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

def value_on_new_line?
  key.loc.line != value.loc.line
end