Class: RuboCop::AST::DefNode

Inherits:
Node
  • Object
show all
Includes:
MethodIdentifierPredicates, ParameterizedNode
Defined in:
lib/rubocop/ast/node/def_node.rb

Overview

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

Constant Summary

Constants inherited from Node

Node::ARGUMENT_TYPES, 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::LOOP_TYPES, Node::MUTABLE_LITERALS, Node::OPERATOR_KEYWORDS, Node::POST_CONDITION_LOOP_TYPES, Node::REFERENCES, Node::SHORTHAND_ASSIGNMENTS, Node::SPECIAL_KEYWORDS, Node::TRUTHY_LITERALS, Node::VARIABLES

Instance Method Summary collapse

Methods included from MethodIdentifierPredicates

#assignment_method?, #bang_method?, #camel_case_method?, #comparison_method?, #const_receiver?, #enumerable_method?, #enumerator_method?, #method?, #negation_method?, #nonmutating_array_method?, #nonmutating_binary_operator_method?, #nonmutating_hash_method?, #nonmutating_operator_method?, #nonmutating_string_method?, #nonmutating_unary_operator_method?, #operator_method?, #predicate_method?, #prefix_bang?, #prefix_not?, #self_receiver?

Methods included from ParameterizedNode

#arguments?, #block_argument?, #first_argument, #last_argument, #parenthesized?, #splat_argument?

Methods inherited from Node

#ancestors, #argument?, #argument_type?, #assignment?, #assignment_or_similar?, #basic_conditional?, #basic_literal?, #boolean_type?, #call_type?, #chained?, #class_constructor?, #class_definition?, #complete!, #complete?, #conditional?, #const_name, #defined_module, #defined_module_name, #each_ancestor, #empty_source?, #equals_asgn?, #falsey_literal?, #first_line, #global_const?, #guard_clause?, #immutable_literal?, #initialize, #keyword?, #lambda?, #lambda_or_proc?, #last_line, #left_sibling, #left_siblings, #line_count, #literal?, #loop_keyword?, #match_guard_clause?, #module_definition?, #multiline?, #mutable_literal?, #nonempty_line_count, #numeric_type?, #operator_keyword?, #parent, #parent?, #parent_module_name, #parenthesized_call?, #post_condition_loop?, #proc?, #pure?, #range_type?, #recursive_basic_literal?, #recursive_literal?, #reference?, #right_sibling, #right_siblings, #root?, #send_type?, #shorthand_asgn?, #sibling_index, #single_line?, #source, #source_length, #source_range, #special_keyword?, #str_content, #struct_constructor?, #truthy_literal?, #type?, #updated, #value_used?, #variable?

Methods included from NodePattern::Macros

#def_node_matcher, #def_node_search

Methods included from Descendence

#child_nodes, #descendants, #each_child_node, #each_descendant, #each_node

Methods included from Sexp

#s

Constructor Details

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

Instance Method Details

#argument_forwarding? ⇒ Boolean

Note:

This is written in a way that may support lead arguments which are rumored to be added in a later version of Ruby.

Checks whether this method definition node forwards its arguments as per the feature added in Ruby 2.7.

Returns:

  • (Boolean) —

    whether the ‘def` node uses argument forwarding



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

def argument_forwarding?
  arguments.any?(&:forward_args_type?) || arguments.any?(&:forward_arg_type?)
end

#arguments ⇒ Array<Node>

An array containing the arguments of the method definition.

Returns:

  • (Array<Node>) —

    the arguments of the method definition



40
41
42
 
# File 'lib/rubocop/ast/node/def_node.rb', line 40

def arguments
  children[-2]
end

#body ⇒ Node

Note:

this can be either a ‘begin` node, if the method body contains multiple expressions, or any other node, if it contains a single expression.

The body of the method definition.

Returns:

  • (Node) —

    the body of the method definition



51
52
53
 
# File 'lib/rubocop/ast/node/def_node.rb', line 51

def body
  children[-1]
end

#endless? ⇒ Boolean

Returns if the definition is without an ‘end` or not.

Returns:

  • (Boolean) —

    if the definition is without an ‘end` or not.



63
64
65
 
# File 'lib/rubocop/ast/node/def_node.rb', line 63

def endless?
  !loc.end
end

#method_name ⇒ Symbol

The name of the defined method as a symbol.

Returns:

  • (Symbol) —

    the name of the defined method



33
34
35
 
# File 'lib/rubocop/ast/node/def_node.rb', line 33

def method_name
  children[-3]
end

#receiver ⇒ Node?

The receiver of the method definition, if any.

Returns:

  • (Node, nil) —

    the receiver of the method definition, or ‘nil`.



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

def receiver
  children[-4]
end

#void_context? ⇒ Boolean

Checks whether this node body is a void context.

Returns:

  • (Boolean) —

    whether the ‘def` node body is a void context



15
16
17
 
# File 'lib/rubocop/ast/node/def_node.rb', line 15

def void_context?
  (def_type? && method?(:initialize)) || assignment_method?
end