Sha256: a3924aae16c1c4adf45975d7a96e887f1a72528419b02f60ab38147bdd536d6b

Contents?: true

Size: 1.64 KB

Versions: 22

Compression:

Stored size: 1.64 KB

Contents

# frozen_string_literal: true

module RuboCop
  module Cop
    module Style
      # This cop checks that `include`, `extend` and `prepend` statements appear
      # inside classes and modules, not at the top level, so as to not affect
      # the behavior of `Object`.
      #
      # @example
      #   # bad
      #   include M
      #
      #   class C
      #   end
      #
      #   # bad
      #   extend M
      #
      #   class C
      #   end
      #
      #   # bad
      #   prepend M
      #
      #   class C
      #   end
      #
      #   # good
      #   class C
      #     include M
      #   end
      #
      #   # good
      #   class C
      #     extend M
      #   end
      #
      #   # good
      #   class C
      #     prepend M
      #   end
      class MixinUsage < Base
        MSG = '`%<statement>s` is used at the top level. Use inside `class` ' \
              'or `module`.'
        RESTRICT_ON_SEND = %i[include extend prepend].freeze

        def_node_matcher :include_statement, <<~PATTERN
          (send nil? ${:include :extend :prepend}
            const)
        PATTERN

        def_node_matcher :in_top_level_scope?, <<~PATTERN
          {
            root?                        # either at the top level
            ^[  {kwbegin begin if def}   # or wrapped within one of these
                #in_top_level_scope? ]   # that is in top level scope
          }
        PATTERN

        def on_send(node)
          include_statement(node) do |statement|
            return unless in_top_level_scope?(node)

            add_offense(node, message: format(MSG, statement: statement))
          end
        end
      end
    end
  end
end

Version data entries

22 entries across 22 versions & 1 rubygems

Version Path
rubocop-1.10.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.9.1 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.9.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.8.1 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.8.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.7.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.6.1 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.6.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.5.2 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.5.1 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.5.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.4.2 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.4.1 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.4.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.3.1 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.3.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.2.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.1.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-1.0.0 lib/rubocop/cop/style/mixin_usage.rb
rubocop-0.93.1 lib/rubocop/cop/style/mixin_usage.rb