class RuboCop::Cop::Layout::EmptyLinesAroundAccessModifier

Access modifiers should be surrounded by blank lines.

@example EnforcedStyle: around (default)

# bad
class Foo
  def bar; end
  private
  def baz; end
end

# good
class Foo
  def bar; end

  private

  def baz; end
end

@example EnforcedStyle: only_before

# bad
class Foo
  def bar; end
  private
  def baz; end
end

# good
class Foo
  def bar; end

  private
  def baz; end
end

Constants

MSG_AFTER
MSG_AFTER_FOR_ONLY_BEFORE
MSG_BEFORE_AND_AFTER
MSG_BEFORE_FOR_ONLY_BEFORE
RESTRICT_ON_SEND

Public Class Methods

new(config = nil, options = nil) click to toggle source
Calls superclass method RuboCop::Cop::Base::new
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 56
def initialize(config = nil, options = nil)
  super

  @block_line = nil
end

Public Instance Methods

on_block(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 81
def on_block(node)
  @block_line = node.source_range.first_line
end
Also aliased as: on_numblock
on_class(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 62
def on_class(node)
  @class_or_module_def_first_line = if node.parent_class
                                      node.parent_class.first_line
                                    else
                                      node.source_range.first_line
                                    end
  @class_or_module_def_last_line = node.source_range.last_line
end
on_module(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 71
def on_module(node)
  @class_or_module_def_first_line = node.source_range.first_line
  @class_or_module_def_last_line = node.source_range.last_line
end
on_numblock(node)
Alias for: on_block
on_sclass(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 76
def on_sclass(node)
  @class_or_module_def_first_line = node.identifier.source_range.first_line
  @class_or_module_def_last_line = node.source_range.last_line
end
on_send(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 87
def on_send(node) # rubocop:disable Metrics/CyclomaticComplexity
  return unless node.bare_access_modifier? &&
                !(node.parent&.block_type? || node.parent&.numblock_type?)
  return if expected_empty_lines?(node)

  message = message(node)
  add_offense(node, message: message) do |corrector|
    line = range_by_whole_lines(node.source_range)

    corrector.insert_before(line, "\n") unless previous_line_empty?(node.first_line)

    correct_next_line_if_denied_style(corrector, node, line)
  end
end

Private Instance Methods

allowed_only_before_style?(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 115
def allowed_only_before_style?(node)
  if node.special_modifier?
    return true if processed_source[node.last_line] == 'end'
    return false if next_line_empty?(node.last_line)
  end

  previous_line_empty?(node.first_line)
end
block_start?(line) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 164
def block_start?(line)
  return false unless @block_line

  line == @block_line + 1
end
body_end?(line) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 170
def body_end?(line)
  return false unless @class_or_module_def_last_line

  line == @class_or_module_def_last_line - 1
end
class_def?(line) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 158
def class_def?(line)
  return false unless @class_or_module_def_first_line

  line == @class_or_module_def_first_line + 1
end
correct_next_line_if_denied_style(corrector, node, line) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 124
def correct_next_line_if_denied_style(corrector, node, line)
  case style
  when :around
    corrector.insert_after(line, "\n") unless next_line_empty?(node.last_line)
  when :only_before
    if next_line_empty?(node.last_line)
      range = next_empty_line_range(node)

      corrector.remove(range)
    end
  end
end
empty_lines_around?(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 154
def empty_lines_around?(node)
  previous_line_empty?(node.first_line) && next_line_empty?(node.last_line)
end
expected_empty_lines?(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 104
def expected_empty_lines?(node)
  case style
  when :around
    return true if empty_lines_around?(node)
  when :only_before
    return true if allowed_only_before_style?(node)
  end

  false
end
message(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 180
def message(node)
  case style
  when :around
    message_for_around_style(node)
  when :only_before
    message_for_only_before_style(node)
  end
end
message_for_around_style(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 189
def message_for_around_style(node)
  send_line = node.first_line

  if block_start?(send_line) || class_def?(send_line)
    format(MSG_AFTER, modifier: node.loc.selector.source)
  else
    format(MSG_BEFORE_AND_AFTER, modifier: node.loc.selector.source)
  end
end
message_for_only_before_style(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 199
def message_for_only_before_style(node)
  modifier = node.loc.selector.source

  if next_line_empty?(node.last_line)
    format(MSG_AFTER_FOR_ONLY_BEFORE, modifier: modifier)
  else
    format(MSG_BEFORE_FOR_ONLY_BEFORE, modifier: modifier)
  end
end
next_empty_line_range(node) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 176
def next_empty_line_range(node)
  source_range(processed_source.buffer, node.last_line + 1, 0)
end
next_line_empty?(last_send_line) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 148
def next_line_empty?(last_send_line)
  next_line = processed_source[last_send_line]

  body_end?(last_send_line) || next_line.blank?
end
previous_line_empty?(send_line) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 141
def previous_line_empty?(send_line)
  previous_line = previous_line_ignoring_comments(processed_source, send_line)
  return true unless previous_line

  block_start?(send_line) || class_def?(send_line) || previous_line.blank?
end
previous_line_ignoring_comments(processed_source, send_line) click to toggle source
# File lib/rubocop/cop/layout/empty_lines_around_access_modifier.rb, line 137
def previous_line_ignoring_comments(processed_source, send_line)
  processed_source[0..send_line - 2].reverse.find { |line| !comment_line?(line) }
end