kettle-test 1.0.7 → 1.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 480c14b6dddd95cbb82eb12f607125e1115d3c990984ef0bd934dc3b077fd8d1
-  data.tar.gz: 69efe9d622290df8b6b0093ff18d4ef276d98b2264783c8d67c6b7d80b6038d3
+  metadata.gz: 9ade52605667c6bbffe9462d76e0229baf3b65aa885c6d6670f42dbaefb95418
+  data.tar.gz: 595322235266965d9ef741b6cdbc2ac0a24d52bb9032e61c2ce733d6af7080f4
 SHA512:
-  metadata.gz: 9e4844be650613c3d6540e43fab7e57e1ef1c17547db6939b0e03a37904b7a027d83e2d92173bf9b98ca624bfffe77f38bd0a4c95c5c3af95fdd7b288241e328
-  data.tar.gz: c6ca9370323b280fd8b7aaba6c76b9601557f443983f549a9f76afb583c704ffe88ebe6b1a01b0d6d7fa80761a0adedc0abf2676e8b4a768eef81f5d17797df6
+  metadata.gz: c671e937041fd20199cf52adf379886f03364f3e4b37fa5c18c97e6e6d7161115f0d5856e96d6892b63482d446292e7dc10b0aa6a9e6f489064d8ab383030d55
+  data.tar.gz: 4184756919209b48245f0752b1e14d7abc8f2bcbe9745feeceef53e98cbbf571a7fc584f1cb9374a8e8467c9844e3242017404c8a52148a6928cdcbf69caef19

data/CHANGELOG.md

@@ -30,6 +30,34 @@ 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]
+- COVERAGE: 100.00% -- 86/86 lines in 15 files
+- BRANCH COVERAGE: 100.00% -- 2/2 branches in 15 files
+- 100.00% documented
+
+### Added
+
+- rspec/pending_for made available by default
+  - `skip_for` and `pending_for` are now available by default, without needing to explicitly require 'rspec/pending_for'
+
+### Changed
+
+- Updated documentation on hostile takeover of RubyGems
+  - https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo
+
 ## [1.0.7] - 2025-12-06
 
 - TAG: [v1.0.7][1.0.7t]
@@ -157,7 +185,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.7...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
 [1.0.7t]: https://github.com/kettle-rb/kettle-test/releases/tag/v1.0.7
 [1.0.6]: https://github.com/kettle-rb/kettle-test/compare/v1.0.5...v1.0.6

data/README.md

@@ -1,36 +1,3 @@
-| 📍 NOTE                                                                                                                                                                                                       |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| RubyGems (the [GitHub org][rubygems-org], not the website) [suffered][draper-security] a [hostile takeover][ellen-takeover] in September 2025.                                                                |
-| Ultimately [4 maintainers][simi-removed] were [hard removed][martin-removed] and a reason has been given for only 1 of those, while 2 others resigned in protest.                                             |
-| It is a [complicated story][draper-takeover] which is difficult to [parse quickly][draper-lies].                                                                                                              |
-| Simply put - there was active policy for adding or removing maintainers/owners of [rubygems][rubygems-maint-policy] and [bundler][bundler-maint-policy], and those [policies were not followed][policy-fail]. |
-| I'm adding notes like this to gems because I [don't condone theft][draper-theft] of repositories or gems from their rightful owners.                                                                          |
-| If a similar theft happened with my repos/gems, I'd hope some would stand up for me.                                                                                                                          |
-| Disenfranchised former-maintainers have started [gem.coop][gem-coop].                                                                                                                                         |
-| Once available I will publish there exclusively; unless RubyCentral makes amends with the community.                                                                                                          |
-| The ["Technology for Humans: Joel Draper"][reinteractive-podcast] podcast episode by [reinteractive][reinteractive] is the most cogent summary I'm aware of.                                                  |
-| See [here][gem-naming], [here][gem-coop] and [here][martin-ann] for more info on what comes next.                                                                                                             |
-| What I'm doing: A (WIP) proposal for [bundler/gem scopes][gem-scopes], and a (WIP) proposal for a federated [gem server][gem-server].                                                                         |
-
-[rubygems-org]: https://github.com/rubygems/
-[draper-security]: https://joel.drapper.me/p/ruby-central-security-measures/
-[draper-takeover]: https://joel.drapper.me/p/ruby-central-takeover/
-[ellen-takeover]: https://pup-e.com/blog/goodbye-rubygems/
-[simi-removed]: https://www.reddit.com/r/ruby/s/gOk42POCaV
-[martin-removed]: https://bsky.app/profile/martinemde.com/post/3m3occezxxs2q
-[draper-lies]: https://joel.drapper.me/p/ruby-central-fact-check/
-[draper-theft]: https://joel.drapper.me/p/ruby-central/
-[reinteractive]: https://reinteractive.com/ruby-on-rails
-[gem-coop]: https://gem.coop
-[gem-naming]: https://github.com/gem-coop/gem.coop/issues/12
-[martin-ann]: https://martinemde.com/2025/10/05/announcing-gem-coop.html
-[gem-scopes]: https://github.com/galtzo-floss/bundle-namespace
-[gem-server]: https://github.com/galtzo-floss/gem-server
-[reinteractive-podcast]: https://youtu.be/_H4qbtC5qzU?si=BvuBU90R2wAqD2E6
-[bundler-maint-policy]: https://github.com/ruby/rubygems/blob/b1ab33a3d52310a84d16b193991af07f5a6a07c0/doc/bundler/playbooks/TEAM_CHANGES.md
-[rubygems-maint-policy]: https://github.com/ruby/rubygems/blob/b1ab33a3d52310a84d16b193991af07f5a6a07c0/doc/rubygems/POLICIES.md?plain=1#L187-L196
-[policy-fail]: https://www.reddit.com/r/ruby/comments/1ove9vp/rubycentral_hates_this_one_fact/
-
 [![Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0][🖼️galtzo-i]][🖼️galtzo-discord] [![ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5][🖼️ruby-lang-i]][🖼️ruby-lang] [![kettle-test Logo by Aboling0, CC BY-SA 4.0][🖼️kettle-test-i]][🖼️kettle-test]
 
 [🖼️galtzo-i]: https://logos.galtzo.com/assets/images/galtzo-floss/avatar-192px.svg
@@ -52,6 +19,13 @@
 
 [![OpenCollective Backers][🖇osc-backers-i]][🖇osc-backers] [![OpenCollective Sponsors][🖇osc-sponsors-i]][🖇osc-sponsors] [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate on Polar][🖇polar-img]][🖇polar] [![Donate at ko-fi.com][🖇kofi-img]][🖇kofi]
 
+<details>
+    <summary>👣 How will this project approach the September 2025 hostile takeover of RubyGems? 🚑️</summary>
+
+I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo).
+
+</details>
+
 ## 🌻 Synopsis
 
 Add to your `spec/spec_helper.rb`:
@@ -124,7 +98,7 @@ Compatible with MRI Ruby 2.3.0+, and concordant releases of JRuby, and TruffleRu
 
 [gh-discussions]: https://github.com/kettle-rb/kettle-test/discussions
 
-### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/kettle-test)](https://tidelift.com/subscription/pkg/rubygems-kettle-test?utm_source=rubygems-kettle-test&utm_medium=referral&utm_campaign=readme)
+### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/kettle-test)][🏙️entsup-tidelift]
 
 Available as part of the Tidelift Subscription.
 
@@ -226,8 +200,8 @@ That's it!  Additional customizations can be done by setting environment variabl
 Below are the environment variables recognized by kettle-test. Unless otherwise specified, set values to the string "true" to enable a boolean feature, or provide the noted type.
 
 - DEBUG (String: "true"/"false")
-  - Overrides default silencing for the entire run; when true, STDOUT/STDERR are not silenced by this library.
-  - Default: "false". If KETTLE_TEST_DEBUG is not set, DEBUG is used.
+    - Overrides default silencing for the entire run; when true, STDOUT/STDERR are not silenced by this library.
+    - Default: "false". If KETTLE_TEST_DEBUG is not set, DEBUG is used.
 - GLOBAL_TIME_TRAVEL_TIME (String: Date/Time)
     - Global start time for Timecop across examples when using time travel.
     - Example: "2014-11-15" or "2014-11-15 13:45:00".
@@ -236,30 +210,30 @@ Below are the environment variables recognized by kettle-test. Unless otherwise
     - Alternate way to set a global date used when GLOBAL_TIME_TRAVEL_TIME is not provided.
     - Default: today (Date.today.to_s).
 - KETTLE_TEST_DEBUG (String: "true"/"false")
-  - Same as DEBUG but namespaced for this gem. Takes precedence over DEBUG.
-  - Default: "false".
+    - Same as DEBUG but namespaced for this gem. Takes precedence over DEBUG.
+    - Default: "false".
 - CI (String: "true"/"false")
-  - Signals a CI environment. When true, examples tagged :skip_ci are excluded.
-  - Also used as the default for KETTLE_TEST_SILENT when not set.
-  - Default: unset/empty → treated as false.
+    - Signals a CI environment. When true, examples tagged :skip_ci are excluded.
+    - Also used as the default for KETTLE_TEST_SILENT when not set.
+    - Default: unset/empty → treated as false.
 - KETTLE_TEST_SILENT (String: "true"/"false")
-  - Controls silencing of STDOUT/STDERR during specs (unless :check_output is used or DEBUG is true).
-  - Default: value of CI (true on CI, false locally unless CI=true).
+    - Controls silencing of STDOUT/STDERR during specs (unless :check_output is used or DEBUG is true).
+    - Default: value of CI (true on CI, false locally unless CI=true).
 - KETTLE_TEST_VERBOSE (String: "true"/"false")
-  - Reserved for future verbose logging toggles. Default: "false".
+    - Reserved for future verbose logging toggles. Default: "false".
 - KETTLE_TEST_FULL_BACKTRACE (String: "true"/"false")
-  - When true, enables RSpec full backtraces.
-  - Default: "false".
+    - When true, enables RSpec full backtraces.
+    - Default: "false".
 - KETTLE_TEST_RSPEC_PROFILE_EXAMPLES (Integer as String)
-  - When > 0, RSpec will profile the slowest N examples or example groups.
-  - Example: KETTLE_TEST_RSPEC_PROFILE_EXAMPLES=10
-  - Default: "0" (disabled).
+    - When > 0, RSpec will profile the slowest N examples or example groups.
+    - Example: KETTLE_TEST_RSPEC_PROFILE_EXAMPLES=10
+    - Default: "0" (disabled).
 - KETTLE_TEST_TM_SEQUENTIAL (String: "true"/"false")
     - Controls Timecop sequential time machine mode for RSpec examples (see below).
     - Default: "true".
 - PARALLEL_TEST_FIRST_IS_1 (String: "true"/"false") and TEST_ENV_NUMBER (String)
-  - Used to detect parallel test runs via Kettle::Test.is_parallel_test?. Not generally required to set manually.
-  - Default: unset (treated as non-parallel unless provided by your parallel test runner).
+    - Used to detect parallel test runs via Kettle::Test.is_parallel_test?. Not generally required to set manually.
+    - Default: unset (treated as non-parallel unless provided by your parallel test runner).
 
 ### TimeCop-RSpec
 
@@ -303,6 +277,7 @@ except that it will sometimes resume time travel.
 
 Global travel will always resume from when the previous global traveled
 example ended. E.g.
+
 ```ruby
 # GLOBAL_TIME_TRAVEL_TIME=2014-11-15 bundle exec rspec some_spec.rb
 
@@ -362,6 +337,7 @@ end
 Following spec's local travel will resume when specified time is the same as the
 previous examples specified time. If the time is different, it will
 start from the current examples specified time.
+
 ```ruby
 describe SomeUnit, travel: Time.new(2014, 11, 15) do
   it "example 1" do
@@ -423,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).
@@ -476,7 +540,7 @@ and [Tidelift][🏙️entsup-tidelift].
 
 ### Open Collective for Individuals
 
-Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/kettle-rb#backer)]
+Support us with a monthly donation and help us continue our activities. [[Become a backer][🖇osc-backers]]
 
 NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
 
@@ -486,7 +550,7 @@ No backers yet. Be the first!
 
 ### Open Collective for Organizations
 
-Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/kettle-rb#sponsor)]
+Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor][🖇osc-sponsors]]
 
 NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
 
@@ -673,7 +737,6 @@ Thanks for RTFM. ☺️
 [✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
 [✉️ruby-friends-img]: https://img.shields.io/badge/daily.dev-%F0%9F%92%8E_Ruby_Friends-0A0A0A?style=for-the-badge&logo=dailydotdev&logoColor=white
 [✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
-
 [✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
 [⛳️gem-namespace]: https://github.com/kettle-rb/kettle-test
 [⛳️namespace-img]: https://img.shields.io/badge/namespace-Kettle::Test-3C2D2D.svg?style=square&logo=ruby&logoColor=white
@@ -820,7 +883,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.084-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.086-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/lib/kettle/test/config/int/rspec/silent_stream.rb

@@ -7,6 +7,10 @@ RSpec.configure do |config|
       example.run
     # Make tests run silently, with shunted STDOUT & STDERR, if ENV var KETTLE_TEST_SILENT == "true"
     else
+      # silence_all only silences STDOUT
+      # Alternatives:
+      #   quietly also silences STDERR
+      #   silence_stderr only silences STDERR
       silence_all(Kettle::Test::SILENT) do
         example.run
       end

data/lib/kettle/test/internal.rb

@@ -4,6 +4,7 @@
 # config/int and its subfolders.
 # Files in config/ext may depend on this library's internals.
 require_relative "config/int/rspec_block_is_expected"
+require_relative "config/int/rspec_pending_for"
 require_relative "config/int/rspec/rspec_core"
 require_relative "config/int/rspec/silent_stream"
 

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.7"
+      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.7
+  version: 1.0.9
 platform: ruby
 authors:
 - Peter H. Boling
@@ -219,14 +219,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.60
+        version: 1.2.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.60
+        version: 1.2.4
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -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.7
-  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v1.0.7/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.7
+  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
@@ -450,7 +450,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.5
 specification_version: 4
 summary: "\U0001F372 A kettle-rb meta tool to streamline testing"
 test_files: []