class RuboCop::Cop::Cop
See docs.rubocop.org/rubocop/v1_upgrade_notes.html<br>Legacy scaffold for Cops.
@deprecated Use Cop::Base instead
def self.all
- Use Registry.all
def self.all warn Rainbow(<<~WARNING).yellow, uplevel: 1 `Cop.all` is deprecated. Use `Registry.all` instead. WARNING Registry.all end
def self.inherited(_subclass)
def self.inherited(_subclass) super warn Rainbow(<<~WARNING).yellow, uplevel: 1 Inheriting from `RuboCop::Cop::Cop` is deprecated. Use `RuboCop::Cop::Base` instead. For more information, see https://docs.rubocop.org/rubocop/v1_upgrade_notes.html. WARNING end
def self.joining_forces
def self.joining_forces return unless method_defined?(:join_force?) cop = new Force.all.select { |force_class| cop.join_force?(force_class) } end
def self.qualified_cop_name(name, origin)
- Use Registry.qualified_cop_name
def self.qualified_cop_name(name, origin) warn Rainbow(<<~WARNING).yellow, uplevel: 1 `Cop.qualified_cop_name` is deprecated. Use `Registry.qualified_cop_name` instead. WARNING Registry.qualified_cop_name(name, origin) end
def self.registry
- Use Registry.global
def self.registry warn Rainbow(<<~WARNING).yellow, uplevel: 1 `Cop.registry` is deprecated. Use `Registry.global` instead. WARNING Registry.global end
def self.support_autocorrect?
def self.support_autocorrect? method_defined?(:autocorrect) end
def add_offense(node_or_range, location: :expression, message: nil, severity: nil, &block)
def add_offense(node_or_range, location: :expression, message: nil, severity: nil, &block) @v0_argument = node_or_range range = find_location(node_or_range, location) # Since this range may be generated from Ruby code embedded in some # template file, we convert it to location info in the original file. range = range_for_original(range) if block.nil? && !self.class.support_autocorrect? super(range, message: message, severity: severity) else super(range, message: message, severity: severity) do |corrector| emulate_v0_callsequence(corrector, &block) end end end
def apply_correction(corrector)
def apply_correction(corrector) suppress_clobbering { super } end
def begin_investigation(processed_source, offset: 0, original: processed_source)
- Api: - private
def begin_investigation(processed_source, offset: 0, original: processed_source) super @offenses = current_offenses @last_corrector = @current_corrector # We need to keep track of the original source and offset, # because `processed_source` here may be an embedded code in it. @current_offset = offset @current_original = original end
def callback_argument(_range)
def callback_argument(_range) @v0_argument end
def correction_lambda
def correction_lambda return unless self.class.support_autocorrect? dedupe_on_node(@v0_argument) { autocorrect(@v0_argument) } end
def corrections
def corrections warn Rainbow(<<~WARNING).yellow, uplevel: 1 `Cop#corrections` is deprecated. WARNING return [] unless @last_corrector Legacy::CorrectionsProxy.new(@last_corrector) end
def dedupe_on_node(node)
def dedupe_on_node(node) @corrected_nodes ||= {}.compare_by_identity yield unless @corrected_nodes.key?(node) ensure @corrected_nodes[node] = true end
def emulate_v0_callsequence(corrector)
def emulate_v0_callsequence(corrector) lambda = correction_lambda yield corrector if block_given? unless corrector.empty? raise 'Your cop must inherit from Cop::Base and extend AutoCorrector' end return unless lambda suppress_clobbering { lambda.call(corrector) } end
def find_location(node, loc)
def find_location(node, loc) # Location can be provided as a symbol, e.g.: `:keyword` loc.is_a?(Symbol) ? node.loc.public_send(loc) : loc end
def highlights
def highlights offenses.sort.map { |o| o.location.source } end
def messages
def messages offenses.sort.map(&:message) end
def on_investigation_end
def on_investigation_end investigate_post_walk(processed_source) if respond_to?(:investigate_post_walk) super end
def on_new_investigation
def on_new_investigation investigate(processed_source) if respond_to?(:investigate) super end
def range_for_original(range)
def range_for_original(range) ::Parser::Source::Range.new( @current_original.buffer, range.begin_pos + @current_offset, range.end_pos + @current_offset ) end
def support_autocorrect?
- Use class method
def support_autocorrect? warn Rainbow(<<~WARNING).yellow, uplevel: 1 `support_autocorrect?` is deprecated. Use `cop.class.support_autocorrect?`. WARNING self.class.support_autocorrect? end
def suppress_clobbering
def suppress_clobbering yield rescue ::Parser::ClobberingError # ignore Clobbering errors end