Class: RuboCop::Cop::Cop

# File 'lib/rubocop/cop/cop.rb', line 100

def initialize(config = nil, options = nil)
  @config = config || Config.new
  @options = options || { debug: false }

  @offenses = []
  @corrections = []
  @corrected_nodes = {}
  @corrected_nodes.compare_by_identity
  @processed_source = nil
end

Class Attribute Details

.registry ⇒ `Object` (readonly)

Returns the value of attribute registry



50
51
52

# File 'lib/rubocop/cop/cop.rb', line 50

def registry
  @registry
end

Instance Attribute Details

#config ⇒ `Object` (readonly)

Returns the value of attribute config



44
45
46

# File 'lib/rubocop/cop/cop.rb', line 44

def config
  @config
end

#corrections ⇒ `Object` (readonly)

Returns the value of attribute corrections



44
45
46

# File 'lib/rubocop/cop/cop.rb', line 44

def corrections
  @corrections
end

#offenses ⇒ `Object` (readonly)

Returns the value of attribute offenses



44
45
46

# File 'lib/rubocop/cop/cop.rb', line 44

def offenses
  @offenses
end

#processed_source ⇒ `Object`

TODO: Bad design.



45
46
47

# File 'lib/rubocop/cop/cop.rb', line 45

def processed_source
  @processed_source
end

Class Method Details

.all ⇒ `Object`



53
54
55

# File 'lib/rubocop/cop/cop.rb', line 53

def self.all
  registry.without_department(:Test).cops
end

.autocorrect_incompatible_with ⇒ `Array<RuboCop::Cop::Cop>`

List of cops that should not try to autocorrect at the same time as this cop



96
97
98

# File 'lib/rubocop/cop/cop.rb', line 96

def self.autocorrect_incompatible_with
  []
end

.badge ⇒ `Object`



65
66
67

# File 'lib/rubocop/cop/cop.rb', line 65

def self.badge
  @badge ||= Badge.for(name)
end

.cop_name ⇒ `Object`



69
70
71

# File 'lib/rubocop/cop/cop.rb', line 69

def self.cop_name
  badge.to_s
end

.department ⇒ `Object`



73
74
75

# File 'lib/rubocop/cop/cop.rb', line 73

def self.department
  badge.department
end

.inherited(subclass) ⇒ `Object`



61
62
63

# File 'lib/rubocop/cop/cop.rb', line 61

def self.inherited(subclass)
  registry.enlist(subclass)
end

.lint? ⇒ `Boolean`



77
78
79

# File 'lib/rubocop/cop/cop.rb', line 77

def self.lint?
  department == :Lint
end

.match?(given_names) ⇒ `Boolean`

Returns true if the cop name or the cop namespace matches any of the given names.

# File 'lib/rubocop/cop/cop.rb', line 83

def self.match?(given_names)
  return false unless given_names

  given_names.include?(cop_name) ||
    given_names.include?(department.to_s)
end

.qualified_cop_name(name, origin) ⇒ `Object`



57
58
59

# File 'lib/rubocop/cop/cop.rb', line 57

def self.qualified_cop_name(name, origin)
  registry.qualified_cop_name(name, origin)
end

Instance Method Details

#add_offense(node, location: :expression, message: nil, severity: nil) ⇒ `Object`

rubocop:disable Metrics/CyclomaticComplexity

# File 'lib/rubocop/cop/cop.rb', line 127

def add_offense(node, location: :expression, message: nil, severity: nil)
  loc = find_location(node, location)

  return if duplicate_location?(loc)

  severity = custom_severity || severity || default_severity

  message ||= message(node)
  message = annotate(message)

  status = enabled_line?(loc.line) ? correct(node) : :disabled

  @offenses << Offense.new(severity, loc, message, name, status)
  yield if block_given? && status != :disabled
end

#config_to_allow_offenses ⇒ `Object`

# File 'lib/rubocop/cop/cop.rb', line 186

def config_to_allow_offenses
  Formatter::DisabledConfigFormatter
    .config_to_allow_offenses[cop_name] ||= {}
end

#config_to_allow_offenses=(hash) ⇒ `Object`

# File 'lib/rubocop/cop/cop.rb', line 191

def config_to_allow_offenses=(hash)
  Formatter::DisabledConfigFormatter.config_to_allow_offenses[cop_name] =
    hash
end

#cop_config ⇒ `Object`

# File 'lib/rubocop/cop/cop.rb', line 115

def cop_config
  # Use department configuration as basis, but let individual cop
  # configuration override.
  @cop_config ||= @config.for_cop(self.class.department.to_s)
                         .merge(@config.for_cop(self))
end

#cop_name ⇒ `Object` Also known as: name



208
209
210

# File 'lib/rubocop/cop/cop.rb', line 208

def cop_name
  @cop_name ||= self.class.cop_name
end

#correct(node) ⇒ `Object`

# File 'lib/rubocop/cop/cop.rb', line 153

def correct(node)
  reason = reason_to_not_correct(node)
  return reason if reason

  @corrected_nodes[node] = true
  if support_autocorrect?
    correction = autocorrect(node)
    return :uncorrected unless correction

    @corrections << Correction.new(correction, node, self)
  elsif disable_uncorrectable?
    disable_uncorrectable(node)
  end
  :corrected
end

#disable_uncorrectable(node) ⇒ `Object`

# File 'lib/rubocop/cop/cop.rb', line 177

def disable_uncorrectable(node)
  @disabled_lines ||= {}
  line = node.location.line
  return if @disabled_lines.key?(line)

  @disabled_lines[line] = true
  @corrections << Correction.new(disable_offense(node), node, self)
end

#duplicate_location?(location) ⇒ `Boolean`



149
150
151

# File 'lib/rubocop/cop/cop.rb', line 149

def duplicate_location?(location)
  @offenses.any? { |o| o.location == location }
end

#excluded_file?(file) ⇒ `Boolean`



219
220
221

# File 'lib/rubocop/cop/cop.rb', line 219

def excluded_file?(file)
  !relevant_file?(file)
end

#find_location(node, loc) ⇒ `Object`

rubocop:enable Metrics/CyclomaticComplexity

# File 'lib/rubocop/cop/cop.rb', line 144

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

#highlights ⇒ `Object`



89
90
91

# File 'lib/rubocop/rspec/cop_helper.rb', line 89

def highlights
  offenses.sort.map { |o| o.location.source }
end

#join_force?(_force_class) ⇒ `Boolean`



111
112
113

# File 'lib/rubocop/cop/cop.rb', line 111

def join_force?(_force_class)
  false
end

#message(_node = nil) ⇒ `Object`



122
123
124

# File 'lib/rubocop/cop/cop.rb', line 122

def message(_node = nil)
  self.class::MSG
end

#messages ⇒ `Object`



85
86
87

# File 'lib/rubocop/rspec/cop_helper.rb', line 85

def messages
  offenses.sort.map(&:message)
end

#parse(source, path = nil) ⇒ `Object`



204
205
206

# File 'lib/rubocop/cop/cop.rb', line 204

def parse(source, path = nil)
  ProcessedSource.new(source, target_ruby_version, path)
end

#reason_to_not_correct(node) ⇒ `Object`

# File 'lib/rubocop/cop/cop.rb', line 169

def reason_to_not_correct(node)
  return :unsupported unless correctable?
  return :uncorrected unless autocorrect?
  return :already_corrected if @corrected_nodes.key?(node)

  nil
end

#relevant_file?(file) ⇒ `Boolean`

# File 'lib/rubocop/cop/cop.rb', line 214

def relevant_file?(file)
  file_name_matches_any?(file, 'Include', true) &&
    !file_name_matches_any?(file, 'Exclude', false)
end

#target_rails_version ⇒ `Object`



200
201
202

# File 'lib/rubocop/cop/cop.rb', line 200

def target_rails_version
  @config.target_rails_version
end

#target_ruby_version ⇒ `Object`



196
197
198

# File 'lib/rubocop/cop/cop.rb', line 196

def target_ruby_version
  @config.target_ruby_version
end

Class: RuboCop::Cop::Cop

Overview

Direct Known Subclasses

Defined Under Namespace

Constant Summary

Constants included from Util

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from NodePattern::Macros

Methods included from AST::Sexp

Methods included from AutocorrectLogic

Methods included from IgnoredNode

Methods included from Util

Methods included from PathUtil

Constructor Details

#initialize(config = nil, options = nil) ⇒ Cop

Class Attribute Details

.registry ⇒ Object (readonly)

Instance Attribute Details

#config ⇒ Object (readonly)

#corrections ⇒ Object (readonly)

#offenses ⇒ Object (readonly)

#processed_source ⇒ Object

Class Method Details

.all ⇒ Object

.autocorrect_incompatible_with ⇒ Array<RuboCop::Cop::Cop>

.badge ⇒ Object

.cop_name ⇒ Object

.department ⇒ Object

.inherited(subclass) ⇒ Object

.lint? ⇒ Boolean

.match?(given_names) ⇒ Boolean

.qualified_cop_name(name, origin) ⇒ Object

Instance Method Details

#add_offense(node, location: :expression, message: nil, severity: nil) ⇒ Object

#config_to_allow_offenses ⇒ Object

#config_to_allow_offenses=(hash) ⇒ Object

#cop_config ⇒ Object

#cop_name ⇒ Object Also known as: name

#correct(node) ⇒ Object

#disable_uncorrectable(node) ⇒ Object

#duplicate_location?(location) ⇒ Boolean

#excluded_file?(file) ⇒ Boolean

#find_location(node, loc) ⇒ Object

#highlights ⇒ Object

#join_force?(_force_class) ⇒ Boolean

#message(_node = nil) ⇒ Object

#messages ⇒ Object

#parse(source, path = nil) ⇒ Object

#reason_to_not_correct(node) ⇒ Object

#relevant_file?(file) ⇒ Boolean

#target_rails_version ⇒ Object

#target_ruby_version ⇒ Object

#initialize(config = nil, options = nil) ⇒ `Cop`