Class: RuboCop::Cop::Style::IndentationWidth

Inherits:
Cop
  • Object
show all
Includes:
AccessModifierNode, AutocorrectAlignment, CheckAssignment, EndKeywordAlignment, IfNode, OnMethodDef
Defined in:
lib/rubocop/cop/style/indentation_width.rb

Overview

This cops checks for indentation that doesn’t use two spaces.

Examples:


class A
 def test
  puts 'hello'
 end
end

Constant Summary collapse

SPECIAL_MODIFIERS =
%w(private protected).freeze

Constants included from AccessModifierNode

AccessModifierNode::MODULE_FUNCTION_NODE, AccessModifierNode::PRIVATE_NODE, AccessModifierNode::PROTECTED_NODE, AccessModifierNode::PUBLIC_NODE

Constants included from AutocorrectAlignment

AutocorrectAlignment::SPACE

Constants included from EndKeywordAlignment

EndKeywordAlignment::MSG

Constants included from Util

Util::ASGN_NODES, Util::BYTE_ORDER_MARK, Util::EQUALS_ASGN_NODES, Util::LITERAL_REGEX, Util::OPERATOR_METHODS, Util::SHORTHAND_ASGN_NODES

Instance Attribute Summary

Attributes inherited from Cop

#config, #corrections, #offenses, #processed_source

Instance Method Summary collapse

Methods included from AccessModifierNode

#class_or_module_parent?, #modifier_node?, #modifier_structure?

Methods included from Sexp

#s

Methods included from IfNode

#elsif?, #if_else?, #if_node_parts, #modifier_if?, #ternary?

Methods included from NodePattern::Macros

#def_node_matcher, #def_node_search, #node_search, #node_search_all, #node_search_body, #node_search_first

Methods included from CheckAssignment

extract_rhs

Methods included from OnMethodDef

#on_def, #on_defs

Methods included from AutocorrectAlignment

#autocorrect, #check_alignment, #display_column, #indentation, #offset

Methods included from ConfigurableEnforcedStyle

#alternative_style, #ambiguous_style_detected, #correct_style_detected, #detected_style, #detected_style=, #no_acceptable_style!, #no_acceptable_style?, #opposite_style_detected, #parameter_name, #style, #style_detected, #supported_styles, #unexpected_style_detected

Methods inherited from Cop

#add_offense, all, #config_to_allow_offenses, #config_to_allow_offenses=, #cop_config, cop_name, #cop_name, cop_type, #correct, #debug?, #details, #display_cop_names?, #display_style_guide?, #duplicate_location?, #excluded_file?, #extra_details?, #find_location, #highlights, inherited, #initialize, #join_force?, lint?, match?, #message, #messages, non_rails, #parse, qualified_cop_name, #reference_url, #relevant_file?, #style_guide_url, #target_ruby_version

Methods included from AutocorrectLogic

#autocorrect?, #autocorrect_enabled?, #autocorrect_requested?, #support_autocorrect?

Methods included from IgnoredNode

#ignore_node, #ignored_node?, #part_of_ignored_node?

Methods included from Util

begins_its_line?, block_length, comment_line?, directions, double_quotes_acceptable?, double_quotes_required?, effective_column, ends_its_line?, escape_string, first_part_of_call_chain, interpret_string_escapes, line_distance, line_range, move_pos, needs_escaping?, numeric_range_size, on_node, operator?, parentheses?, parenthesized_call?, preceed?, range_between, range_with_surrounding_comma, range_with_surrounding_space, same_line?, source_range, strip_quotes, stripped_source_upto, to_string_literal, to_symbol_literal, within_node?

Methods included from PathUtil

absolute?, match_path?, relative_path

Constructor Details

This class inherits a constructor from RuboCop::Cop::Cop

Instance Method Details

#check_members(node, members) ⇒ Object



66
67
68
69
70
71
72
73
74
75
76
# File 'lib/rubocop/cop/style/indentation_width.rb', line 66

def check_members(node, members)
  check_indentation(node.loc.keyword, members.first)

  return unless members.any? && members.first.begin_type?
  return unless indentation_consistency_style == 'rails'

  each_member(members) do |member, previous_modifier|
    check_indentation(previous_modifier, member,
                      indentation_consistency_style)
  end
end

#on_block(node) ⇒ Object



47
48
49
50
51
52
53
54
# File 'lib/rubocop/cop/style/indentation_width.rb', line 47

def on_block(node)
  _method, _args, body = *node
  # Check body against end/} indentation. Checking against variable
  # assignments, etc, would be more difficult. The end/} must be at the
  # beginning of its line.
  loc = node.loc
  check_indentation(loc.end, body) if begins_its_line?(loc.end)
end

#on_case(node) ⇒ Object



114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
# File 'lib/rubocop/cop/style/indentation_width.rb', line 114

def on_case(node)
  _condition, *branches = *node
  latest_when = nil
  branches.compact.each do |b|
    if b.when_type?
      # TODO: Revert to the original expression once the fix in Rubinius
      #   is released.
      #
      # Originally this expression was:
      #
      #   *_conditions, body = *b
      #
      # However it fails on Rubinius 2.2.9 due to its bug:
      #
      #   RuntimeError:
      #     can't modify frozen instance of Array
      #   # kernel/common/array.rb:988:in `pop'
      #   # ./lib/rubocop/cop/style/indentation_width.rb:99:in `on_case'
      #
      # It seems to be fixed on the current master (0a92c3c).
      body = b.children.last

      # Check "when" body against "when" keyword indentation.
      check_indentation(b.loc.keyword, body)
      latest_when = b
    else
      # Since it's not easy to get the position of the "else" keyword,
      # we check "else" body against latest "when" keyword indentation.
      check_indentation(latest_when.loc.keyword, b)
    end
  end
end

#on_class(node) ⇒ Object



61
62
63
64
# File 'lib/rubocop/cop/style/indentation_width.rb', line 61

def on_class(node)
  _class_name, _base_class, *members = *node
  check_members(node, members)
end

#on_ensure(node) ⇒ Object



35
36
37
38
# File 'lib/rubocop/cop/style/indentation_width.rb', line 35

def on_ensure(node)
  _body, ensure_body = *node
  check_indentation(node.loc.keyword, ensure_body)
end

#on_for(node) ⇒ Object



97
98
99
100
# File 'lib/rubocop/cop/style/indentation_width.rb', line 97

def on_for(node)
  _variable, _collection, body = *node
  check_indentation(node.loc.keyword, body)
end

#on_if(node, base = node) ⇒ Object



147
148
149
150
151
152
153
154
155
# File 'lib/rubocop/cop/style/indentation_width.rb', line 147

def on_if(node, base = node)
  return if ignored_node?(node)
  return if ternary?(node)
  return if modifier_if?(node)

  _condition, body, else_clause = if_node_parts(node)

  check_if(node, body, else_clause, base.loc) if body
end

#on_kwbegin(node) ⇒ Object



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

def on_kwbegin(node)
  # Check indentation against end keyword but only if it's first on its
  # line.
  return unless begins_its_line?(node.loc.end)
  check_indentation(node.loc.end, node.children.first)
end

#on_method_def(node, _method_name, _args, body) ⇒ Object



93
94
95
# File 'lib/rubocop/cop/style/indentation_width.rb', line 93

def on_method_def(node, _method_name, _args, body)
  check_indentation(node.loc.keyword, body) unless ignored_node?(node)
end

#on_module(node) ⇒ Object



56
57
58
59
# File 'lib/rubocop/cop/style/indentation_width.rb', line 56

def on_module(node)
  _module_name, *members = *node
  check_members(node, members)
end

#on_rescue(node) ⇒ Object



26
27
28
29
30
31
32
33
# File 'lib/rubocop/cop/style/indentation_width.rb', line 26

def on_rescue(node)
  _begin_node, *rescue_nodes, else_node = *node
  rescue_nodes.each do |rescue_node|
    _, _, body = *rescue_node
    check_indentation(rescue_node.loc.keyword, body)
  end
  check_indentation(node.loc.else, else_node)
end

#on_send(node) ⇒ Object



78
79
80
81
82
83
84
85
86
87
88
89
90
91
# File 'lib/rubocop/cop/style/indentation_width.rb', line 78

def on_send(node)
  super
  return unless modifier_and_def_on_same_line?(node)
  _, _, *args = *node

  *_, body = *args.first

  def_end_config = config.for_cop('Lint/DefEndAlignment')
  style = def_end_config['AlignWith'] || 'start_of_line'
  base = style == 'def' ? args.first : node

  check_indentation(base.source_range, body)
  ignore_node(args.first)
end

#on_while(node, base = node) ⇒ Object Also known as: on_until



102
103
104
105
106
107
108
109
110
# File 'lib/rubocop/cop/style/indentation_width.rb', line 102

def on_while(node, base = node)
  return if ignored_node?(node)

  _condition, body = *node
  return unless node.loc.keyword.begin_pos ==
                node.source_range.begin_pos

  check_indentation(base.loc, body)
end