Make the Rubocop::Minitest::Test suite re-usable by gem consumers

Author: DougEdey

README.md

@@ -95,6 +95,74 @@ Here are the Markdown snippets for the two badges:
 [![Minitest Style Guide](https://img.shields.io/badge/code_style-community-brightgreen.svg)](https://minitest.rubystyle.guide)
 ```
 
+## Using this Gem for testing custom cops
+
+You can use this gem to test your own cops, by using the `Rubocop::Minitest::Test` test class, you'll get `assert_offense`, `assert_correction`, and `assert_no_offense` helpers
+
+```ruby
+
+require "rubocop/minitest/support"
+require "custom_cops/my_cop"
+
+module CustomCops
+  class MyCopTest < Rubocop::Minitest::Test
+    test "registers offense" do
+      assert_offense(<<~RUBY)
+        class FooTest < Minitest::Test
+          def test_do_something
+            assert_equal(nil, somestuff)
+            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefer using `assert_nil(somestuff)`.
+          end
+        end
+      RUBY
+    end
+
+    test "assert offense and correction"
+      assert_offense(<<~RUBY)
+        class FooTest < Minitest::Test
+          def test_do_something
+            assert_equal(nil, somestuff)
+            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefer using `assert_nil(somestuff)`.
+          end
+        end
+      RUBY
+
+      assert_correction(<<~RUBY)
+        class FooTest < Minitest::Test
+          def test_do_something
+            assert_nil(somestuff)
+          end
+        end
+      RUBY
+    end
+
+    test "assert offense and no corrections"
+      assert_offense(<<~RUBY)
+        class FooTest < Minitest::Test
+          def test_do_something
+            assert_equal(nil, somestuff)
+            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefer using `assert_nil(somestuff)`.
+          end
+        end
+      RUBY
+
+      assert_no_corrections
+    end
+
+    test "assert no offense"
+      assert_no_offenses(<<~RUBY)
+        class FooTest < Minitest::Test
+          def test_do_something
+            assert_nil(somestuff)
+          end
+        end
+      RUBY
+    end
+  end
+end
+
+```
+
 ## Contributing
 
 Checkout the [contribution guidelines](CONTRIBUTING.md).

changelog/new_make_test_class_reusable_by_consumers.md

@@ -0,0 +1 @@
+* Allow `Rubocop::Minitest::Test` to be used by consumers of the gem to test custom cops.