Sha256: c657c578f466222b9dba2bef846f39f64ad078ac0e7661d6861f65863be52a84

Contents?: true

Size: 1.91 KB

Versions: 12

Compression:

Stored size: 1.91 KB

Contents

# frozen_string_literal: true

module RuboCop
  module Cop
    module Performance
      # Identifies uses of `Range#include?` and `Range#member?`, which iterates over each
      # item in a `Range` to see if a specified item is there. In contrast,
      # `Range#cover?` simply compares the target item with the beginning and
      # end points of the `Range`. In a great majority of cases, this is what
      # is wanted.
      #
      # @safety
      #   This cop is unsafe because `Range#include?` (or `Range#member?`) and `Range#cover?`
      #   are not equivalent behavior.
      #   Example of a case where `Range#cover?` may not provide the desired result:
      #
      #   [source,ruby]
      #   ----
      #   ('a'..'z').cover?('yellow') # => true
      #   ----
      #
      # @example
      #   # bad
      #   ('a'..'z').include?('b') # => true
      #   ('a'..'z').member?('b')  # => true
      #
      #   # good
      #   ('a'..'z').cover?('b') # => true
      class RangeInclude < Base
        extend AutoCorrector

        MSG = 'Use `Range#cover?` instead of `Range#%<bad_method>s`.'
        RESTRICT_ON_SEND = %i[include? member?].freeze

        # TODO: If we traced out assignments of variables to their uses, we
        # might pick up on a few more instances of this issue
        # Right now, we only detect direct calls on a Range literal
        # (We don't even catch it if the Range is in double parens)

        def_node_matcher :range_include, <<~PATTERN
          (call {irange erange (begin {irange erange})} ${:include? :member?} ...)
        PATTERN

        def on_send(node)
          range_include(node) do |bad_method|
            message = format(MSG, bad_method: bad_method)

            add_offense(node.loc.selector, message: message) do |corrector|
              corrector.replace(node.loc.selector, 'cover?')
            end
          end
        end
        alias on_csend on_send
      end
    end
  end
end

Version data entries

12 entries across 12 versions & 4 rubygems

Version Path
rubocop-performance-1.23.1 lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.23.0 lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.22.1 lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.22.0 lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.21.1 lib/rubocop/cop/performance/range_include.rb
katalyst-govuk-formbuilder-1.9.2 vendor/bundle/ruby/3.3.0/gems/rubocop-performance-1.21.0/lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.21.0 lib/rubocop/cop/performance/range_include.rb
mlh-rubocop-config-1.0.3 vendor/bundle/ruby/3.2.0/gems/rubocop-performance-1.20.2/lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.20.2 lib/rubocop/cop/performance/range_include.rb
getargv-0.3.3-universal-darwin vendor/bundle/ruby/3.3.0/gems/rubocop-performance-1.20.1/lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.20.1 lib/rubocop/cop/performance/range_include.rb
rubocop-performance-1.20.0 lib/rubocop/cop/performance/range_include.rb