Module: RuboCop::Cop::ConfigurableFormatting

Includes:
ConfigurableEnforcedStyle
Included in:
ConfigurableNaming, ConfigurableNumbering
Defined in:
lib/rubocop/cop/mixin/configurable_formatting.rb

Overview

Shared functionality between mixins that enforce naming conventions

Instance Method Summary collapse

Methods included from ConfigurableEnforcedStyle

#alternative_style, #alternative_styles, #ambiguous_style_detected, #correct_style_detected, #detected_style, #detected_style=, #no_acceptable_style!, #no_acceptable_style?, #opposite_style_detected, #style, #style_configured?, #style_detected, #style_parameter_name, #supported_styles, #unexpected_style_detected

Instance Method Details

#check_name(node, name, name_range) ⇒ Object 



9
10
11
12
13
14
15
 
# File 'lib/rubocop/cop/mixin/configurable_formatting.rb', line 9

def check_name(node, name, name_range)
  if valid_name?(node, name)
    correct_style_detected
  else
    add_offense(name_range, message: message(style)) { report_opposing_styles(node, name) }
  end
end

#class_emitter_method?(node, name) ⇒ Boolean

A class emitter method is a singleton method in a class/module, where the method has the same name as a class defined in the class/module.

Returns:

  • (Boolean) 


30
31
32
33
34
35
36
37
38
 
# File 'lib/rubocop/cop/mixin/configurable_formatting.rb', line 30

def class_emitter_method?(node, name)
  return false unless node.parent && node.defs_type?

  # a class emitter method may be defined inside `def self.included`,
  # `def self.extended`, etc.
  node = node.parent while node.parent.defs_type?

  node.parent.each_child_node(:class).any? { |c| c.loc.name.is?(name.to_s) }
end

#report_opposing_styles(node, name) ⇒ Object 



17
18
19
20
21
22
 
# File 'lib/rubocop/cop/mixin/configurable_formatting.rb', line 17

def report_opposing_styles(node, name)
  alternative_styles.each do |alternative|
    return unexpected_style_detected(alternative) if valid_name?(node, name, alternative)
  end
  unrecognized_style_detected
end

#valid_name?(node, name, given_style = style) ⇒ Boolean

Returns:

  • (Boolean) 


24
25
26
 
# File 'lib/rubocop/cop/mixin/configurable_formatting.rb', line 24

def valid_name?(node, name, given_style = style)
  name.match?(self.class::FORMATS.fetch(given_style)) || class_emitter_method?(node, name)
end