describe_class.rb

# encoding: utf-8
# frozen_string_literal: true

module RuboCop
  module Cop
    module RSpec
      # Check that the first argument to the top level describe is the tested
      # class or module.
      #
      # @example
      #   # bad
      #   describe 'Do something' do
      #   end
      #
      #   # good
      #   describe TestedClass do
      #   end
      #
      #   describe "A feature example", type: :feature do
      #   end
      class DescribeClass < Cop
        include RuboCop::RSpec::TopLevelDescribe

        REQUEST_PAIR = s(:pair, s(:sym, :type), s(:sym, :request))
        FEATURE_PAIR = s(:pair, s(:sym, :type), s(:sym, :feature))

        MESSAGE = 'The first argument to describe should be the class or ' \
                  'module being tested.'

        def on_top_level_describe(_node, args)
          return if args[0] && args[0].type == :const

          return if args[1..-1].any? do |arg|
            next unless arg.hash_type?
            arg.children.any? do |n|
              [REQUEST_PAIR, FEATURE_PAIR].include?(n)
            end
          end

          add_offense(args[0], :expression, MESSAGE)
        end
      end
    end
  end
end