Sha256: f279b71330cda54652c2dca701da879649014425771b75d6edcf864561cbf32c

Contents?: true

Size: 1.71 KB

Versions: 151

Compression:

Stored size: 1.71 KB

Contents

# frozen_string_literal: true

module RuboCop
  module Cop
    module Style
      # Looks for uses of block comments (=begin...=end).
      #
      # @example
      #   # bad
      #   =begin
      #   Multiple lines
      #   of comments...
      #   =end
      #
      #   # good
      #   # Multiple lines
      #   # of comments...
      #
      class BlockComments < Base
        include RangeHelp
        extend AutoCorrector

        MSG = 'Do not use block comments.'
        BEGIN_LENGTH = "=begin\n".length
        END_LENGTH = "\n=end".length

        def on_new_investigation
          processed_source.comments.each do |comment|
            next unless comment.document?

            add_offense(comment) do |corrector|
              eq_begin, eq_end, contents = parts(comment)

              corrector.remove(eq_begin)
              unless contents.empty?
                corrector.replace(
                  contents,
                  contents.source.gsub(/\A/, '# ').gsub("\n\n", "\n#\n").gsub(/\n(?=[^#])/, "\n# ")
                )
              end
              corrector.remove(eq_end)
            end
          end
        end

        private

        def parts(comment)
          expr = comment.source_range
          eq_begin = expr.resize(BEGIN_LENGTH)
          eq_end = eq_end_part(comment, expr)
          contents = range_between(eq_begin.end_pos, eq_end.begin_pos)
          [eq_begin, eq_end, contents]
        end

        def eq_end_part(comment, expr)
          if comment.text.chomp == comment.text
            range_between(expr.end_pos - END_LENGTH - 1, expr.end_pos - 2)
          else
            range_between(expr.end_pos - END_LENGTH, expr.end_pos)
          end
        end
      end
    end
  end
end

Version data entries

151 entries across 151 versions & 15 rubygems

Version Path
rubocop-1.74.0 lib/rubocop/cop/style/block_comments.rb
rubocop-1.73.2 lib/rubocop/cop/style/block_comments.rb
siteimprove_api_client-1.0.1 vendor/bundle/ruby/3.2.0/gems/rubocop-1.73.1/lib/rubocop/cop/style/block_comments.rb
rubocop-1.73.1 lib/rubocop/cop/style/block_comments.rb
rubocop-1.73.0 lib/rubocop/cop/style/block_comments.rb
rubocop-1.72.2 lib/rubocop/cop/style/block_comments.rb
rubocop-1.72.1 lib/rubocop/cop/style/block_comments.rb
rubocop-1.72.0 lib/rubocop/cop/style/block_comments.rb
rubocop-1.71.2 lib/rubocop/cop/style/block_comments.rb
tailscale_middleware-0.0.3 vendor/cache/ruby/3.4.0/gems/rubocop-1.71.1/lib/rubocop/cop/style/block_comments.rb
rubocop-1.71.1 lib/rubocop/cop/style/block_comments.rb
rubocop-1.71.0 lib/rubocop/cop/style/block_comments.rb
rubocop-1.70.0 lib/rubocop/cop/style/block_comments.rb
minato_ruby_api_client-0.2.2 vendor/bundle/ruby/3.2.0/gems/rubocop-1.64.1/lib/rubocop/cop/style/block_comments.rb
rubocop-1.69.2 lib/rubocop/cop/style/block_comments.rb
rubocop-1.69.1 lib/rubocop/cop/style/block_comments.rb
rubocop-1.69.0 lib/rubocop/cop/style/block_comments.rb
rubocop-1.68.0 lib/rubocop/cop/style/block_comments.rb
rubocop-1.67.0 lib/rubocop/cop/style/block_comments.rb
rubocop-1.66.1 lib/rubocop/cop/style/block_comments.rb