Resolve cop helper use exceptions

- align with standards in rubocop specs.

.rubocop_manual_todo.yml

@@ -29,31 +29,8 @@ FactoryBot/InlineAssociation:
     - 'spec/factories/uploads.rb'
     - 'spec/factories/wiki_pages.rb'
 
-InternalAffairs/DeprecateCopHelper:
+InternalAffairs/DeprecateCopHelper: # issue to resolve: https://gitlab.com/gitlab-org/gitlab/-/issues/276734
   Exclude:
-    - 'spec/rubocop/cop/scalability/bulk_perform_with_context_spec.rb'
-    - 'spec/rubocop/cop/scalability/idempotent_worker_spec.rb'
-    - 'spec/rubocop/cop/scalability/cron_worker_context_spec.rb'
-    - 'spec/rubocop/cop/scalability/file_uploads_spec.rb'
-    - 'spec/rubocop/cop/destroy_all_spec.rb'
-    - 'spec/rubocop/cop/safe_params_spec.rb'
-    - 'spec/rubocop/cop/include_sidekiq_worker_spec.rb'
-    - 'spec/rubocop/cop/rspec/factories_in_migration_specs_spec.rb'
-    - 'spec/rubocop/cop/rspec/timecop_freeze_spec.rb'
-    - 'spec/rubocop/cop/rspec/any_instance_of_spec.rb'
-    - 'spec/rubocop/cop/rspec/factory_bot/inline_association_spec.rb'
-    - 'spec/rubocop/cop/rspec/top_level_describe_path_spec.rb'
-    - 'spec/rubocop/cop/rspec/be_success_matcher_spec.rb'
-    - 'spec/rubocop/cop/rspec/htt_party_basic_auth_spec.rb'
-    - 'spec/rubocop/cop/rspec/modify_sidekiq_middleware_spec.rb'
-    - 'spec/rubocop/cop/rspec/expect_gitlab_tracking_spec.rb'
-    - 'spec/rubocop/cop/rspec/have_gitlab_http_status_spec.rb'
-    - 'spec/rubocop/cop/rspec/timecop_travel_spec.rb'
-    - 'spec/rubocop/cop/rspec/env_assignment_spec.rb'
-    - 'spec/rubocop/cop/performance/ar_exists_and_present_blank_spec.rb'
-    - 'spec/rubocop/cop/performance/ar_count_each_spec.rb'
-    - 'spec/rubocop/cop/performance/readlines_each_spec.rb'
-    - 'spec/rubocop/cop/project_path_helper_spec.rb'
     - 'spec/rubocop/cop/migration/safer_boolean_column_spec.rb'
     - 'spec/rubocop/cop/migration/remove_index_spec.rb'
     - 'spec/rubocop/cop/migration/add_index_spec.rb'

spec/rubocop/cop/destroy_all_spec.rb

@@ -2,44 +2,41 @@
 
 require 'fast_spec_helper'
 require 'rubocop'
-require 'rubocop/rspec/support'
 require_relative '../../../rubocop/cop/destroy_all'
 
 RSpec.describe RuboCop::Cop::DestroyAll do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   it 'flags the use of destroy_all with a send receiver' do
-    inspect_source('foo.destroy_all # rubocop: disable Cop/DestroyAll')
-
-    expect(cop.offenses.size).to eq(1)
+    expect_offense(<<~CODE)
+      foo.destroy_all # rubocop: disable Cop/DestroyAll
+      ^^^^^^^^^^^^^^^ Use `delete_all` instead of `destroy_all`. [...]
+    CODE
   end
 
   it 'flags the use of destroy_all with a constant receiver' do
-    inspect_source('User.destroy_all # rubocop: disable Cop/DestroyAll')
-
-    expect(cop.offenses.size).to eq(1)
+    expect_offense(<<~CODE)
+      User.destroy_all # rubocop: disable Cop/DestroyAll
+      ^^^^^^^^^^^^^^^^ Use `delete_all` instead of `destroy_all`. [...]
+    CODE
   end
 
   it 'flags the use of destroy_all when passing arguments' do
-    inspect_source('User.destroy_all([])')
-
-    expect(cop.offenses.size).to eq(1)
+    expect_offense(<<~CODE)
+      User.destroy_all([])
+      ^^^^^^^^^^^^^^^^^^^^ Use `delete_all` instead of `destroy_all`. [...]
+    CODE
   end
 
   it 'flags the use of destroy_all with a local variable receiver' do
-    inspect_source(<<~RUBY)
+    expect_offense(<<~CODE)
       users = User.all
       users.destroy_all # rubocop: disable Cop/DestroyAll
-    RUBY
-
-    expect(cop.offenses.size).to eq(1)
+      ^^^^^^^^^^^^^^^^^ Use `delete_all` instead of `destroy_all`. [...]
+    CODE
   end
 
   it 'does not flag the use of delete_all' do
-    inspect_source('foo.delete_all')
-
-    expect(cop.offenses).to be_empty
+    expect_no_offenses('foo.delete_all')
   end
 end

spec/rubocop/cop/include_sidekiq_worker_spec.rb

@@ -3,33 +3,21 @@
 require 'fast_spec_helper'
 
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../rubocop/cop/include_sidekiq_worker'
 
 RSpec.describe RuboCop::Cop::IncludeSidekiqWorker do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when `Sidekiq::Worker` is included' do
-    let(:source) { 'include Sidekiq::Worker' }
-    let(:correct_source) { 'include ApplicationWorker' }
-
-    it 'registers an offense' do
-      inspect_source(source)
-
-      aggregate_failures do
-        expect(cop.offenses.size).to eq(1)
-        expect(cop.offenses.map(&:line)).to eq([1])
-        expect(cop.highlights).to eq(['Sidekiq::Worker'])
-      end
-    end
-
-    it 'autocorrects to the right version' do
-      autocorrected = autocorrect_source(source)
-
-      expect(autocorrected).to eq(correct_source)
+    it 'registers an offense and corrects', :aggregate_failures do
+      expect_offense(<<~CODE)
+        include Sidekiq::Worker
+                ^^^^^^^^^^^^^^^ Include `ApplicationWorker`, not `Sidekiq::Worker`.
+      CODE
+
+      expect_correction(<<~CODE)
+        include ApplicationWorker
+      CODE
     end
   end
 end

spec/rubocop/cop/performance/ar_count_each_spec.rb

@@ -5,8 +5,6 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/performance/ar_count_each.rb'
 
 RSpec.describe RuboCop::Cop::Performance::ARCountEach do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when it is not haml file' do
@@ -32,8 +30,6 @@ RSpec.describe RuboCop::Cop::Performance::ARCountEach do
              ^^^^^^^^^^^^ If @users is AR relation, avoid `@users.count ...; @users.each... `, this will trigger two queries. Use `@users.load.size ...; @users.each... ` instead. If @users is an array, try to use @users.size.
         @users.each { |user| display(user) }
         SOURCE
-
-        expect(cop.offenses.map(&:cop_name)).to contain_exactly('Performance/ARCountEach')
       end
     end
 

spec/rubocop/cop/performance/ar_exists_and_present_blank_spec.rb

@@ -5,8 +5,6 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/performance/ar_exists_and_present_blank.rb'
 
 RSpec.describe RuboCop::Cop::Performance::ARExistsAndPresentBlank do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when it is not haml file' do
@@ -32,8 +30,6 @@ RSpec.describe RuboCop::Cop::Performance::ARExistsAndPresentBlank do
         show @users if @users.present?
                        ^^^^^^^^^^^^^^^ Avoid `@users.present?`, because it will generate database query 'Select TABLE.*' which is expensive. Suggest to use `@users.any?` to replace `@users.present?`
         SOURCE
-
-        expect(cop.offenses.map(&:cop_name)).to contain_exactly('Performance/ARExistsAndPresentBlank')
       end
     end
 
@@ -44,8 +40,6 @@ RSpec.describe RuboCop::Cop::Performance::ARExistsAndPresentBlank do
         show @users if @users.blank?
                        ^^^^^^^^^^^^^ Avoid `@users.blank?`, because it will generate database query 'Select TABLE.*' which is expensive. Suggest to use `@users.empty?` to replace `@users.blank?`
         SOURCE
-
-        expect(cop.offenses.map(&:cop_name)).to contain_exactly('Performance/ARExistsAndPresentBlank')
       end
     end
 
@@ -58,8 +52,6 @@ RSpec.describe RuboCop::Cop::Performance::ARExistsAndPresentBlank do
         show @users if @users.present?
                        ^^^^^^^^^^^^^^^ Avoid `@users.present?`, because it will generate database query 'Select TABLE.*' which is expensive. Suggest to use `@users.any?` to replace `@users.present?`
         SOURCE
-
-        expect(cop.offenses.map(&:cop_name)).to contain_exactly('Performance/ARExistsAndPresentBlank', 'Performance/ARExistsAndPresentBlank')
       end
     end
 

spec/rubocop/cop/performance/readlines_each_spec.rb

@@ -5,19 +5,21 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/performance/readlines_each'
 
 RSpec.describe RuboCop::Cop::Performance::ReadlinesEach do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   let(:message) { 'Avoid `IO.readlines.each`, since it reads contents into memory in full. Use `IO.each_line` or `IO.each` instead.' }
 
   shared_examples_for(:class_read) do |klass|
     context "and it is called as a class method on #{klass}" do
-      # We can't use `expect_offense` here because indentation changes based on `klass`
       it 'flags it as an offense' do
-        inspect_source "#{klass}.readlines(file_path).each { |line| puts line }"
+        leading_readline = "#{klass}.readlines(file_path)."
+        padding = " " * leading_readline.length
+        node = "#{leading_readline}each { |line| puts line }"
 
-        expect(cop.offenses.map(&:cop_name)).to contain_exactly('Performance/ReadlinesEach')
+        expect_offense(<<~CODE, node: node)
+          %{node}
+          #{padding}^^^^ Avoid `IO.readlines.each`, since it reads contents into memory in full. [...]
+        CODE
       end
     end
 
@@ -62,9 +64,14 @@ RSpec.describe RuboCop::Cop::Performance::ReadlinesEach do
     end
 
     it 'autocorrects `readlines.each` to `each_line`' do
-      expect(autocorrect_source('obj.readlines.each { |line| line }')).to(
-        eq('obj.each_line { |line| line }')
-      )
+      expect_offense(<<~CODE)
+        obj.readlines.each { |line| line }
+                      ^^^^ Avoid `IO.readlines.each`, since it reads contents into memory in full. [...]
+      CODE
+
+      expect_correction(<<~CODE)
+        obj.each_line { |line| line }
+      CODE
     end
   end
 

spec/rubocop/cop/project_path_helper_spec.rb

@@ -3,41 +3,30 @@
 require 'fast_spec_helper'
 
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../rubocop/cop/project_path_helper'
 
 RSpec.describe RuboCop::Cop::ProjectPathHelper do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context "when using namespace_project with the project's namespace" do
     let(:source) { 'edit_namespace_project_issue_path(@issue.project.namespace, @issue.project, @issue)' }
     let(:correct_source) { 'edit_project_issue_path(@issue.project, @issue)' }
 
-    it 'registers an offense' do
-      inspect_source(source)
+    it 'registers an offense and corrects', :aggregate_failures do
+      expect_offense(<<~CODE)
+        #{source}
+        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Use short project path helpers without explicitly passing the namespace[...]
+      CODE
 
-      aggregate_failures do
-        expect(cop.offenses.size).to eq(1)
-        expect(cop.offenses.map(&:line)).to eq([1])
-        expect(cop.highlights).to eq(['edit_namespace_project_issue_path'])
-      end
-    end
-
-    it 'autocorrects to the right version' do
-      autocorrected = autocorrect_source(source)
-
-      expect(autocorrected).to eq(correct_source)
+      expect_correction(<<~CODE)
+        #{correct_source}
+      CODE
     end
   end
 
   context 'when using namespace_project with a different namespace' do
     it 'registers no offense' do
-      inspect_source('edit_namespace_project_issue_path(namespace, project)')
-
-      expect(cop.offenses.size).to eq(0)
+      expect_no_offenses('edit_namespace_project_issue_path(namespace, project)')
     end
   end
 end

spec/rubocop/cop/rspec/any_instance_of_spec.rb

@@ -5,14 +5,13 @@ require 'fast_spec_helper'
 require_relative '../../../../rubocop/cop/rspec/any_instance_of'
 
 RSpec.describe RuboCop::Cop::RSpec::AnyInstanceOf do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when calling allow_any_instance_of' do
     let(:source) do
       <<~SRC
         allow_any_instance_of(User).to receive(:invalidate_issue_cache_counts)
+        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Do not use `allow_any_instance_of` [...]
       SRC
     end
 
@@ -24,14 +23,10 @@ RSpec.describe RuboCop::Cop::RSpec::AnyInstanceOf do
       SRC
     end
 
-    it 'registers an offence' do
-      inspect_source(source)
-
-      expect(cop.offenses.size).to eq(1)
-    end
+    it 'registers an offense and corrects', :aggregate_failures do
+      expect_offense(source)
 
-    it 'can autocorrect the source' do
-      expect(autocorrect_source(source)).to eq(corrected_source)
+      expect_correction(corrected_source)
     end
   end
 
@@ -39,6 +34,7 @@ RSpec.describe RuboCop::Cop::RSpec::AnyInstanceOf do
     let(:source) do
       <<~SRC
         expect_any_instance_of(User).to receive(:invalidate_issue_cache_counts).with(args).and_return(double)
+        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Do not use `expect_any_instance_of` [...]
       SRC
     end
 
@@ -50,14 +46,10 @@ RSpec.describe RuboCop::Cop::RSpec::AnyInstanceOf do
       SRC
     end
 
-    it 'registers an offence' do
-      inspect_source(source)
-
-      expect(cop.offenses.size).to eq(1)
-    end
+    it 'registers an offense and corrects', :aggregate_failures do
+      expect_offense(source)
 
-    it 'can autocorrect the source' do
-      expect(autocorrect_source(source)).to eq(corrected_source)
+      expect_correction(corrected_source)
     end
   end
 end

spec/rubocop/cop/rspec/be_success_matcher_spec.rb

@@ -5,34 +5,27 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/rspec/be_success_matcher'
 
 RSpec.describe RuboCop::Cop::RSpec::BeSuccessMatcher do
-  include CopHelper
-
   let(:source_file) { 'spec/foo_spec.rb' }
 
   subject(:cop) { described_class.new }
 
   shared_examples 'cop' do |good:, bad:|
     context "using #{bad} call" do
-      it 'registers an offense' do
-        inspect_source(bad, source_file)
-
-        expect(cop.offenses.size).to eq(1)
-        expect(cop.offenses.map(&:line)).to eq([1])
-        expect(cop.highlights).to eq([bad])
-      end
-
-      it "autocorrects it to `#{good}`" do
-        autocorrected = autocorrect_source(bad, source_file)
-
-        expect(autocorrected).to eql(good)
+      it 'registers an offense and corrects', :aggregate_failures do
+        expect_offense(<<~CODE, node: bad)
+          %{node}
+          ^{node} Do not use deprecated `success?` method, use `successful?` instead.
+        CODE
+
+        expect_correction(<<~CODE)
+          #{good}
+        CODE
       end
     end
 
     context "using #{good} call" do
       it 'does not register an offense' do
-        inspect_source(good)
-
-        expect(cop.offenses).to be_empty
+        expect_no_offenses(good)
       end
     end
   end

spec/rubocop/cop/rspec/env_assignment_spec.rb

@@ -3,13 +3,9 @@
 require 'fast_spec_helper'
 
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../../rubocop/cop/rspec/env_assignment'
 
 RSpec.describe RuboCop::Cop::RSpec::EnvAssignment do
-  include CopHelper
-
   offense_call_single_quotes_key = %(ENV['FOO'] = 'bar').freeze
   offense_call_double_quotes_key = %(ENV["FOO"] = 'bar').freeze
 
@@ -17,31 +13,24 @@ RSpec.describe RuboCop::Cop::RSpec::EnvAssignment do
 
   subject(:cop) { described_class.new }
 
-  shared_examples 'an offensive ENV#[]= call' do |content|
-    it "registers an offense for `#{content}`" do
-      inspect_source(content, source_file)
-
-      expect(cop.offenses.size).to eq(1)
-      expect(cop.offenses.map(&:line)).to eq([1])
-      expect(cop.highlights).to eq([content])
-    end
-  end
-
-  shared_examples 'an autocorrected ENV#[]= call' do |content, autocorrected_content|
-    it "registers an offense for `#{content}` and autocorrects it to `#{autocorrected_content}`" do
-      autocorrected = autocorrect_source(content, source_file)
+  shared_examples 'an offensive and correction ENV#[]= call' do |content, autocorrected_content|
+    it "registers an offense for `#{content}` and corrects", :aggregate_failures do
+      expect_offense(<<~CODE)
+        #{content}
+        ^^^^^^^^^^^^^^^^^^ Don't assign to ENV, use `stub_env` instead.
+      CODE
 
-      expect(autocorrected).to eql(autocorrected_content)
+      expect_correction(<<~CODE)
+        #{autocorrected_content}
+      CODE
     end
   end
 
   context 'with a key using single quotes' do
-    it_behaves_like 'an offensive ENV#[]= call', offense_call_single_quotes_key
-    it_behaves_like 'an autocorrected ENV#[]= call', offense_call_single_quotes_key, %(stub_env('FOO', 'bar'))
+    it_behaves_like 'an offensive and correction ENV#[]= call', offense_call_single_quotes_key, %(stub_env('FOO', 'bar'))
   end
 
   context 'with a key using double quotes' do
-    it_behaves_like 'an offensive ENV#[]= call', offense_call_double_quotes_key
-    it_behaves_like 'an autocorrected ENV#[]= call', offense_call_double_quotes_key, %(stub_env("FOO", 'bar'))
+    it_behaves_like 'an offensive and correction ENV#[]= call', offense_call_double_quotes_key, %(stub_env("FOO", 'bar'))
   end
 end

spec/rubocop/cop/rspec/expect_gitlab_tracking_spec.rb

@@ -2,13 +2,9 @@
 
 require 'fast_spec_helper'
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../../rubocop/cop/rspec/expect_gitlab_tracking'
 
 RSpec.describe RuboCop::Cop::RSpec::ExpectGitlabTracking do
-  include CopHelper
-
   let(:source_file) { 'spec/foo_spec.rb' }
 
   subject(:cop) { described_class.new }
@@ -36,29 +32,18 @@ RSpec.describe RuboCop::Cop::RSpec::ExpectGitlabTracking do
   good_samples.each do |good|
     context "good: #{good}" do
       it 'does not register an offense' do
-        inspect_source(good)
-
-        expect(cop.offenses).to be_empty
+        expect_no_offenses(good)
       end
     end
   end
 
   bad_samples.each do |bad|
     context "bad: #{bad}" do
-      it 'registers an offense', :aggregate_failures do
-        inspect_source(bad, source_file)
-
-        expect(cop.offenses.size).to eq(1)
-        expect(cop.offenses.map(&:line)).to eq([1])
-        expect(cop.highlights).to eq([bad])
-
-        msg = cop.offenses.first.message
-
-        expect(msg).to match(
-          /Do not expect directly on `Gitlab::Tracking#event`/
-        )
-        expect(msg).to match(/add the `snowplow` annotation/)
-        expect(msg).to match(/use `expect_snowplow_event` instead/)
+      it 'registers an offense' do
+        expect_offense(<<~CODE, node: bad)
+          %{node}
+          ^{node} Do not expect directly on `Gitlab::Tracking#event`[...]
+        CODE
       end
     end
   end

spec/rubocop/cop/rspec/factories_in_migration_specs_spec.rb

@@ -3,13 +3,9 @@
 require 'fast_spec_helper'
 
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../../rubocop/cop/rspec/factories_in_migration_specs'
 
 RSpec.describe RuboCop::Cop::RSpec::FactoriesInMigrationSpecs do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   shared_examples 'an offensive factory call' do |namespace|

spec/rubocop/cop/rspec/factory_bot/inline_association_spec.rb

@@ -7,8 +7,6 @@ require 'rubocop'
 require_relative '../../../../../rubocop/cop/rspec/factory_bot/inline_association'
 
 RSpec.describe RuboCop::Cop::RSpec::FactoryBot::InlineAssociation do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   shared_examples 'offense' do |code_snippet, autocorrected|
@@ -17,7 +15,6 @@ RSpec.describe RuboCop::Cop::RSpec::FactoryBot::InlineAssociation do
     let(:offense_marker) { '^' * code_snippet.size }
     let(:offense_msg) { msg(type) }
     let(:offense) { "#{offense_marker} #{offense_msg}" }
-    let(:pristine_source) { source.sub(offense, '') }
     let(:source) do
       <<~RUBY
         FactoryBot.define do
@@ -29,15 +26,20 @@ RSpec.describe RuboCop::Cop::RSpec::FactoryBot::InlineAssociation do
       RUBY
     end
 
-    it 'registers an offense' do
-      expect_offense(source)
+    let(:corrected_source) do
+      <<~RUBY
+        FactoryBot.define do
+          factory :project do
+            attribute { #{autocorrected} }
+          end
+        end
+      RUBY
     end
 
-    it 'autocorrects the source' do
-      corrected = autocorrect_source(pristine_source)
+    it 'registers an offense and corrects', :aggregate_failures do
+      expect_offense(source)
 
-      expect(corrected).not_to include(code_snippet)
-      expect(corrected).to include(autocorrected)
+      expect_correction(corrected_source)
     end
   end
 

spec/rubocop/cop/rspec/have_gitlab_http_status_spec.rb

@@ -4,50 +4,42 @@ require 'fast_spec_helper'
 
 require 'rspec-parameterized'
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../../rubocop/cop/rspec/have_gitlab_http_status'
 
 RSpec.describe RuboCop::Cop::RSpec::HaveGitlabHttpStatus do
-  include CopHelper
-
   using RSpec::Parameterized::TableSyntax
 
   let(:source_file) { 'spec/foo_spec.rb' }
 
   subject(:cop) { described_class.new }
 
-  shared_examples 'offense' do |code|
-    it 'registers an offense' do
-      inspect_source(code, source_file)
+  shared_examples 'offense' do |bad, good|
+    it 'registers an offense', :aggregate_failures do
+      expect_offense(<<~CODE, node: bad)
+        %{node}
+        ^{node} [...]
+      CODE
 
-      expect(cop.offenses.size).to eq(1)
-      expect(cop.offenses.map(&:line)).to eq([1])
-      expect(cop.highlights).to eq([code])
+      expect_correction(<<~CODE)
+        #{good}
+      CODE
     end
   end
 
   shared_examples 'no offense' do |code|
     it 'does not register an offense' do
-      inspect_source(code)
-
-      expect(cop.offenses).to be_empty
+      expect_no_offenses(code)
     end
   end
 
-  shared_examples 'autocorrect' do |bad, good|
-    it 'autocorrects' do
-      autocorrected = autocorrect_source(bad, source_file)
-
-      expect(autocorrected).to eql(good)
-    end
-  end
-
-  shared_examples 'no autocorrect' do |code|
+  shared_examples 'offense with no autocorrect' do |code|
     it 'does not autocorrect' do
-      autocorrected = autocorrect_source(code, source_file)
+      expect_offense(<<~CODE, node: code)
+        %{node}
+        ^{node} [...]
+      CODE
 
-      expect(autocorrected).to eql(code)
+      expect_no_corrections
     end
   end
 
@@ -64,10 +56,8 @@ RSpec.describe RuboCop::Cop::RSpec::HaveGitlabHttpStatus do
     end
 
     with_them do
-      include_examples 'offense', params[:bad]
+      include_examples 'offense', params[:bad], params[:good]
       include_examples 'no offense', params[:good]
-      include_examples 'autocorrect', params[:bad], params[:good]
-      include_examples 'no autocorrect', params[:good]
     end
   end
 
@@ -77,10 +67,8 @@ RSpec.describe RuboCop::Cop::RSpec::HaveGitlabHttpStatus do
     end
 
     with_them do
-      include_examples 'offense', params[:bad]
-      include_examples 'offense', params[:good]
-      include_examples 'autocorrect', params[:bad], params[:good]
-      include_examples 'no autocorrect', params[:good]
+      include_examples 'offense', params[:bad], params[:good]
+      include_examples 'offense with no autocorrect', params[:good]
     end
   end
 
@@ -114,7 +102,6 @@ RSpec.describe RuboCop::Cop::RSpec::HaveGitlabHttpStatus do
 
     with_them do
       include_examples 'no offense', params[:code]
-      include_examples 'no autocorrect', params[:code]
     end
   end
 end

spec/rubocop/cop/rspec/htt_party_basic_auth_spec.rb

@@ -5,12 +5,10 @@ require 'fast_spec_helper'
 require_relative '../../../../rubocop/cop/rspec/httparty_basic_auth'
 
 RSpec.describe RuboCop::Cop::RSpec::HTTPartyBasicAuth do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when passing `basic_auth: { user: ... }`' do
-    it 'registers an offence' do
+    it 'registers an offense and corrects', :aggregate_failures do
       expect_offense(<<~SOURCE, 'spec/foo.rb')
         HTTParty.put(
           url,
@@ -19,17 +17,19 @@ RSpec.describe RuboCop::Cop::RSpec::HTTPartyBasicAuth do
           body: body
         )
       SOURCE
-    end
 
-    it 'can autocorrect the source' do
-      bad  = 'HTTParty.put(url, basic_auth: { user: user, password: token })'
-      good = 'HTTParty.put(url, basic_auth: { username: user, password: token })'
-      expect(autocorrect_source(bad)).to eq(good)
+      expect_correction(<<~SOURCE)
+        HTTParty.put(
+          url,
+          basic_auth: { username: user, password: token },
+          body: body
+        )
+      SOURCE
     end
   end
 
   context 'when passing `basic_auth: { username: ... }`' do
-    it 'does not register an offence' do
+    it 'does not register an offense' do
       expect_no_offenses(<<~SOURCE, 'spec/frontend/fixtures/foo.rb')
         HTTParty.put(
           url,

spec/rubocop/cop/rspec/modify_sidekiq_middleware_spec.rb

@@ -5,33 +5,20 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/rspec/modify_sidekiq_middleware'
 
 RSpec.describe RuboCop::Cop::RSpec::ModifySidekiqMiddleware do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
-  let(:source) do
-    <<~SRC
+  it 'registers an offense and corrects', :aggregate_failures do
+    expect_offense(<<~CODE)
       Sidekiq::Testing.server_middleware do |chain|
+      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Don't modify global sidekiq middleware, [...]
         chain.add(MyCustomMiddleware)
       end
-    SRC
-  end
+    CODE
 
-  let(:corrected) do
-    <<~SRC
+    expect_correction(<<~CODE)
       with_sidekiq_server_middleware do |chain|
         chain.add(MyCustomMiddleware)
       end
-    SRC
-  end
-
-  it 'registers an offence' do
-    inspect_source(source)
-
-    expect(cop.offenses.size).to eq(1)
-  end
-
-  it 'can autocorrect the source' do
-    expect(autocorrect_source(source)).to eq(corrected)
+    CODE
   end
 end

spec/rubocop/cop/rspec/timecop_freeze_spec.rb

@@ -3,50 +3,29 @@
 require 'fast_spec_helper'
 
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../../rubocop/cop/rspec/timecop_freeze'
 
 RSpec.describe RuboCop::Cop::RSpec::TimecopFreeze do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when calling Timecop.freeze' do
-    let(:source) do
-      <<~SRC
+    it 'registers an offense and corrects', :aggregate_failures do
+      expect_offense(<<~CODE)
         Timecop.freeze(Time.current) { example.run }
-      SRC
-    end
+        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Do not use `Timecop.freeze`, use `freeze_time` instead. [...]
+      CODE
 
-    let(:corrected_source) do
-      <<~SRC
+      expect_correction(<<~CODE)
         freeze_time(Time.current) { example.run }
-      SRC
-    end
-
-    it 'registers an offence' do
-      inspect_source(source)
-
-      expect(cop.offenses.size).to eq(1)
-    end
-
-    it 'can autocorrect the source' do
-      expect(autocorrect_source(source)).to eq(corrected_source)
+      CODE
     end
   end
 
   context 'when calling a different method on Timecop' do
-    let(:source) do
-      <<~SRC
+    it 'does not register an offense' do
+      expect_no_offenses(<<~CODE)
         Timecop.travel(Time.current)
-      SRC
-    end
-
-    it 'does not register an offence' do
-      inspect_source(source)
-
-      expect(cop.offenses).to be_empty
+      CODE
     end
   end
 end

spec/rubocop/cop/rspec/timecop_travel_spec.rb

@@ -3,50 +3,29 @@
 require 'fast_spec_helper'
 
 require 'rubocop'
-require 'rubocop/rspec/support'
-
 require_relative '../../../../rubocop/cop/rspec/timecop_travel'
 
 RSpec.describe RuboCop::Cop::RSpec::TimecopTravel do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when calling Timecop.travel' do
-    let(:source) do
-      <<~SRC
+    it 'registers an offense and corrects', :aggregate_failures do
+      expect_offense(<<~CODE)
         Timecop.travel(1.day.ago) { create(:issue) }
-      SRC
-    end
+        ^^^^^^^^^^^^^^^^^^^^^^^^^ Do not use `Timecop.travel`, use `travel_to` instead. [...]
+      CODE
 
-    let(:corrected_source) do
-      <<~SRC
+      expect_correction(<<~CODE)
         travel_to(1.day.ago) { create(:issue) }
-      SRC
-    end
-
-    it 'registers an offence' do
-      inspect_source(source)
-
-      expect(cop.offenses.size).to eq(1)
-    end
-
-    it 'can autocorrect the source' do
-      expect(autocorrect_source(source)).to eq(corrected_source)
+      CODE
     end
   end
 
   context 'when calling a different method on Timecop' do
-    let(:source) do
-      <<~SRC
+    it 'does not register an offense' do
+      expect_no_offenses(<<~CODE)
         Timecop.freeze { create(:issue) }
-      SRC
-    end
-
-    it 'does not register an offence' do
-      inspect_source(source)
-
-      expect(cop.offenses).to be_empty
+      CODE
     end
   end
 end

spec/rubocop/cop/rspec/top_level_describe_path_spec.rb

@@ -5,8 +5,6 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/rspec/top_level_describe_path'
 
 RSpec.describe RuboCop::Cop::RSpec::TopLevelDescribePath do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   context 'when the file ends in _spec.rb' do

spec/rubocop/cop/safe_params_spec.rb

@@ -2,12 +2,9 @@
 
 require 'fast_spec_helper'
 require 'rubocop'
-require 'rubocop/rspec/support'
 require_relative '../../../rubocop/cop/safe_params'
 
 RSpec.describe RuboCop::Cop::SafeParams do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   it 'flags the params as an argument of url_for' do

spec/rubocop/cop/scalability/bulk_perform_with_context_spec.rb

@@ -5,54 +5,44 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/scalability/bulk_perform_with_context'
 
 RSpec.describe RuboCop::Cop::Scalability::BulkPerformWithContext do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   it "adds an offense when calling bulk_perform_async" do
-    inspect_source(<<~CODE)
+    expect_offense(<<~CODE)
       Worker.bulk_perform_async(args)
+      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefer using `Worker.bulk_perform_async_with_contexts` [...]
     CODE
-
-    expect(cop.offenses.size).to eq(1)
   end
 
   it "adds an offense when calling bulk_perform_in" do
-    inspect_source(<<~CODE)
+    expect_offense(<<~CODE)
       diffs.each_batch(of: BATCH_SIZE) do |relation, index|
         ids = relation.pluck_primary_key.map { |id| [id] }
         DeleteDiffFilesWorker.bulk_perform_in(index * 5.minutes, ids)
+        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefer using `Worker.bulk_perform_async_with_contexts` [...]
       end
     CODE
-
-    expect(cop.offenses.size).to eq(1)
   end
 
   it "does not add an offense for migrations" do
     allow(cop).to receive(:in_migration?).and_return(true)
 
-    inspect_source(<<~CODE)
+    expect_no_offenses(<<~CODE)
       Worker.bulk_perform_in(args)
     CODE
-
-    expect(cop.offenses.size).to eq(0)
   end
 
   it "does not add an offence for specs" do
     allow(cop).to receive(:in_spec?).and_return(true)
 
-    inspect_source(<<~CODE)
+    expect_no_offenses(<<~CODE)
       Worker.bulk_perform_in(args)
     CODE
-
-    expect(cop.offenses.size).to eq(0)
   end
 
   it "does not add an offense for scheduling BackgroundMigrations" do
-    inspect_source(<<~CODE)
+    expect_no_offenses(<<~CODE)
       BackgroundMigrationWorker.bulk_perform_in(args)
     CODE
-
-    expect(cop.offenses.size).to eq(0)
   end
 end

spec/rubocop/cop/scalability/cron_worker_context_spec.rb

@@ -5,18 +5,15 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/scalability/cron_worker_context'
 
 RSpec.describe RuboCop::Cop::Scalability::CronWorkerContext do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   it 'adds an offense when including CronjobQueue' do
-    inspect_source(<<~CODE)
+    expect_offense(<<~CODE)
       class SomeWorker
         include CronjobQueue
+                ^^^^^^^^^^^^ Manually define an ApplicationContext for cronjob-workers.[...]
       end
     CODE
-
-    expect(cop.offenses.size).to eq(1)
   end
 
   it 'does not add offenses for other workers' do

spec/rubocop/cop/scalability/file_uploads_spec.rb

@@ -5,8 +5,6 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/scalability/file_uploads'
 
 RSpec.describe RuboCop::Cop::Scalability::FileUploads do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   let(:message) { 'Do not upload files without workhorse acceleration. Please refer to https://docs.gitlab.com/ee/development/uploads.html' }

spec/rubocop/cop/scalability/idempotent_worker_spec.rb

@@ -5,8 +5,6 @@ require 'rubocop'
 require_relative '../../../../rubocop/cop/scalability/idempotent_worker'
 
 RSpec.describe RuboCop::Cop::Scalability::IdempotentWorker do
-  include CopHelper
-
   subject(:cop) { described_class.new }
 
   before do
@@ -16,21 +14,18 @@ RSpec.describe RuboCop::Cop::Scalability::IdempotentWorker do
   end
 
   it 'adds an offense when not defining idempotent method' do
-    inspect_source(<<~CODE)
+    expect_offense(<<~CODE)
       class SomeWorker
+      ^^^^^^^^^^^^^^^^ Avoid adding not idempotent workers.[...]
       end
     CODE
-
-    expect(cop.offenses.size).to eq(1)
   end
 
   it 'adds an offense when not defining idempotent method' do
-    inspect_source(<<~CODE)
+    expect_no_offenses(<<~CODE)
       class SomeWorker
         idempotent!
       end
     CODE
-
-    expect(cop.offenses.size).to be_zero
   end
 end