Class: RuboCop::Cop::Lint::OutOfRangeRegexpRef

Inherits:
Base
  • Object
show all
Defined in:
lib/rubocop/cop/lint/out_of_range_regexp_ref.rb

Overview

This cops looks for references of Regexp captures that are out of range and thus always returns nil.

Examples:


/(foo)bar/ =~ 'foobar'

# bad - always returns nil

puts $2 # => nil

# good

puts $1 # => foo

Constant Summary collapse

MSG = 
'$%<backref>s is out of range (%<count>s regexp capture %<group>s detected).'
REGEXP_RECEIVER_METHODS = 
%i[=~ === match].to_set.freeze
REGEXP_ARGUMENT_METHODS = 
%i[=~ match grep gsub gsub! sub sub! [] slice slice! index rindex
scan partition rpartition start_with? end_with?].to_set.freeze
REGEXP_CAPTURE_METHODS = 
(REGEXP_RECEIVER_METHODS + REGEXP_ARGUMENT_METHODS).freeze
RESTRICT_ON_SEND = 
REGEXP_CAPTURE_METHODS

Constants included from Util

Util::LITERAL_REGEX

Instance Attribute Summary

Attributes inherited from Base

#config, #processed_source

Instance Method Summary collapse

Methods inherited from Base

#add_global_offense, #add_offense, autocorrect_incompatible_with, badge, callbacks_needed, #callbacks_needed, #config_to_allow_offenses, #config_to_allow_offenses=, #cop_config, cop_name, #cop_name, department, documentation_url, exclude_from_registry, #excluded_file?, #external_dependency_checksum, inherited, #initialize, joining_forces, lint?, match?, #message, #offenses, #on_investigation_end, #on_other_file, #ready, #relevant_file?, support_autocorrect?, support_multiple_source?, #target_rails_version, #target_ruby_version

Methods included from AutocorrectLogic

#autocorrect?, #autocorrect_enabled?, #autocorrect_requested?, #correctable?, #disable_uncorrectable?, #safe_autocorrect?

Methods included from IgnoredNode

#ignore_node, #ignored_node?, #part_of_ignored_node?

Methods included from Util

add_parentheses, args_begin, args_end, begins_its_line?, comment_line?, comment_lines?, double_quotes_required?, escape_string, first_part_of_call_chain, indent, interpret_string_escapes, line_range, needs_escaping?, on_node, parentheses?, same_line?, to_string_literal, to_supported_styles, trim_string_interporation_escape_character

Methods included from PathUtil

absolute?, hidden_dir?, hidden_file?, hidden_file_in_not_hidden_dir?, match_path?, maybe_hidden_file?, relative_path, smart_path

Constructor Details

This class inherits a constructor from RuboCop::Cop::Base

Instance Method Details

#after_send(node) ⇒ Object 



38
39
40
41
42
43
44
45
46
 
# File 'lib/rubocop/cop/lint/out_of_range_regexp_ref.rb', line 38

def after_send(node)
  @valid_ref = nil

  if regexp_first_argument?(node)
    check_regexp(node.first_argument)
  elsif regexp_receiver?(node)
    check_regexp(node.receiver)
  end
end

#on_match_with_lvasgn(node) ⇒ Object 



34
35
36
 
# File 'lib/rubocop/cop/lint/out_of_range_regexp_ref.rb', line 34

def on_match_with_lvasgn(node)
  check_regexp(node.children.first)
end

#on_new_investigation ⇒ Object 



30
31
32
 
# File 'lib/rubocop/cop/lint/out_of_range_regexp_ref.rb', line 30

def on_new_investigation
  @valid_ref = 0
end

#on_nth_ref(node) ⇒ Object 



56
57
58
59
60
61
62
63
64
65
66
67
68
 
# File 'lib/rubocop/cop/lint/out_of_range_regexp_ref.rb', line 56

def on_nth_ref(node)
  backref, = *node
  return if @valid_ref.nil? || backref <= @valid_ref

  message = format(
    MSG,
    backref: backref,
    count: @valid_ref.zero? ? 'no' : @valid_ref,
    group: @valid_ref == 1 ? 'group' : 'groups'
  )

  add_offense(node, message: message)
end

#on_when(node) ⇒ Object 



48
49
50
51
52
53
54
 
# File 'lib/rubocop/cop/lint/out_of_range_regexp_ref.rb', line 48

def on_when(node)
  regexp_conditions = node.conditions.select(&:regexp_type?)

  @valid_ref = regexp_conditions.map do |condition|
    check_regexp(condition)
  end.compact.max
end