♻️ Refactor spec harness

Author: pboling

Gemfile

@@ -17,7 +17,7 @@ gemspec
 
 platform :mri do
   # Debugging - Ensure ENV["DEBUG"] == "true" to use debuggers within spec suite
-  if ruby_version < Gem::Version.new("2.7")
+  if ruby_version < Gem::Version.create("2.7")
     # Use byebug in code
     gem "byebug", ">= 11"
   else
@@ -49,3 +49,5 @@ eval_gemfile "gemfiles/modular/style.gemfile"
 eval_gemfile "gemfiles/modular/documentation.gemfile"
 
 gem "appraisal", github: "pboling/appraisal", branch: "galtzo"
+
+gem "gem_checksums", github: "pboling/gem_checksums", branch: "feat/docs"

Gemfile.lock

@@ -8,6 +8,14 @@ GIT
       rake (>= 10)
       thor (>= 0.14.0)
 
+GIT
+  remote: https://github.com/pboling/gem_checksums
+  revision: 5ae91cf8cbf741c76254272c8dac09b2afac22c7
+  branch: feat/docs
+  specs:
+    gem_checksums (1.0.0)
+      version_gem (>= 1.1.5, < 3)
+
 PATH
   remote: .
   specs:
@@ -233,6 +241,7 @@ DEPENDENCIES
   benchmark (~> 0.4)
   bundler-audit (~> 0.9.2)
   debug (>= 1.0.0)
+  gem_checksums!
   github-markup (~> 5.0, >= 5.0.1)
   kettle-soup-cover (~> 1.0, >= 1.0.4)
   pry (~> 0.14)

Rakefile

@@ -68,5 +68,14 @@ rescue LoadError
   task(coverage: :spec)
 end
 
+begin
+  require "gem_checksums"
+  GemChecksums.install_tasks
+rescue LoadError
+  task("build:checksums") do
+    warn("gem_checksums is not available")
+  end
+end
+
 # coverage task will open coverage in browser locally
 task default: %i[coverage rubocop_gradual:autocorrect yard yard:junk]

spec/config/byebug.rb

@@ -0,0 +1,10 @@
+if ENV.fetch("DEBUG", "false").casecmp?("true")
+  ruby_version = Gem::Version.create(RUBY_VERSION)
+  if ruby_version < Gem::Version.create("2.7")
+    # Use byebug in code
+    require "byebug"
+  else
+    # Use binding.break, binding.b, or debugger in code
+    require "debug"
+  end
+end

spec/config/rspec/rspec_block_is_expected.rb

@@ -1,5 +1,2 @@
 require "rspec/block_is_expected"
-
-# This breaks RSpec v2, which may be used to run transpec.
-# So allow it to be turned off.
-require "rspec/block_is_expected/matchers/not" unless ENV["TRANSPEC"] == "true"
+require "rspec/block_is_expected/matchers/not"

spec/helpers/faux.rb

@@ -0,0 +1,20 @@
+# - Not requiring because we want line coverage
+# - Not loading because we don't want to manage the constant re-definition
+module VersionGem
+  # Helpers for library CI integration against many different versions of Ruby
+  module Faux
+    RUBY_VER = ::Gem::Version.new(RUBY_VERSION)
+
+    def gte_minimum_version?(version, engine = "ruby")
+      RUBY_VER >= ::Gem::Version.new(version) && ::RUBY_ENGINE == engine
+    end
+    module_function :gte_minimum_version?
+
+    def actual_minor_version?(major, minor, engine = "ruby")
+      major.to_i == RUBY_VER.segments[0] &&
+        minor.to_i == RUBY_VER.segments[1] &&
+        ::RUBY_ENGINE == engine
+    end
+    module_function :actual_minor_version?
+  end
+end

spec/spec_helper.rb

@@ -1,48 +1,27 @@
 # frozen_string_literal: true
 
-begin
-  # This does not require "simplecov",
-  #   because that has a side-effect of running `.simplecov`
-  # Avoid loading version_gem via "kettle-soup-cover":
-  require "kettle/soup/cover"
-rescue LoadError
-  puts "Not running code coverage"
-end
-
 DEBUG = ENV.fetch("DEBUG", nil) == "true"
 DEBUG_IDE = ENV.fetch("DEBUG_IDE", "false") == "true"
 
-# Ruby Helpers from this gem.
-# - Not requiring because we want line coverage
-# - Not loading because we don't want to manage the constant re-definition
-module VersionGem
-  # Helpers for library CI integration against many different versions of Ruby
-  module Faux
-    RUBY_VER = ::Gem::Version.new(RUBY_VERSION)
-
-    def gte_minimum_version?(version, engine = "ruby")
-      RUBY_VER >= ::Gem::Version.new(version) && ::RUBY_ENGINE == engine
-    end
-    module_function :gte_minimum_version?
-
-    def actual_minor_version?(major, minor, engine = "ruby")
-      major.to_i == RUBY_VER.segments[0] &&
-        minor.to_i == RUBY_VER.segments[1] &&
-        ::RUBY_ENGINE == engine
-    end
-    module_function :actual_minor_version?
-  end
-end
-
 # RSpec Configs
+require_relative "config/byebug"
 require_relative "config/rspec/rspec_core"
 require_relative "config/rspec/rspec_block_is_expected"
 
 # RSpec Helpers which do not depend on gem internals
-# NONE
+require_relative "helpers/faux"
 
 # Last thing before this gem is code coverage:
-require "simplecov" if defined?(Kettle) && Kettle::Soup::Cover::DO_COV
+begin
+  # kettle-soup-cover does not require "simplecov", but
+  #   we do that next, and that has a side effect of running `.simplecov`
+  # Also, we must avoid loading "version_gem" (this gem) via "kettle-soup-cover",
+  #   so instead of the normal kettle-soup-cover we use kettle/soup/cover.
+  require "kettle/soup/cover"
+  require "simplecov" if defined?(Kettle) && Kettle::Soup::Cover::DO_COV
+rescue LoadError
+  nil
+end
 
 # This gem
 require "version_gem"

version_gem.gemspec

@@ -71,6 +71,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency("rspec-block_is_expected", "~> 1.0")  # ruby >= 1.8.7
 
   # Development Tasks
+  spec.add_development_dependency("gem_checksums", "~> 1.0")            # ruby >= 2.2
   spec.add_development_dependency("rake", "~> 13.0")                    # ruby >= 2.2
 
   # Linting - rubocop-lts v8 is a rubocop wrapper for Ruby >= 2.2,