kettle-test 1.0.8 → 1.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8873d02c97ae25125b1bd5e28afb7d39569147ecf825a7ee9b1a3bf683625f00
-  data.tar.gz: ffa4fb9d179b2c50aaee2916fb1d62f38d1b8f8223b2860b8f70fc6558cf19ed
+  metadata.gz: 79fc981181a8f3b48ffa133eeeea78ad356c5f1bc2816facd7890196b818ca4a
+  data.tar.gz: 301dffb357aa9de2b960e8b7e8026f10d9d3d3770f39beda8856fdecf3e68828
 SHA512:
-  metadata.gz: 047db72c8c38f6ff2452a02ac8e3faeebdc38a582ea052ade396114df0d367ccdc83307dc11e083347813a7b87d7febdfda210d454f549ccd8968f353a5cea77
-  data.tar.gz: dacda95d681dc7cf866dd14d3fb13abdaff14d72771bbada906654e9231f7ce6df2db0c352537443053f29b2fe0a52c27b0167760153dae50faa8c25e5aebc99
+  metadata.gz: 5f71ae20e1df354bd9a7df27798bcbcbbc72c18e2d37675887a4b5fae0c71f61d4303963147cad26c3bbc6e236a318f478f60f961416069d895f471b2c481cc4
+  data.tar.gz: 3e49306564d004d2660f7c097a65dcb193bd475de691f43e960eb54229db76af340b55d2b28a080257761a45ae2af805098dd7f35d2079029e99ff38ddf5c0dc

data/CHANGELOG.md

@@ -30,6 +30,32 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.10] - 2026-02-06
+
+- TAG: [v1.0.10][1.0.10t]
+- COVERAGE: 100.00% -- 86/86 lines in 15 files
+- BRANCH COVERAGE: 100.00% -- 2/2 branches in 15 files
+- 100.00% documented
+
+### Changed
+
+- Upgraded to [appraisal2 v3.0.1](https://github.com/appraisal-rb/appraisal2/releases/tag/v3.0.1)
+
+### Fixed
+
+- removed redundant development dependencies
+
+## [1.0.9] - 2026-02-06
+
+- TAG: [v1.0.9][1.0.9t]
+- COVERAGE: 100.00% -- 86/86 lines in 15 files
+- BRANCH COVERAGE: 100.00% -- 2/2 branches in 15 files
+- 100.00% documented
+
+### Added
+
+- Document usage of rspec-pending_for
+
 ## [1.0.8] - 2026-02-06
 
 - TAG: [v1.0.8][1.0.8t]
@@ -174,7 +200,11 @@ Please file a bug if you notice a violation of semantic versioning.
   - silent_stream
   - timecop-rspec
 
-[Unreleased]: https://github.com/kettle-rb/kettle-test/compare/v1.0.8...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-test/compare/v1.0.10...HEAD
+[1.0.10]: https://github.com/kettle-rb/kettle-test/compare/v1.0.9...v1.0.10
+[1.0.10t]: https://github.com/kettle-rb/kettle-test/releases/tag/v1.0.10
+[1.0.9]: https://github.com/kettle-rb/kettle-test/compare/v1.0.8...v1.0.9
+[1.0.9t]: https://github.com/kettle-rb/kettle-test/releases/tag/v1.0.9
 [1.0.8]: https://github.com/kettle-rb/kettle-test/compare/v1.0.7...v1.0.8
 [1.0.8t]: https://github.com/kettle-rb/kettle-test/releases/tag/v1.0.8
 [1.0.7]: https://github.com/kettle-rb/kettle-test/compare/v1.0.6...v1.0.7

data/README.md

@@ -399,6 +399,94 @@ Or run:
 DEBUG=true bundle exec rspec
 ```
 
+### Version-based pending and skipping
+
+Use rspec-pending_for to conditionally pending or skip examples based on Ruby version and engine.
+
+The `pending_for` and `skip_for` macros support flexible version specifications:
+
+**Supported version forms:**
+- String: exact or partial match to RUBY_VERSION (e.g., "3.2.4", "3.2", or "3")
+- Array of strings: any matching entry triggers pending/skip
+- Range of Gem::Version: inclusive/exclusive endpoints respected
+- Range of Integer: compares major version only (e.g., 2..3 for Ruby 2.x and 3.x)
+
+**Supported engines:** :ruby (MRI), :jruby, :truffleruby
+
+**Specifying versions:**
+
+```ruby
+RSpec.describe("version-specific behavior") do
+  # Exact version string
+  it "pends only on Ruby 3.2.4" do
+    pending_for(engine: :ruby, versions: "3.2.4")
+    # ...
+  end
+
+  # Multiple exact versions
+  it "pends on a set of MRI versions" do
+    pending_for(engine: :ruby, versions: %w[2.7.10 3.0.7 3.1.6])
+  end
+
+  # Match any engine by version (no :engine)
+  it "skips on any engine if version equals 2.7.8" do
+    skip_for(versions: "2.7.8", reason: "Known upstream incompatibility")
+  end
+
+  # Range of Gem::Version (inclusive)
+  it "pends for MRI >= 2.6.0 and <= 3.0.0" do
+    pending_for(
+      engine: :ruby,
+      versions: (Gem::Version.new("2.6.0")..Gem::Version.new("3.0.0")),
+    )
+  end
+
+  # Range of Gem::Version (exclusive end)
+  it "skips for MRI >= 3.1.0 and < 3.3.0" do
+    skip_for(
+      engine: :ruby,
+      versions: (Gem::Version.new("3.1.0")...Gem::Version.new("3.3.0")),
+    )
+  end
+
+  # Range of Integer (major versions)
+  it "pends on all Ruby 2.x and 3.x" do
+    pending_for(versions: (2..3), reason: "Major series currently affected")
+  end
+
+  it "skips on Ruby 2.x but not 3.x" do
+    skip_for(versions: (2...3)) # 2 <= version < 3
+  end
+end
+```
+
+**Using with RSpec tags:**
+
+```ruby
+RSpec.configure do |config|
+  # Auto-skip examples requiring specific Ruby versions via tags
+  config.before(:each, :requires_ruby_32) do
+    skip_for(
+      reason: "Requires Ruby >= 3.2",
+      versions: %w[2.7 3.0 3.1],
+    )
+  end
+end
+
+RSpec.describe("something") do
+  it "runs only on Ruby 3.2+", :requires_ruby_32 do
+    # ... your example code ...
+  end
+end
+```
+
+**Notes:**
+- Omit :engine to match any Ruby engine (MRI, JRuby, TruffleRuby)
+- Omit :versions with :engine to match all versions of that engine
+- JRuby and TruffleRuby are matched using their RUBY_VERSION compatibility
+- String matching supports partial versions ("3.1" matches "3.1.x" but not "3.0.x")
+- Provide :reason to override the default message in reports
+
 ### CI-only filtering
 
 Examples or groups tagged with :skip_ci are excluded on CI (CI=true).

data/lib/kettle/test/version.rb

@@ -6,7 +6,7 @@ module Kettle
     module Version
       # The current version of kettle-test.
       # @return [String]
-      VERSION = "1.0.8"
+      VERSION = "1.0.10"
     end
     VERSION = Version::VERSION # Traditional constant at module level
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-test
 version: !ruby/object:Gem::Version
-  version: 1.0.8
+  version: 1.0.10
 platform: ruby
 authors:
 - Peter H. Boling
@@ -64,6 +64,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -71,6 +74,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.2
 - !ruby/object:Gem::Dependency
   name: backports
   requirement: !ruby/object:Gem::Requirement
@@ -275,20 +281,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.4
-- !ruby/object:Gem::Dependency
-  name: appraisal2
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -343,26 +335,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.3
-- !ruby/object:Gem::Dependency
-  name: kettle-test
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.6
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.6
 description: "\U0001F372 Kettle::Test is a meta tool from kettle-rb to streamline
   testing. Acts as a shim dependency, pulling in many other dependencies, to give
   you OOTB productivity with a RubyGem, or Ruby app project. Configures RSpec w/ syntactic
@@ -418,10 +390,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-test.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-test/tree/v1.0.8
-  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v1.0.8/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-test/tree/v1.0.10
+  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v1.0.10/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-test/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-test/1.0.8
+  documentation_uri: https://www.rubydoc.info/gems/kettle-test/1.0.10
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-test/wiki
   news_uri: https://www.railsbling.com/tags/kettle-test