rubocop-rspec-extra 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6d37e0a9b8e12b308c8f45612176fd83edd6a6ce1852746dc0140efba3efb6b
-  data.tar.gz: ef9b88f0c670940a7f79b8c4ae6e73f1f8b492b630cceb540dab1c6a85ec003e
+  metadata.gz: d885353b04e17a9ba6e002a3aeaa1d58726f13d9134edfdbfb5adac37d72d312
+  data.tar.gz: 0720cb32f2ce81e26e687870cccd9fc6174e10340f077f50bdbc89661278ae45
 SHA512:
-  metadata.gz: 6ba9025e60e671873a082672d0677fc2eacd07c60f1d1fca1d9ac6068fdd9d1894faf6336e37d63f86bfbc9bcb482477bd246176e23967cd9f36df316107a323
-  data.tar.gz: e6b5eda765dd616f7ba4d9e24c93462b0440986b00098f11c21993c45e93e8391723e6301db74f2a53beae6745caf7e51cee045f4696a03b8f44d1808669aa37
+  metadata.gz: cfd41a33039afbd015fb9ee731ddb16055ecc42e29f844dfba12b307595dd9f06ab1f7d317e8e204ed39932d23b8a679eb3458d0da97e55274909d9e2b3407b8
+  data.tar.gz: e178ee6def16d08d667df04bd4fd4514fdc69d110d00dc825f213e5f797deacd8b6078f8b125d7a441643eef32ee5dbfd5a803f6bbc6735ae3d548fa98172751

data/.rubocop.yml

@@ -1,7 +1,7 @@
 inherit_from: .rubocop_todo.yml
 
-require:
-  - rubocop/cop/internal_affairs
+plugins:
+  - rubocop-internal_affairs
   - rubocop-performance
   - rubocop-rake
   - rubocop-rspec
@@ -9,7 +9,7 @@ require:
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 2.7
   SuggestExtensions: false
 
 Layout/LineLength:

data/CHANGELOG.md

@@ -1,5 +1,22 @@
-## Unreleased
+# Changelog
 
-## 0.1.0 - 2023-04-18
+## Master (Unreleased)
+
+## 0.3.0 (2025-03-19)
+
+- Pluginfy RuboCop RSpec Extra. ([@ydah])
+- Add `RSpec/Extra/FlatExamples` cop. ([@ydah])
+
+## 0.2.0 (2024-03-01)
+
+- Fix an error for `RSpec/Extra/RestrictBlockTag`. ([@ydah])
+- Fix an error for `RSpec/Extra/RestrictBlockTagValue`. ([@ydah])
+- Drop Ruby 2.6 support. ([@ydah])
+
+## 0.1.0 (2023-04-18)
 
 - Initial release
+
+<!-- Contributors (alphabetically) -->
+
+[@ydah]: https://github.com/ydah

data/Gemfile

@@ -9,5 +9,5 @@ gem "rake"
 gem "rspec", "~> 3.11"
 gem "rubocop-performance", "~> 1.7"
 gem "rubocop-rake", "~> 0.6"
-gem "rubocop-rspec", "~> 2.18"
+gem "rubocop-rspec", "~> 3.0"
 gem "yard"

data/README.md

@@ -1,6 +1,6 @@
 # Rubocop::Rspec::Extra
 
-![GitHub top language](https://img.shields.io/github/languages/top/ydah/rubocop-rspec-extra) ![GitHub](https://img.shields.io/github/license/ydah/rubocop-rspec-extra) ![Ruby Style Guide](https://img.shields.io/badge/code_style-rubocop-brightgreen.svg) [![CI](https://github.com/ydah/rubocop-rspec-extra/actions/workflows/ci.yml/badge.svg)](https://github.com/ydah/rubocop-rspec-extra/actions/workflows/ci.yml) [![Maintainability](https://api.codeclimate.com/v1/badges/6b1f27edd867a4b64661/maintainability)](https://codeclimate.com/github/ydah/rubocop-rspec-extra/maintainability)
+![GitHub top language](https://img.shields.io/github/languages/top/ydah/rubocop-rspec-extra) ![GitHub](https://img.shields.io/github/license/ydah/rubocop-rspec-extra) [![Gem Version](https://badge.fury.io/rb/rubocop-rspec-extra.svg)](https://badge.fury.io/rb/rubocop-rspec-extra) ![Ruby Style Guide](https://img.shields.io/badge/code_style-rubocop-brightgreen.svg) [![CI](https://github.com/ydah/rubocop-rspec-extra/actions/workflows/ci.yml/badge.svg)](https://github.com/ydah/rubocop-rspec-extra/actions/workflows/ci.yml) [![Maintainability](https://api.codeclimate.com/v1/badges/6b1f27edd867a4b64661/maintainability)](https://codeclimate.com/github/ydah/rubocop-rspec-extra/maintainability)
 
 A [RuboCop](https://github.com/rubocop/rubocop) extension focused on enforcing RSpec. A place where no one is officially employed, but where useful cops can gather.
 
@@ -28,13 +28,13 @@ ways to do this:
 Put this into your `.rubocop.yml`.
 
 ```yaml
-require: rubocop-rspec-extra
+plugins: rubocop-rspec-extra
 ```
 
 Alternatively, use the following array notation when specifying multiple extensions.
 
 ```yaml
-require:
+plugins:
   - rubocop-rspec
   - rubocop-rspec-extra
 ```
@@ -42,17 +42,20 @@ require:
 Now you can run `rubocop` and it will automatically load the RuboCop RSpec Extra
 cops together with the standard cops.
 
+> [!NOTE]
+> The plugin system is supported in RuboCop 1.72+. In earlier versions, use `require` instead of `plugins`.
+
 ### Command line
 
 ```bash
-rubocop --require rubocop-rspec-extra
+rubocop --plugins rubocop-rspec-extra
 ```
 
 ### Rake task
 
 ```ruby
 RuboCop::RakeTask.new do |task|
-  task.requires << 'rubocop-rspec-extra'
+  task.plugins << 'rubocop-rspec-extra'
 end
 ```
 
@@ -62,7 +65,7 @@ All cops are located under
 [`lib/rubocop/cop/rspec/extra`](lib/rubocop/cop/rspec/extra), and contain
 examples/documentation.
 
-In your `.rubocop.yml`, you may treat the Committee cops just like any other
+In your `.rubocop.yml`, you may treat the RSpec extra cops just like any other
 cop. For example:
 
 ```yaml
@@ -77,5 +80,5 @@ Checkout the [contribution guidelines](.github/CONTRIBUTING.md).
 
 ## License
 
-`rubocop-committee` is MIT licensed. [See the accompanying file](MIT-LICENSE.md) for
+`rubocop-rspec-extra` is MIT licensed. [See the accompanying file](MIT-LICENSE.md) for
 the full text.

data/config/default.yml

@@ -5,17 +5,22 @@ RSpec/Extra:
 RSpec/Extra/BeEmpty:
   Description: Prefer using `be_empty` when checking for an empty array.
   Enabled: pending
-  VersionAdded: '<<next>>'
+  VersionAdded: '0.1'
   Reference: https://www.rubydoc.info/gems/rubocop-rspec-extra/RuboCop/Cop/RSpec/Extra/BeEmpty
 
+RSpec/Extra/FlatExamples:
+  Description: 'Restrict unnecessary nesting by example groups.'
+  Enabled: false
+  VersionAdded: '0.3'
+
 RSpec/Extra/RestrictBlockTag:
   Description: 'Restrict to only allowed block tags.'
   Enabled: false
-  VersionAdded: '<<next>>'
+  VersionAdded: '0.1'
   AllowTags: []
 
 RSpec/Extra/RestrictBlockTagValue:
   Description: 'Restrict to only allowed block tag value.'
   Enabled: pending
-  VersionAdded: '<<next>>'
+  VersionAdded: '0.1'
   AllowTagValues: {}

data/docs/antora.yml

@@ -1,5 +1,5 @@
 name: rubocop-rspec-extra
 title: RuboCop RSpec Extra
-version: ~
+version: '0.2'
 nav:
   - modules/ROOT/nav.adoc

data/docs/modules/ROOT/pages/cops.adoc

@@ -2,8 +2,9 @@
 
 === Department xref:cops_rspec_extra.adoc[RSpec/Extra]
 
-* xref:cops_rspec_extra.adoc#rspecextra/beempty[RSpec/Extra/BeEmpty]
-* xref:cops_rspec_extra.adoc#rspecextra/restrictblocktag[RSpec/Extra/RestrictBlockTag]
-* xref:cops_rspec_extra.adoc#rspecextra/restrictblocktagvalue[RSpec/Extra/RestrictBlockTagValue]
+* xref:cops_rspec_extra.adoc#rspecextrabeempty[RSpec/Extra/BeEmpty]
+* xref:cops_rspec_extra.adoc#rspecextraflatexamples[RSpec/Extra/FlatExamples]
+* xref:cops_rspec_extra.adoc#rspecextrarestrictblocktag[RSpec/Extra/RestrictBlockTag]
+* xref:cops_rspec_extra.adoc#rspecextrarestrictblocktagvalue[RSpec/Extra/RestrictBlockTagValue]
 
 // END_COP_LIST

data/docs/modules/ROOT/pages/cops_rspec_extra.adoc

@@ -1,19 +1,27 @@
+////
+  Do NOT edit this file by hand directly, as it is automatically generated.
+
+  Please make any necessary changes to the cop documentation within the source files themselves.
+////
+
 = RSpec/Extra
 
+[#rspecextrabeempty]
 == RSpec/Extra/BeEmpty
 
 |===
 | Enabled by default | Safe | Supports autocorrection | Version Added | Version Changed
 
-| Pending
-| Yes
+| Enabled
 | Yes
-| <<next>>
+| Always
+| -
 | -
 |===
 
 Prefer using `be_empty` when checking for an empty array.
 
+[#examples-rspecextrabeempty]
 === Examples
 
 [source,ruby]
@@ -32,26 +40,56 @@ expect(array).to match_array([])
 expect(array).to be_empty
 ----
 
-=== References
+[#rspecextraflatexamples]
+== RSpec/Extra/FlatExamples
 
-* https://www.rubydoc.info/gems/rubocop-rspec-extra/RuboCop/Cop/RSpec/Extra/BeEmpty
+|===
+| Enabled by default | Safe | Supports autocorrection | Version Added | Version Changed
 
+| Enabled
+| Yes
+| No
+| -
+| -
+|===
+
+Restrict unnecessary nesting by example groups.
+
+[#examples-rspecextraflatexamples]
+=== Examples
+
+[source,ruby]
+----
+# bad
+context 'when condition' do
+  it 'tests something' do
+  end
+end
+
+# good
+it 'tests something when condition' do
+end
+----
+
+[#rspecextrarestrictblocktag]
 == RSpec/Extra/RestrictBlockTag
 
 |===
 | Enabled by default | Safe | Supports autocorrection | Version Added | Version Changed
 
-| Disabled
+| Enabled
 | Yes
 | No
-| <<next>>
+| -
 | -
 |===
 
 Restrict to only allowed block tags.
 
+[#examples-rspecextrarestrictblocktag]
 === Examples
 
+[#allowtags_-__foo__-_bar__-rspecextrarestrictblocktag]
 ==== AllowTags: ['foo', 'bar']
 
 [source,ruby]
@@ -77,32 +115,25 @@ RSpec.describe 'Something' do
 end
 ----
 
-=== Configurable attributes
-
-|===
-| Name | Default value | Configurable values
-
-| AllowTags
-| `[]`
-| Array
-|===
-
+[#rspecextrarestrictblocktagvalue]
 == RSpec/Extra/RestrictBlockTagValue
 
 |===
 | Enabled by default | Safe | Supports autocorrection | Version Added | Version Changed
 
-| Pending
+| Enabled
 | Yes
 | No
-| <<next>>
+| -
 | -
 |===
 
 Restrict to only allowed block tag value.
 
+[#examples-rspecextrarestrictblocktagvalue]
 === Examples
 
+[#allowtagvalues_-_-foo_-_baz_-_-rspecextrarestrictblocktagvalue]
 ==== AllowTagValues: { foo: 'baz' }
 
 [source,ruby]
@@ -115,13 +146,3 @@ end
 RSpec.describe 'Something', foo: :baz do
 end
 ----
-
-=== Configurable attributes
-
-|===
-| Name | Default value | Configurable values
-
-| AllowTagValues
-| `{}`
-| 
-|===

data/docs/modules/ROOT/pages/usage.adoc

@@ -8,13 +8,13 @@ There are some ways to do this:
 Put this into your `.rubocop.yml`:
 
 ----
-require: rubocop-rspec-extra
+plugins: rubocop-rspec-extra
 ----
 
 or, if you are using several extensions:
 
 ----
-require:
+plugins:
   - rubocop-rspec
   - rubocop-rspec-extra
 ----
@@ -24,7 +24,7 @@ cops together with the standard cops.
 
 [source,bash]
 ----
-$ rubocop --require rubocop-rspec-extra
+$ rubocop --plugins rubocop-rspec-extra
 ----
 
 == Rake task
@@ -32,6 +32,8 @@ $ rubocop --require rubocop-rspec-extra
 [source,ruby]
 ----
 RuboCop::RakeTask.new do |task|
-  task.requires << 'rubocop-rspec-extra'
+  task.plugins << 'rubocop-rspec-extra'
 end
 ----
+
+NOTE: The plugin system is supported in RuboCop 1.72+. In earlier versions, use `require` instead of `plugins`.

data/lib/rubocop/cop/rspec/extra/be_empty.rb

@@ -57,7 +57,7 @@ module RuboCop
             )
           PATTERN
 
-          def on_send(node)
+          def on_send(node) # rubocop:disable InternalAffairs/OnSendWithoutOnCSend
             expect_array_empty_true?(node.parent) do |actual, expect|
               register_offense(actual, expect)
             end

data/lib/rubocop/cop/rspec/extra/flat_examples.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module RSpec
+      module Extra
+        # Restrict unnecessary nesting by example groups.
+        #
+        # @example
+        #   # bad
+        #   context 'when condition' do
+        #     it 'tests something' do
+        #     end
+        #   end
+        #
+        #   # good
+        #   it 'tests something when condition' do
+        #   end
+        #
+        class FlatExamples < Base
+          MSG = "Unnecessary nesting by example groups detected."
+
+          # @!method redundant?(node)
+          def_node_matcher :redundant?, <<~PATTERN
+            (block (send #rspec? #ExampleGroups.regular ...) _ (block (send _ #Examples.regular ...) ...))
+          PATTERN
+
+          def on_block(node) # rubocop:disable InternalAffairs/NumblockHandler
+            return unless redundant?(node)
+
+            add_offense(node)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/rspec/extra/restrict_block_tag.rb

@@ -30,8 +30,9 @@ module RuboCop
         class RestrictBlockTag < Base
           include Metadata
 
-          def on_metadata(symbols, pairs)
-            offenses = (symbols + pairs.map(&:key)).filter do |symbol|
+          def on_metadata(symbols, hash)
+            symbols += hash.pairs.map(&:key) unless hash.nil?
+            offenses = symbols.filter do |symbol|
               !allow_tags.include?(symbol.value.to_s)
             end
 

data/lib/rubocop/cop/rspec/extra/restrict_block_tag_value.rb

@@ -19,8 +19,10 @@ module RuboCop
           include Metadata
           MSG = "This value is not allowed in this tag. Allowed tag value: %<allow_tag_value>s."
 
-          def on_metadata(_symbols, pairs)
-            offenses = pairs.filter do |pair|
+          def on_metadata(_symbols, hash)
+            return if hash.nil?
+
+            offenses = hash.pairs.filter do |pair|
               allow_tag_values.any? do |k, v|
                 pair.key.value.to_s == k &&
                   pair.value.value.to_s != v

data/lib/rubocop/rspec/extra/plugin.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "lint_roller"
+
+module RuboCop
+  module RSpec
+    module Extra
+      # A plugin that integrates RuboCop RSpec Extra with RuboCop's plugin system.
+      class Plugin < LintRoller::Plugin
+        def about
+          LintRoller::About.new(
+            name: "rubocop-rspec-extra",
+            version: Version::STRING,
+            homepage: "https://github.com/ydah/rubocop-rspec-extra",
+            description: "A RuboCop extension focused on enforcing RSpec. A place where no one is officially employed, but where useful cops can gather."
+          )
+        end
+
+        def supported?(context)
+          context.engine == :rubocop
+        end
+
+        def rules(_context)
+          project_root = Pathname.new(__dir__).join("../../../..")
+
+          LintRoller::Rules.new(type: :path, config_format: :rubocop, value: project_root.join("config", "default.yml"))
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/rspec/extra/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 module Rubocop
-  module Rspec
+  module RSpec
     module Extra
-      VERSION = "0.1.0"
+      VERSION = "0.3.0"
     end
   end
 end

data/lib/rubocop-rspec-extra.rb

@@ -2,22 +2,17 @@
 
 require "rubocop-rspec"
 
-require_relative "rubocop/rspec/extra/inject"
 require_relative "rubocop/rspec/extra/version"
-
+require_relative "rubocop/rspec/extra/plugin"
 require_relative "rubocop/cop/rspec/extra/be_empty"
+require_relative "rubocop/cop/rspec/extra/flat_examples"
 require_relative "rubocop/cop/rspec/extra/restrict_block_tag"
 require_relative "rubocop/cop/rspec/extra/restrict_block_tag_value"
 
-module RuboCop
+module Rubocop
   module RSpec
+    # RuboCop RSpec Rails project namespace.
     module Extra
-      PROJECT_ROOT = ::Pathname.new(__dir__).parent.expand_path.freeze
-      CONFIG_DEFAULT = PROJECT_ROOT.join("config", "default.yml").freeze
-      CONFIG = ::YAML.safe_load(CONFIG_DEFAULT.read).freeze
-      private_constant(:CONFIG_DEFAULT, :PROJECT_ROOT)
     end
   end
 end
-
-RuboCop::RSpec::Extra::Inject.defaults!

data/tasks/cut_release.rake

@@ -5,7 +5,7 @@ require "bump"
 namespace :cut_release do
   %w[major minor patch pre].each do |release_type|
     desc "Cut a new #{release_type} release and create release notes."
-    task release_type => "changelog:check_clean" do
+    task release_type do
       run(release_type)
     end
   end
@@ -13,7 +13,7 @@ namespace :cut_release do
   def add_header_to_changelog(version)
     update_file("CHANGELOG.md") do |changelog|
       changelog.sub("## Master (Unreleased)\n\n",
-                    '\0' "## #{version} (#{Time.now.strftime("%F")})\n\n")
+                    "\\0## #{version} (#{Time.now.strftime("%F")})\n\n")
     end
   end
 

metadata

@@ -1,31 +1,49 @@
 --- !ruby/object:Gem::Specification
 name: rubocop-rspec-extra
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - ydah
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-04-17 00:00:00.000000000 Z
+date: 2025-03-18 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: lint_roller
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.72.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.72.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: |
-  Automatic committee code style checking tool.
   A RuboCop extension focused on enforcing RSpec.
   A place where no one is officially employed, but where useful cops can gather.
 email:
@@ -56,12 +74,11 @@ files:
 - docs/modules/ROOT/pages/usage.adoc
 - lib/rubocop-rspec-extra.rb
 - lib/rubocop/cop/rspec/extra/be_empty.rb
+- lib/rubocop/cop/rspec/extra/flat_examples.rb
 - lib/rubocop/cop/rspec/extra/restrict_block_tag.rb
 - lib/rubocop/cop/rspec/extra/restrict_block_tag_value.rb
-- lib/rubocop/rspec/extra/inject.rb
+- lib/rubocop/rspec/extra/plugin.rb
 - lib/rubocop/rspec/extra/version.rb
-- tasks/changelog.rake
-- tasks/changelog.rb
 - tasks/cops_documentation.rake
 - tasks/cut_release.rake
 - tasks/new_cop.rake
@@ -72,8 +89,8 @@ metadata:
   homepage_uri: https://github.com/ydah/rubocop-rspec-extra
   source_code_uri: https://github.com/ydah/rubocop-rspec-extra
   changelog_uri: https://github.com/ydah/rubocop-rspec-extra/blob/master/CHANGELOG.md
+  default_lint_roller_plugin: RuboCop::RSpec::Extra::Plugin
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -81,15 +98,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.5
-signing_key:
+rubygems_version: 3.7.0.dev
 specification_version: 4
-summary: Automatic committee code style checking tool.
+summary: A RuboCop extension focused on enforcing RSpec.
 test_files: []

data/lib/rubocop/rspec/extra/inject.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-module RuboCop
-  module RSpec
-    module Extra
-      module Inject
-        def self.defaults!
-          path = CONFIG_DEFAULT.to_s
-          hash = ::RuboCop::ConfigLoader.send(:load_yaml_configuration, path)
-          config = ::RuboCop::Config.new(hash, path).tap(&:make_excludes_absolute)
-          puts "configuration from #{path}" if ::RuboCop::ConfigLoader.debug?
-          config = ::RuboCop::ConfigLoader.merge_with_default(config, path)
-          ::RuboCop::ConfigLoader.instance_variable_set(:@default_configuration, config)
-        end
-      end
-    end
-  end
-end

data/tasks/changelog.rake

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-autoload :Changelog, "#{__dir__}/changelog"
-
-namespace :changelog do
-  %i[new fix change].each do |type|
-    desc "Create a Changelog entry (#{type})"
-    task type, [:id] do |_task, args|
-      ref_type = :pull if args[:id]
-      path = Changelog::Entry.new(type: type, ref_id: args[:id], ref_type: ref_type).write
-      cmd = "git add #{path}"
-      system cmd
-      puts "Entry '#{path}' created and added to git index"
-    end
-  end
-
-  desc "Merge entries and delete them"
-  task :merge do
-    raise "No entries!" unless Changelog.pending?
-
-    Changelog.new.merge!.and_delete!
-    cmd = "git commit -a -m 'Update Changelog'"
-    puts cmd
-    system cmd
-  end
-
-  desc "Check to see if there are any entries left"
-  task :check_clean do
-    next unless Changelog.pending?
-
-    puts "*** Pending changelog entries!"
-    puts "Do `bundle exec rake changelog:merge`"
-    exit(1)
-  end
-end

data/tasks/changelog.rb

@@ -1,193 +0,0 @@
-# frozen_string_literal: true
-
-if RUBY_VERSION < "2.6"
-  puts "Changelog utilities available only for Ruby 2.6+"
-  exit(1)
-end
-
-# Changelog utility
-class Changelog
-  ENTRIES_PATH = "changelog/"
-  FIRST_HEADER = /#{Regexp.escape("## Master (Unreleased)\n")}/m.freeze
-  CONTRIBUTORS_HEADER = /#{Regexp.escape("<!-- Contributors (alphabetically) -->\n\n")}/m.freeze
-  ENTRIES_PATH_TEMPLATE = "#{ENTRIES_PATH}%<type>s_%<name>s.md"
-  TYPE_REGEXP = /#{Regexp.escape(ENTRIES_PATH)}([a-z]+)_/.freeze
-  TYPE_TO_HEADER = { new: "New features", fix: "Bug fixes", change: "Changes" }.freeze
-  HEADER = /### (.*)/.freeze
-  PATH = "CHANGELOG.md"
-  REF_URL = "https://github.com/rubocop/rubocop-rspec-extra"
-  MAX_LENGTH = 40
-  CONTRIBUTOR = "[@%<link>s]: https://github.com/%<user>s"
-  SIGNATURE = Regexp.new(format(Regexp.escape("[@%<user>s]"), user: '([\w-]+)'))
-  EOF = "\n"
-
-  # New entry
-  Entry = Struct.new(:type, :body, :ref_type, :ref_id, :user, keyword_init: true) do
-    def initialize(type:, body: last_commit_title, ref_type: nil, ref_id: nil, user: github_user)
-      id, body = extract_id(body)
-      ref_id ||= id || "x"
-      ref_type ||= id ? :issues : :pull
-      super
-    end
-
-    def write
-      FileUtils.mkdir_p(ENTRIES_PATH)
-      File.write(path, content)
-      path
-    end
-
-    def path
-      format(ENTRIES_PATH_TEMPLATE, type: type, name: str_to_filename(body))
-    end
-
-    def content
-      period = "." unless body.end_with? "."
-      "- #{ref}: #{body}#{period} ([@#{user}])\n"
-    end
-
-    def ref
-      "[##{ref_id}](#{REF_URL}/#{ref_type}/#{ref_id})"
-    end
-
-    def last_commit_title
-      `git log -1 --pretty=%B`.lines.first.chomp
-    end
-
-    def extract_id(body)
-      /^\[Fix(?:es)? #(\d+)\] (.*)/.match(body)&.captures || [nil, body]
-    end
-
-    def str_to_filename(str)
-      str
-        .split
-        .reject(&:empty?)
-        .map { |s| prettify(s) }
-        .inject do |result, word|
-          s = "#{result}_#{word}"
-          return result if s.length > MAX_LENGTH
-
-          s
-        end
-    end
-
-    def github_user
-      user = `git config --global credential.username`.chomp
-      warn 'Set your username with `git config --global credential.username "myusernamehere"`' if user.empty?
-
-      user
-    end
-
-    private
-
-    def prettify(str)
-      str.gsub!(/\W/, "_")
-
-      # Separate word boundaries by `_`.
-      str.gsub!(/([A-Z]+)(?=[A-Z][a-z])|([a-z\d])(?=[A-Z])/) do
-        (Regexp.last_match(1) || Regexp.last_match(2)) << "_"
-      end
-
-      str.gsub!(/\A_+|_+\z/, "")
-      str.downcase!
-      str
-    end
-  end
-
-  def self.pending?
-    entry_paths.any?
-  end
-
-  def self.entry_paths
-    Dir["#{ENTRIES_PATH}*"]
-  end
-
-  def self.read_entries
-    entry_paths.to_h { |path| [path, File.read(path)] }
-  end
-
-  attr_reader :header, :rest
-
-  def initialize(content: File.read(PATH), entries: Changelog.read_entries)
-    require "strscan"
-
-    parse(content)
-    @entries = entries
-  end
-
-  def and_delete!
-    @entries.each_key { |path| File.delete(path) }
-  end
-
-  def merge!
-    File.write(PATH, merge_content)
-    self
-  end
-
-  def unreleased_content
-    entry_map = parse_entries(@entries)
-    merged_map = merge_entries(entry_map)
-    merged_map.flat_map do |header, things|
-      ["### #{header}\n", *things, ""]
-    end.join("\n")
-  end
-
-  def merge_content
-    merged_content = [@header, unreleased_content, @changes.chomp, *all_contributors].join("\n")
-
-    merged_content << EOF
-  end
-
-  def all_contributors
-    (@contributors.split(/\R/) + new_contributors).uniq.sort
-  end
-
-  def new_contributors
-    contributors
-      .map { |user| format(CONTRIBUTOR, link: user.downcase, user: user) }
-  end
-
-  def contributors
-    contributors = @entries.values.flat_map do |entry|
-      entry.match(/\. \((?<contributors>.+)\)\n/)[:contributors].split(",")
-    end
-
-    contributors.join.scan(SIGNATURE).flatten
-  end
-
-  private
-
-  def merge_entries(entry_map)
-    all = @unreleased.merge(entry_map) { |_k, v1, v2| v1.concat(v2) }
-    canonical = TYPE_TO_HEADER.values.to_h { |v| [v, nil] }
-    canonical.merge(all).compact
-  end
-
-  def parse(content)
-    ss = StringScanner.new(content)
-    @header = ss.scan_until(FIRST_HEADER)
-    @unreleased = parse_release(ss.scan_until(/\n(?=## )/m))
-    @changes = ss.scan_until(CONTRIBUTORS_HEADER)
-    @contributors = ss.rest
-  end
-
-  # @return [Hash<type, Array<String>]]
-  def parse_release(unreleased)
-    unreleased
-      .lines
-      .map(&:chomp)
-      .reject(&:empty?)
-      .slice_before(HEADER)
-      .to_h do |header, *entries|
-        [HEADER.match(header)[1], entries]
-      end
-  end
-
-  def parse_entries(path_content_map)
-    changes = Hash.new { |h, k| h[k] = [] }
-    path_content_map.each do |path, content|
-      header = TYPE_TO_HEADER.fetch(TYPE_REGEXP.match(path)[1].to_sym)
-      changes[header].concat(content.lines.map(&:chomp))
-    end
-    changes
-  end
-end