Sha256: fef9837ea7d16fe5529fcb53fa98ba96992e95e830c33b58395dae8715511c04

Contents?: true

Size: 1.45 KB

Versions: 36

Compression:

Stored size: 1.45 KB

Contents

# frozen_string_literal: true

module RuboCop
  module Cop
    module Style
      # Identifies places where `$stderr.puts` can be replaced by
      # `warn`. The latter has the advantage of easily being disabled by,
      # the `-W0` interpreter flag or setting `$VERBOSE` to `nil`.
      #
      # @example
      #   # bad
      #   $stderr.puts('hello')
      #
      #   # good
      #   warn('hello')
      #
      class StderrPuts < Base
        include RangeHelp
        extend AutoCorrector

        MSG = 'Use `warn` instead of `%<bad>s` to allow such output to be disabled.'
        RESTRICT_ON_SEND = %i[puts].freeze

        # @!method stderr_puts?(node)
        def_node_matcher :stderr_puts?, <<~PATTERN
          (send
            {(gvar #stderr_gvar?) (const {nil? cbase} :STDERR)}
            :puts $_
            ...)
        PATTERN

        def on_send(node)
          return unless stderr_puts?(node)

          message = message(node)
          add_offense(stderr_puts_range(node), message: message) do |corrector|
            corrector.replace(stderr_puts_range(node), 'warn')
          end
        end

        private

        def message(node)
          format(MSG, bad: "#{node.receiver.source}.#{node.method_name}")
        end

        def stderr_gvar?(sym)
          sym == :$stderr
        end

        def stderr_puts_range(send)
          range_between(send.loc.expression.begin_pos, send.loc.selector.end_pos)
        end
      end
    end
  end
end

Version data entries

36 entries across 32 versions & 4 rubygems

Version Path
cm-admin-1.5.22 vendor/bundle/ruby/3.3.0/gems/rubocop-1.35.1/lib/rubocop/cop/style/stderr_puts.rb
cm-admin-1.5.21 vendor/bundle/ruby/3.3.0/gems/rubocop-1.35.1/lib/rubocop/cop/style/stderr_puts.rb
cm-admin-1.5.20 vendor/bundle/ruby/3.3.0/gems/rubocop-1.35.1/lib/rubocop/cop/style/stderr_puts.rb
scrapbook-0.3.2 vendor/ruby/2.7.0/gems/rubocop-1.31.2/lib/rubocop/cop/style/stderr_puts.rb
scrapbook-0.3.2 vendor/ruby/2.7.0/gems/rubocop-1.35.1/lib/rubocop/cop/style/stderr_puts.rb
scrapbook-0.3.2 vendor/ruby/2.7.0/gems/rubocop-1.36.0/lib/rubocop/cop/style/stderr_puts.rb
scrapbook-0.3.1 vendor/ruby/2.7.0/gems/rubocop-1.31.2/lib/rubocop/cop/style/stderr_puts.rb
scrapbook-0.3.1 vendor/ruby/2.7.0/gems/rubocop-1.35.1/lib/rubocop/cop/style/stderr_puts.rb
scrapbook-0.3.1 vendor/ruby/2.7.0/gems/rubocop-1.36.0/lib/rubocop/cop/style/stderr_puts.rb
zilla-0.2.0 vendor/bundle/ruby/3.2.0/gems/rubocop-1.46.0/lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.46.0 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.45.1 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.45.0 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.44.1 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.44.0 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.43.0 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.42.0 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.41.1 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.41.0 lib/rubocop/cop/style/stderr_puts.rb
rubocop-1.40.0 lib/rubocop/cop/style/stderr_puts.rb