rspec-stubbed_env 1.0.16 → 1.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c20d2c0480db9e2e47ce60b7ddbaa6ee9e9714c73347a3489bcf78dc67a573e7
-  data.tar.gz: 8037345139c346559763d4817e9614947ec1d7c335a26e9e15a71ead8c6caba6
+  metadata.gz: 4f2902dac6f65ba1dea2ddc2a793451bee933d8b2238ed28dc42b82240382580
+  data.tar.gz: 07aea66f238e7d75130348da683999aabe0f9ac23eada29c2e4b72e26dec6f38
 SHA512:
-  metadata.gz: dbf880e0a6719538492db3a1845721414d18bfd27983b017c13b87b4560d16c5d8d007483bad5a66721b33e179fb354ea417d6b7f99dbf99434c615ffb031708
-  data.tar.gz: '070608911197383c58184e70573411fedd749478e58367190078ffd14318a9b149bb5db89f18185e33c43589ecc8c8d74b4e814c838f66bd71571a5f52269034'
+  metadata.gz: b6bde6720288d1ddc2c376887d107052164b108d7abf1122f3142a07dcf699291c6ba326402f163fef247868b683a668976f4988e16479c7786c9fd1ed89607a
+  data.tar.gz: 659ce79a6d6200ec6e66825ed9091fb97179a40951f4a966193ddd54f871e1337ac438c48f02db2aa6154ec83e4ba6a2429c4b04df3c9f53b35532c46db4741d

data/CHANGELOG.md

@@ -30,6 +30,29 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.17] - 2026-10-13
+
+- TAG: [v1.0.17][1.0.17t]
+- COVERAGE: 100.00% -- 84/84 lines in 5 files
+- BRANCH COVERAGE: 100.00% -- 31/31 branches in 5 files
+- 75.00% documented
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 37 project files:
+  - configuration (1)
+  - dependencies (36)
+- [kc] kettle-jem/template: updated 21 project files:
+  - code and tests (4)
+  - dependencies (2)
+  - documentation (2)
+  - other (2)
+  - workflows (11)
+
+### Fixed
+
+- Re-stubbing the same ENV key across examples no longer raises "message expectation ... has already been invoked and cannot be modified further": ENV accessors are stubbed with one block-backed receive per accessor reading a mutation ledger, instead of per-key .with(key) expectations that collide after invocation (observed as a seed-dependent failure on kettle-dev's jruby-9.2 CI lane)
+
 ## [1.0.16] - 2026-10-01
 
 - TAG: [v1.0.16][1.0.16t]
@@ -390,7 +413,9 @@ Please file a bug if you notice a violation of semantic versioning.
 [@darhazer]: https://github.com/darhazer
 [@hosamaly]: https://github.com/hosamaly
 
-[Unreleased]: https://github.com/galtzo-floss/rspec-stubbed_env/compare/v1.0.16...HEAD
+[Unreleased]: https://github.com/galtzo-floss/rspec-stubbed_env/compare/v1.0.17...HEAD
+[1.0.17]: https://github.com/galtzo-floss/rspec-stubbed_env/compare/v1.0.16...v1.0.17
+[1.0.17t]: https://github.com/galtzo-floss/rspec-stubbed_env/releases/tag/v1.0.17
 [1.0.16]: https://github.com/galtzo-floss/rspec-stubbed_env/compare/v1.0.15...v1.0.16
 [1.0.16t]: https://github.com/galtzo-floss/rspec-stubbed_env/releases/tag/v1.0.16
 [1.0.15]: https://github.com/galtzo-floss/rspec-stubbed_env/compare/v1.0.14...v1.0.15

data/README.md

@@ -71,7 +71,7 @@ due to the inherent limitations of GitHub Actions.
 | Tokens to Remember | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace] |
 |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Works with JRuby | [![JRuby 9.2 Compat][💎jruby-9.2i]][🚎jruby-9.2-wf] [![JRuby 9.3 Compat][💎jruby-9.3i]][🚎jruby-9.3-wf] <br/> [![JRuby 9.4 Compat][💎jruby-9.4i]][🚎jruby-9.4-wf] [![JRuby 10.0 Compat][💎jruby-10.0i]][🚎jruby-10.0-wf] [![JRuby current Compat][💎jruby-c-i]][🚎10-j-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf]|
-| Works with Truffle Ruby | [![Truffle Ruby 22.3 Compat][💎truby-22.3i]][🚎truby-22.3-wf] [![Truffle Ruby 23.0 Compat][💎truby-23.0i]][🚎truby-23.0-wf] [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎truby-23.1-wf] <br/> [![Truffle Ruby 24.2 Compat][💎truby-24.2i]][🚎truby-24.2-wf] [![Truffle Ruby 25.0 Compat][💎truby-25.0i]][🚎truby-25.0-wf] [![Truffle Ruby 33.0 Compat][💎truby-33.0i]][🚎truby-33.0-wf] [![Truffle Ruby current Compat][💎truby-c-i]][🚎9-t-wf] [![Truffle Ruby HEAD Compat][💎truby-headi]][🚎3-hd-wf]|
+| Works with Truffle Ruby | [![Truffle Ruby 22.3 Compat][💎truby-22.3i]][🚎truby-22.3-wf] [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎truby-23.1-wf] <br/> [![Truffle Ruby 24.2 Compat][💎truby-24.2i]][🚎truby-24.2-wf] [![Truffle Ruby 25.0 Compat][💎truby-25.0i]][🚎truby-25.0-wf] [![Truffle Ruby 33.0 Compat][💎truby-33.0i]][🚎truby-33.0-wf] [![Truffle Ruby current Compat][💎truby-c-i]][🚎9-t-wf]|
 | Works with MRI Ruby 4 | [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]|
 | Works with MRI Ruby 3 | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎ruby-3.0-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎ruby-3.1-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎ruby-3.2-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎ruby-3.3-wf] [![Ruby 3.4 Compat][💎ruby-3.4i]][🚎ruby-3.4-wf]|
 | Works with MRI Ruby 2 | ![Ruby 2.0 Compat][💎ruby-2.0i] ![Ruby 2.1 Compat][💎ruby-2.1i] ![Ruby 2.2 Compat][💎ruby-2.2i] ![Ruby 2.3 Compat][💎ruby-2.3i] <br/> [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎ruby-2.4-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎ruby-2.5-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎ruby-2.6-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎ruby-2.7-wf]|
@@ -112,6 +112,23 @@ The _amazing_ test matrix is powered by the kettle-dev stack.
 
 </details>
 
+### Runtime and Platform Support
+
+Support tiers describe what this project's CI actually exercises, not what may
+work in an untested environment:
+
+- **Parallel support**: CI runs the test suite with multiple workers available.
+- **Unsupported**: the engine/platform combination is not covered by CI and is
+ not a project compatibility claim.
+
+| Ruby engine/version | Linux | macOS | Windows | Notes |
+|---------------------|-------|-------|---------|-------|
+| MRI 3.1-3.4 | Parallel support | Unsupported | Unsupported | Versioned Ruby workflows run on Linux. |
+| MRI current | Parallel support | Parallel support | Unsupported | Current Ruby workflow covers the declared OS platforms. |
+| MRI head | Parallel support | Unsupported | Unsupported | CI is allowed to fail while Ruby is in development. |
+| JRuby (all CI lanes) | Parallel support | Unsupported | Unsupported | Engine workflows run on Linux; macOS and Windows are not exercised by CI. |
+| TruffleRuby (all CI lanes) | Parallel support | Unsupported | Unsupported | Never shipped a Windows build (zero Windows assets across 66 releases scanned 2026-10-10); setup-ruby hard-fails ([source](https://github.com/ruby/setup-ruby/blob/master/README.md)) |
+
 ### Federated DVCS
 
 <details markdown="1">
@@ -611,7 +628,6 @@ Thanks for RTFM. ☺️
 [🚎jruby-9.4-wf]: https://github.com/galtzo-floss/rspec-stubbed_env/actions/workflows/jruby-9.4.yml
 [🚎jruby-10.0-wf]: https://github.com/galtzo-floss/rspec-stubbed_env/actions/workflows/jruby-10.0.yml
 [🚎truby-22.3-wf]: https://github.com/galtzo-floss/rspec-stubbed_env/actions/workflows/truffleruby-22.3.yml
-[🚎truby-23.0-wf]: https://github.com/galtzo-floss/rspec-stubbed_env/actions/workflows/truffleruby-23.0.yml
 [🚎truby-23.1-wf]: https://github.com/galtzo-floss/rspec-stubbed_env/actions/workflows/truffleruby-23.1.yml
 [🚎truby-24.2-wf]: https://github.com/galtzo-floss/rspec-stubbed_env/actions/workflows/truffleruby-24.2.yml
 [🚎truby-25.0-wf]: https://github.com/galtzo-floss/rspec-stubbed_env/actions/workflows/truffleruby-25.0.yml
@@ -654,13 +670,11 @@ Thanks for RTFM. ☺️
 [💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
 [💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge&logo=ruby&logoColor=blue
 [💎truby-22.3i]: https://img.shields.io/badge/Truffle_Ruby-22.3-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
-[💎truby-23.0i]: https://img.shields.io/badge/Truffle_Ruby-23.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-23.1i]: https://img.shields.io/badge/Truffle_Ruby-23.1-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-24.2i]: https://img.shields.io/badge/Truffle_Ruby-24.2-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-25.0i]: https://img.shields.io/badge/Truffle_Ruby-25.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-33.0i]: https://img.shields.io/badge/Truffle_Ruby-33.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge&logo=ruby&logoColor=green
-[💎truby-headi]: https://img.shields.io/badge/Truffle_Ruby-HEAD-34BCB1?style=for-the-badge&logo=ruby&logoColor=blue
 [💎jruby-9.2i]: https://img.shields.io/badge/JRuby-9.2-FBE742?style=for-the-badge&logo=ruby&logoColor=red
 [💎jruby-9.3i]: https://img.shields.io/badge/JRuby-9.3-FBE742?style=for-the-badge&logo=ruby&logoColor=red
 [💎jruby-9.4i]: https://img.shields.io/badge/JRuby-9.4-FBE742?style=for-the-badge&logo=ruby&logoColor=red
@@ -693,7 +707,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.094-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.084-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/galtzo-floss/rspec-stubbed_env/blob/main/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/rspec/stubbed_env/hide_helpers.rb

@@ -48,29 +48,6 @@ module RSpec
       def add_hidden_key(key)
         key = key.to_s # Support symbols by forcing to string
         remember_hidden_key(key)
-        hide_brackets(key)
-        hide_fetch(key)
-        hide_values_at
-      end
-
-      def hide_brackets(key)
-        allow(ENV).to(receive(:[]).with(key).and_return(nil))
-      end
-
-      def hide_fetch(key)
-        allow(ENV).to(receive(:fetch).with(key)) do |_|
-          raise KeyError, "key not found: \"#{key}\""
-        end
-        allow(ENV).to(receive(:fetch).with(key, anything)) do |_, default_val|
-          default_val
-        end
-      end
-
-      # Rides on the fetch hider!
-      def hide_values_at
-        allow(ENV).to(receive(:values_at)) do |*args|
-          args.map { |arg| ENV.fetch(arg, nil) }
-        end
       end
     end
   end

data/lib/rspec/stubbed_env/stub_helpers.rb

@@ -55,48 +55,50 @@ module RSpec
         allow(ENV).to(receive(:to_h) { mixed_env_hash })
       end
 
-      private
-
-      STUBBED_KEY = "__STUBBED__"
-
-      def add_stubbed_value(key, value, track: true)
-        key = key.to_s # Support symbols by forcing to string
-        remember_stubbed_value(key, value) if track
-        allow_brackets(key, value)
-        allow_fetch(key, value)
-        allow_values_at
+      def env_stubbed?
+        instance_variable_defined?(:@__rspec_stubbed_env_mutations) && !@__rspec_stubbed_env_mutations.empty?
       end
 
-      def allow_brackets(key, value)
-        allow(ENV).to(receive(:[]).with(key).and_return(value))
+      def init_stub
+        @__rspec_stubbed_env_mutations ||= []
+        install_env_accessors
+        add_stubbed_value(STUBBED_KEY, true, :track => false)
       end
 
-      def allow_fetch(key, value)
-        allow(ENV).to(receive(:fetch).with(key).and_return(value))
-        allow(ENV).to(receive(:fetch).with(key, anything)) do |_, default_val|
-          value || default_val
-        end
-      end
+      # Install ONE block-backed receive per accessor instead of per-key
+      # `.with(key)` expectations. Per-key expectations collide when the same
+      # key is stubbed again in a later example after the earlier expectation
+      # has been invoked — rspec-mocks raises "message expectation ... has
+      # already been invoked and cannot be modified further" (observed as a
+      # seed-dependent CI failure). The blocks read the mutation ledger at
+      # call time, so later stub_env / hide_env calls only append to it.
+      def install_env_accessors
+        allow(ENV).to(receive(:[]) { |key| mixed_env_hash[key] })
+        allow(ENV).to(receive(:fetch) do |key, *rest, &default_block|
+          hidden = @__rspec_stubbed_env_mutations.reverse.any? do |op, k, _|
+            op == :hide && k == key
+          end
+          value = mixed_env_hash[key]
+          if hidden && value.nil?
+            unless rest.empty?
+              next rest.first
+            end
+            next default_block.call if default_block
+
+            raise KeyError, %(key not found: "#{key}")
+          end
+          if value.nil?
+            next rest.first unless rest.empty?
+            next default_block.call if default_block
+          end
 
-      # Rides on the fetch stub!
-      def allow_values_at
+          value
+        end)
         allow(ENV).to(receive(:values_at)) do |*args|
-          args.map { |arg| ENV.fetch(arg, nil) }
+          args.map { |arg| mixed_env_hash[arg] }
         end
       end
 
-      def env_stubbed?
-        ENV.fetch(STUBBED_KEY, nil)
-      end
-
-      def init_stub
-        @__rspec_stubbed_env_mutations ||= []
-        allow(ENV).to(receive(:[]).and_call_original)
-        allow(ENV).to(receive(:fetch).and_call_original)
-        allow(ENV).to(receive(:values_at).and_call_original)
-        add_stubbed_value(STUBBED_KEY, true, :track => false)
-      end
-
       def remember_stubbed_value(key, value)
         @__rspec_stubbed_env_mutations ||= []
         @__rspec_stubbed_env_mutations << [:stub, key, value]
@@ -118,6 +120,15 @@ module RSpec
           end
         end
       end
+
+      private
+
+      STUBBED_KEY = "__STUBBED__"
+
+      def add_stubbed_value(key, value, track: true)
+        key = key.to_s # Support symbols by forcing to string
+        remember_stubbed_value(key, value) if track
+      end
     end
   end
 end

data/lib/rspec/stubbed_env/version.rb

@@ -5,7 +5,7 @@ module RSpec
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "1.0.16"
+      VERSION = "1.0.17"
     end
     # Current gem version exposed at the traditional constant location.
     VERSION = Version::VERSION # Traditional Constant Location

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rspec-stubbed_env
 version: !ruby/object:Gem::Version
-  version: 1.0.16
+  version: 1.0.17
 platform: ruby
 authors:
 - Peter H. Boling
@@ -48,7 +48,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.5
+        version: 3.1.11
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -58,7 +58,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.5
+        version: 3.1.11
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -156,7 +156,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.23
+        version: 2.0.24
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -166,7 +166,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.23
+        version: 2.0.24
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -176,7 +176,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.12
+        version: 3.2.14
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -186,7 +186,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.12
+        version: 3.2.14
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -230,7 +230,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.13
+        version: 2.0.15
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -240,7 +240,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.13
+        version: 2.0.15
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -305,10 +305,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://rspec-stubbed-env.galtzo.com/
-  source_code_uri: https://github.com/galtzo-floss/rspec-stubbed_env/tree/v1.0.16
-  changelog_uri: https://github.com/galtzo-floss/rspec-stubbed_env/blob/v1.0.16/CHANGELOG.md
+  source_code_uri: https://github.com/galtzo-floss/rspec-stubbed_env/tree/v1.0.17
+  changelog_uri: https://github.com/galtzo-floss/rspec-stubbed_env/blob/v1.0.17/CHANGELOG.md
   bug_tracker_uri: https://github.com/galtzo-floss/rspec-stubbed_env/issues
-  documentation_uri: https://www.rubydoc.info/gems/rspec-stubbed_env/1.0.16
+  documentation_uri: https://www.rubydoc.info/gems/rspec-stubbed_env/1.0.17
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/galtzo-floss/rspec-stubbed_env/wiki
   news_uri: https://www.railsbling.com/tags/rspec-stubbed_env