kettle-test 1.0.8 → 1.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8873d02c97ae25125b1bd5e28afb7d39569147ecf825a7ee9b1a3bf683625f00
-  data.tar.gz: ffa4fb9d179b2c50aaee2916fb1d62f38d1b8f8223b2860b8f70fc6558cf19ed
+  metadata.gz: 9ade52605667c6bbffe9462d76e0229baf3b65aa885c6d6670f42dbaefb95418
+  data.tar.gz: 595322235266965d9ef741b6cdbc2ac0a24d52bb9032e61c2ce733d6af7080f4
 SHA512:
-  metadata.gz: 047db72c8c38f6ff2452a02ac8e3faeebdc38a582ea052ade396114df0d367ccdc83307dc11e083347813a7b87d7febdfda210d454f549ccd8968f353a5cea77
-  data.tar.gz: dacda95d681dc7cf866dd14d3fb13abdaff14d72771bbada906654e9231f7ce6df2db0c352537443053f29b2fe0a52c27b0167760153dae50faa8c25e5aebc99
+  metadata.gz: c671e937041fd20199cf52adf379886f03364f3e4b37fa5c18c97e6e6d7161115f0d5856e96d6892b63482d446292e7dc10b0aa6a9e6f489064d8ab383030d55
+  data.tar.gz: 4184756919209b48245f0752b1e14d7abc8f2bcbe9745feeceef53e98cbbf571a7fc584f1cb9374a8e8467c9844e3242017404c8a52148a6928cdcbf69caef19

data/CHANGELOG.md

@@ -30,6 +30,17 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [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 +185,9 @@ 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.9...HEAD
+[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.9"
     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.9
 platform: ruby
 authors:
 - Peter H. Boling
@@ -418,10 +418,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.9
+  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v1.0.9/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.9
   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