Class: RuboCop::Cop::MessageAnnotator

Inherits:
Object
  • Object
show all
Defined in:
lib/rubocop/cop/message_annotator.rb

Overview

Message Annotator class annotates a basic offense message based on params passed into initializer.

#=> 'Cop/CopName: message (http://example.org/styleguide)'

Examples:

RuboCop::Cop::MessageAnnotator.new(
  config, cop_config, @options
).annotate('message', 'Cop/CopName')

See Also:

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(config, cop_config, options) ⇒ MessageAnnotator

Returns a new instance of MessageAnnotator.

Parameters:

  • config (RuboCop::Config) —

    Check configs for all cops @note Message Annotator specifically checks the

    following config options for_all_cops
:StyleGuideBaseURL [String] URL for styleguide
:DisplayStyleGuide [Boolean] Include styleguide and reference URLs
:ExtraDetails [Boolean] Include cop details
:DisplayCopNames [Boolean] Include cop name
  • cop_config (Hash) —

    configs for specific cop, from config#for_cop

  • options (Hash)
  • option (Hash) —

    a customizable set of options

Options Hash (cop_config):

  • :StyleGuide (String) —

    Extension of base styleguide URL

  • :Reference (String) —

    Full reference URL

  • :Details (String) 


40
41
42
43
44
 
# File 'lib/rubocop/cop/message_annotator.rb', line 40

def initialize(config, cop_config, options)
  @config = config
  @cop_config = cop_config || {}
  @options = options
end

Instance Attribute Details

#config ⇒ Object (readonly)

Returns the value of attribute config.



16
17
18
 
# File 'lib/rubocop/cop/message_annotator.rb', line 16

def config
  @config
end

#cop_config ⇒ Object (readonly)

Returns the value of attribute cop_config.



16
17
18
 
# File 'lib/rubocop/cop/message_annotator.rb', line 16

def cop_config
  @cop_config
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



16
17
18
 
# File 'lib/rubocop/cop/message_annotator.rb', line 16

def options
  @options
end

Instance Method Details

#annotate(message, name) ⇒ String

Returns the annotated message, based on params passed into initializer

Returns:

  • (String) —

    annotated message



50
51
52
53
54
55
56
57
58
 
# File 'lib/rubocop/cop/message_annotator.rb', line 50

def annotate(message, name)
  message = "#{name}: #{message}" if display_cop_names?
  message += " #{details}" if extra_details?
  if display_style_guide?
    links = [style_guide_url, reference_url].compact.join(', ')
    message = "#{message} (#{links})"
  end
  message
end