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

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

silence_warnings

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_investigationObject


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