rspec-support 3.13.7 → 4.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ced51c215b6d9b3af8f27d1abe6033a633f3818312c1bd5850195a10e1ccb172
-  data.tar.gz: dd7afad96ac46be53ad3df4956098a7ec936828c67acb2446f9d5fa37d0bc940
+  metadata.gz: cc1363792fc66b3235686119b09af82568e6ab339f0cdd2835e92988f8693024
+  data.tar.gz: a375231249ed4d4b3b8b0d2a96e57f25497361aa048c5d850bcf80c12422ad21
 SHA512:
-  metadata.gz: '0996fd67d068112ba314ac10665a6bbc8b0c2a9c56e2147008bcf38d589de944023a27776b88f496388fb862e8f6dfa8efae4e45066f03f3672060ebfd58deb8'
-  data.tar.gz: 052d7bf8afb92561f555026534c8380f276aabdc0abab2572beb31788b4505e72080a8cb1179ad8c828fb4ed9fe65b5c9ccb8566d13d519c6aae4996b124caa4
+  metadata.gz: e234899c929288a0a1908133573bb90225430716a58ec1fc4d63ac11a1603dde06db862dd536a490d0a35f833feaf6afc0afe7f6e7533fa18f8cdfc6f42647b3
+  data.tar.gz: 7d20632c52abfac745d28100ef5d41449c05bfdf97a78ee2723a73d2c3d13129cf24794cfc581e7bc4c5b4f1085556ad0d0613f1847d27ef39295552e6bf683e

data/Changelog.md

@@ -1,11 +1,32 @@
 ### Development
-[Full Changelog](https://github.com/rspec/rspec/compare/rspec-support-v3.13.6...3-13-maintenance)
+[Full Changelog](https://github.com/rspec/rspec/compare/rspec-support-v3.13.6...main)
+
+# 4.0.0.beta1 / 2026-02-18
+
+Breaking Changes:
+
+* Ruby < 3.0 is no longer supported. (Phil Pirozhkov, Jon Rowe, rspec/rspec-support#436, rspec/rspec#258)
+* Removed unused `RSpec::Support::ObjectFormatter::BigDecimalInspector`. (Jon Rowe, rspec/rspec#254)
+* Remove unsupported `RSpec::Support::RubyFeatures.supports_taint?` check. (Jon Rowe, rspec/rspec#255)
+* Remove unsupported `RSpec::Support::RubyFeatures.kw_arg_separation?` check. (Jon Rowe, rspec/rspec#256)
+* Remove unsupported `RSpec::Support::RubyFeatures.distincts_kw_args_from_positional_hash?` check. (Jon Rowe, rspec/rspec#257)
+
+Enhancements
+
+* Improve diff for `anything` matchers by hiding the value "anything" is matched
+  against. (Karl Heitmann, rspec/rspec-mocks#599)
+
+Bug Fixes:
+
+* Switch current thread data to alias/accessors to avoid issues with mocked systems.
+  (Jon Rowe, #610)
+* Always return a boolean from `RSpec::Support::Ruby.rbx?` and
+ `RSpec::Support::Ruby.truffleruby?` (Phil Pirozhkov, rspec/rspec-support#486)
 
 ### 3.13.7 / 2026-01-28
 [Full Changelog](http://github.com/rspec/rspec/compare/rspec-support-v3.13.6...rspec-support-v3.13.7)
 
 Bug Fixes:
-
 * Stop fuzzy matching causing false positives from Range objects. (Eric Mueller, rspec/rspec#298)
 
 ### 3.13.6 / 2025-08-18

data/LICENSE.md

@@ -1,7 +1,10 @@
 The MIT License (MIT)
-====================
+=====================
 
 * Copyright © 2013 David Chelimsky, Myron Marston, Jon Rowe, Sam Phippen, Xavier Shay, Bradley Schaefer
+* Copyright © 2012 David Chelimsky, Myron Marston
+* Copyright © 2006 David Chelimsky, The RSpec Development Team
+* Copyright © 2005 Steven Baker
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -16,8 +19,8 @@ included in all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,40 +1,8 @@
-# RSpec::Support [![Build Status](https://github.com/rspec/rspec-support/workflows/RSpec%20CI/badge.svg)](https://github.com/rspec/rspec-support/actions)
+# RSpec::Support
 
-`RSpec::Support` provides common functionality to `RSpec::Core`,
-`RSpec::Expectations` and `RSpec::Mocks`. It is considered
-suitable for internal use only at this time.
+This is the readme for `rspec-support`, there isn't anything to see here but see also:
 
-## Installation / Usage
-
-Install one or more of the `RSpec` gems.
-
-Want to run against the `main` branch? You'll need to include the dependent
-RSpec repos as well. Add the following to your `Gemfile`:
-
-```ruby
-%w[rspec-core rspec-expectations rspec-mocks rspec-support].each do |lib|
-  gem lib, :git => "https://github.com/rspec/#{lib}.git", :branch => 'main'
-end
-```
-
-## Contributing
-
-Once you've set up the environment, you'll need to cd into the working
-directory of whichever repo you want to work in. From there you can run the
-specs and cucumber features, and make patches.
-
-NOTE: You do not need to use rspec-dev to work on a specific RSpec repo. You
-can treat each RSpec repo as an independent project.
-
-- [Build details](BUILD_DETAIL.md)
-- [Code of Conduct](CODE_OF_CONDUCT.md)
-- [Detailed contributing guide](CONTRIBUTING.md)
-- [Development setup guide](DEVELOPMENT.md)
-
-## Patches
-
-Please submit a pull request or a github issue. If you submit an issue, please
-include a link to either of:
-
-* a gist (or equivalent) of the patch
-* a branch or commit in your github fork of the repo
+* [The combined readme](../README.md)
+* [rspec-core](../rspec-core/README.md)
+* [rspec-expectations](../rspec-expectations/README.md)
+* [rspec-mocks](../rspec-mocks/README.md)

data/lib/rspec/support/caller_filter.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-RSpec::Support.require_rspec_support "ruby_features"
-
 module RSpec
   # Consistent implementation for "cleaning" the caller method to strip out
   # non-rspec lines. This enables errors to be reported at the call site in
@@ -29,56 +27,47 @@ module RSpec
     # with this complexity in our `RSpec.deprecate` calls, so we ignore it here.
     IGNORE_REGEX = Regexp.union(LIB_REGEX, "rubygems/core_ext/kernel_require.rb", "<internal:", %r{/lib/ruby/[^/]+/bundled_gems\.rb})
 
-    if RSpec::Support::RubyFeatures.caller_locations_supported?
-      # This supports args because it's more efficient when the caller specifies
-      # these. It allows us to skip frames the caller knows are part of RSpec,
-      # and to decrease the increment size if the caller is confident the line will
-      # be found in a small number of stack frames from `skip_frames`.
-      #
-      # Note that there is a risk to passing a `skip_frames` value that is too high:
-      # If it skipped the first non-rspec line, then this method would return the
-      # 2nd or 3rd (or whatever) non-rspec line. Thus, you generally shouldn't pass
-      # values for these parameters, particularly since most places that use this are
-      # not hot spots (generally it gets used for deprecation warnings). However,
-      # if you do have a hot spot that calls this, passing `skip_frames` can make
-      # a significant difference. Just make sure that that particular use is tested
-      # so that if the provided `skip_frames` changes to no longer be accurate in
-      # such a way that would return the wrong stack frame, a test will fail to tell you.
-      #
-      # See benchmarks/skip_frames_for_caller_filter.rb for measurements.
-      def self.first_non_rspec_line(skip_frames=3, increment=5)
-        # Why a default `skip_frames` of 3?
-        # By the time `caller_locations` is called below, the first 3 frames are:
-        #   lib/rspec/support/caller_filter.rb:63:in `block in first_non_rspec_line'
-        #   lib/rspec/support/caller_filter.rb:62:in `loop'
-        #   lib/rspec/support/caller_filter.rb:62:in `first_non_rspec_line'
+    # This supports args because it's more efficient when the caller specifies
+    # these. It allows us to skip frames the caller knows are part of RSpec,
+    # and to decrease the increment size if the caller is confident the line will
+    # be found in a small number of stack frames from `skip_frames`.
+    #
+    # Note that there is a risk to passing a `skip_frames` value that is too high:
+    # If it skipped the first non-rspec line, then this method would return the
+    # 2nd or 3rd (or whatever) non-rspec line. Thus, you generally shouldn't pass
+    # values for these parameters, particularly since most places that use this are
+    # not hot spots (generally it gets used for deprecation warnings). However,
+    # if you do have a hot spot that calls this, passing `skip_frames` can make
+    # a significant difference. Just make sure that that particular use is tested
+    # so that if the provided `skip_frames` changes to no longer be accurate in
+    # such a way that would return the wrong stack frame, a test will fail to tell you.
+    #
+    # See benchmarks/skip_frames_for_caller_filter.rb for measurements.
+    def self.first_non_rspec_line(skip_frames=3, increment=5)
+      # Why a default `skip_frames` of 3?
+      # By the time `caller_locations` is called below, the first 3 frames are:
+      #   lib/rspec/support/caller_filter.rb:63:in `block in first_non_rspec_line'
+      #   lib/rspec/support/caller_filter.rb:62:in `loop'
+      #   lib/rspec/support/caller_filter.rb:62:in `first_non_rspec_line'
 
-        # `caller` is an expensive method that scales linearly with the size of
-        # the stack. The performance hit for fetching it in chunks is small,
-        # and since the target line is probably near the top of the stack, the
-        # overall improvement of a chunked search like this is significant.
-        #
-        # See benchmarks/caller.rb for measurements.
+      # `caller` is an expensive method that scales linearly with the size of
+      # the stack. The performance hit for fetching it in chunks is small,
+      # and since the target line is probably near the top of the stack, the
+      # overall improvement of a chunked search like this is significant.
+      #
 
-        # The default increment of 5 for this method are mostly arbitrary, but
-        # is chosen to give good performance on the common case of creating a double.
+      # The default increment of 5 for this method are mostly arbitrary, but
+      # is chosen to give good performance on the common case of creating a double.
 
-        loop do
-          stack = caller_locations(skip_frames, increment)
-          raise "No non-lib lines in stack" unless stack
+      loop do
+        stack = caller_locations(skip_frames, increment)
+        raise "No non-lib lines in stack" unless stack
 
-          line = stack.find { |l| l.path !~ IGNORE_REGEX }
-          return line.to_s if line
+        line = stack.find { |l| l.path !~ IGNORE_REGEX }
+        return line.to_s if line
 
-          skip_frames += increment
-          increment *= 2 # The choice of two here is arbitrary.
-        end
-      end
-    else
-      # Earlier rubies do not support the two argument form of `caller`. This
-      # fallback is logically the same, but slower.
-      def self.first_non_rspec_line(*)
-        caller.find { |line| line !~ IGNORE_REGEX }
+        skip_frames += increment
+        increment *= 2 # The choice of two here is arbitrary.
       end
     end
   end

data/lib/rspec/support/differ.rb

@@ -17,6 +17,8 @@ module RSpec
             if any_multiline_strings?(actual, expected)
               diff = diff_as_string(coerce_to_string(actual), coerce_to_string(expected))
             end
+          elsif all_hashes?(actual, expected)
+            diff = diff_hashes_as_object(actual, expected)
           elsif no_procs?(actual, expected) && no_numbers?(actual, expected)
             diff = diff_as_object(actual, expected)
           end
@@ -55,6 +57,25 @@ module RSpec
       end
       # rubocop:enable Metrics/MethodLength
 
+      if defined?(RSpec::Mocks::ArgumentMatchers::AnyArgMatcher)
+        def diff_hashes_as_object(actual, expected)
+          actual_to_diff =
+            actual.keys.reduce({}) do |hash, key|
+              if RSpec::Mocks::ArgumentMatchers::AnyArgMatcher === expected[key]
+                hash[key] = expected[key]
+              else
+                hash[key] = actual[key]
+              end
+              hash
+            end
+          diff_as_object(actual_to_diff, expected)
+        end
+      else
+        def diff_hashes_as_object(actual, expected)
+          diff_as_object(actual, expected)
+        end
+      end
+
       def diff_as_object(actual, expected)
         actual_as_string = object_to_string(actual)
         expected_as_string = object_to_string(expected)
@@ -76,6 +97,10 @@ module RSpec
         safely_flatten(args).none? { |a| Proc === a }
       end
 
+      def all_hashes?(actual, expected)
+        (Hash === actual) && (Hash === expected)
+      end
+
       def all_strings?(*args)
         safely_flatten(args).all? { |a| String === a }
       end
@@ -103,14 +128,8 @@ module RSpec
         end
       end
 
-      if String.method_defined?(:encoding)
-        def multiline?(string)
-          string.include?("\n".encode(string.encoding))
-        end
-      else
-        def multiline?(string)
-          string.include?("\n")
-        end
+      def multiline?(string)
+        string.include?("\n".encode(string.encoding))
       end
 
       def build_hunks(actual, expected)
@@ -201,13 +220,13 @@ module RSpec
       end
 
       def handle_encoding_errors(actual, expected)
-        if actual.source_encoding != expected.source_encoding
-          "Could not produce a diff because the encoding of the actual string " \
-          "(#{actual.source_encoding}) differs from the encoding of the expected " \
-          "string (#{expected.source_encoding})"
-        else
+        if actual.source_encoding == expected.source_encoding
           "Could not produce a diff because of the encoding of the string " \
-          "(#{expected.source_encoding})"
+            "(#{expected.source_encoding})"
+        else
+          "Could not produce a diff because the encoding of the actual string " \
+            "(#{actual.source_encoding}) differs from the encoding of the expected " \
+            "string (#{expected.source_encoding})"
         end
       end
     end

data/lib/rspec/support/directory_maker.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-RSpec::Support.require_rspec_support 'ruby_features'
-
 module RSpec
   module Support
     # @api private

data/lib/rspec/support/encoded_string.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+RSpec::Support.require_rspec_support "ruby_features"
 module RSpec
   module Support
     # @private
@@ -13,6 +14,10 @@ module RSpec
       #   ?      ("\x3F")
       REPLACE = "?"
 
+      def self.pick_encoding(source_a, source_b)
+        Encoding.compatible?(source_a, source_b) || Encoding.default_external
+      end
+
       def initialize(string, encoding=nil)
         @encoding = encoding
         @source_encoding = detect_source_encoding(string)
@@ -48,12 +53,50 @@ module RSpec
       end
       alias :to_str :to_s
 
-      if String.method_defined?(:encoding)
-
-        private
-
-        # Encoding Exceptions:
-        #
+      private
+
+      # Encoding Exceptions:
+      #
+      # Raised by Encoding and String methods:
+      #   Encoding::UndefinedConversionError:
+      #     when a transcoding operation fails
+      #     if the String contains characters invalid for the target encoding
+      #     e.g. "\x80".encode('UTF-8','ASCII-8BIT')
+      #     vs "\x80".encode('UTF-8','ASCII-8BIT', undef: :replace, replace: '<undef>')
+      #     # => '<undef>'
+      #   Encoding::CompatibilityError
+      #     when Encoding.compatible?(str1, str2) is nil
+      #     e.g. utf_16le_emoji_string.split("\n")
+      #     e.g. valid_unicode_string.encode(utf8_encoding) << ascii_string
+      #   Encoding::InvalidByteSequenceError:
+      #     when the string being transcoded contains a byte invalid for
+      #     either the source or target encoding
+      #     e.g. "\x80".encode('UTF-8','US-ASCII')
+      #     vs "\x80".encode('UTF-8','US-ASCII', invalid: :replace, replace: '<byte>')
+      #     # => '<byte>'
+      #   ArgumentError
+      #     when operating on a string with invalid bytes
+      #     e.g."\x80".split("\n")
+      #   TypeError
+      #     when a symbol is passed as an encoding
+      #     Encoding.find(:"UTF-8")
+      #     when calling force_encoding on an object
+      #     that doesn't respond to #to_str
+      #
+      # Raised by transcoding methods:
+      #   Encoding::ConverterNotFoundError:
+      #     when a named encoding does not correspond with a known converter
+      #     e.g. 'abc'.force_encoding('UTF-8').encode('foo')
+      #     or a converter path cannot be found
+      #     e.g. "\x80".force_encoding('ASCII-8BIT').encode('Emacs-Mule')
+      #
+      # Raised by byte <-> char conversions
+      #   RangeError: out of char range
+      #     e.g. the UTF-16LE emoji: 128169.chr
+      def matching_encoding(string)
+        string = remove_invalid_bytes(string)
+        string.encode(@encoding)
+      rescue Encoding::UndefinedConversionError, Encoding::InvalidByteSequenceError
         # Raised by Encoding and String methods:
         #   Encoding::UndefinedConversionError:
         #     when a transcoding operation fails
@@ -80,83 +123,23 @@ module RSpec
         #     when calling force_encoding on an object
         #     that doesn't respond to #to_str
         #
-        # Raised by transcoding methods:
-        #   Encoding::ConverterNotFoundError:
-        #     when a named encoding does not correspond with a known converter
-        #     e.g. 'abc'.force_encoding('UTF-8').encode('foo')
-        #     or a converter path cannot be found
-        #     e.g. "\x80".force_encoding('ASCII-8BIT').encode('Emacs-Mule')
+        # For example, given:
+        #   "\x80".force_encoding("Emacs-Mule").encode(:invalid => :replace).bytes.to_a
         #
-        # Raised by byte <-> char conversions
-        #   RangeError: out of char range
-        #     e.g. the UTF-16LE emoji: 128169.chr
-        def matching_encoding(string)
-          string = remove_invalid_bytes(string)
-          string.encode(@encoding)
-        rescue Encoding::UndefinedConversionError, Encoding::InvalidByteSequenceError
-          # Originally defined as a constant to avoid unneeded allocations, this hash must
-          # be defined inline (without {}) to avoid warnings on Ruby 2.7
-          #
-          # In MRI 2.1 'invalid: :replace' changed to also replace an invalid byte sequence
-          # see https://github.com/ruby/ruby/blob/v2_1_0/NEWS#L176
-          # https://www.ruby-forum.com/topic/6861247
-          # https://twitter.com/nalsh/status/553413844685438976
-          #
-          # For example, given:
-          #   "\x80".force_encoding("Emacs-Mule").encode(:invalid => :replace).bytes.to_a
-          #
-          # On MRI 2.1 or above: 63  # '?'
-          # else               : 128 # "\x80"
-          #
-          string.encode(@encoding, :invalid => :replace, :undef => :replace, :replace => REPLACE)
-        rescue Encoding::ConverterNotFoundError
-          # Originally defined as a constant to avoid unneeded allocations, this hash must
-          # be defined inline (without {}) to avoid warnings on Ruby 2.7
-          string.dup.force_encoding(@encoding).encode(:invalid => :replace, :replace => REPLACE)
-        end
-
-        # Prevents raising ArgumentError
-        if String.method_defined?(:scrub)
-          # https://github.com/ruby/ruby/blob/eeb05e8c11/doc/NEWS-2.1.0#L120-L123
-          # https://github.com/ruby/ruby/blob/v2_1_0/string.c#L8242
-          # https://github.com/hsbt/string-scrub
-          # https://github.com/rubinius/rubinius/blob/v2.5.2/kernel/common/string.rb#L1913-L1972
-          def remove_invalid_bytes(string)
-            string.scrub(REPLACE)
-          end
-        else
-          # http://stackoverflow.com/a/8711118/879854
-          # Loop over chars in a string replacing chars
-          # with invalid encoding, which is a pretty good proxy
-          # for the invalid byte sequence that causes an ArgumentError
-          def remove_invalid_bytes(string)
-            string.chars.map do |char|
-              char.valid_encoding? ? char : REPLACE
-            end.join
-          end
-        end
-
-        def detect_source_encoding(string)
-          string.encoding
-        end
-
-        def self.pick_encoding(source_a, source_b)
-          Encoding.compatible?(source_a, source_b) || Encoding.default_external
-        end
-      else
-
-        def self.pick_encoding(_source_a, _source_b)
-        end
-
-        private
+        # On MRI 2.1 or above: 63  # '?'
+        # else               : 128 # "\x80"
+        #
+        string.encode(@encoding, :invalid => :replace, :undef => :replace, :replace => REPLACE)
+      rescue Encoding::ConverterNotFoundError
+        string.dup.force_encoding(@encoding).encode(:invalid => :replace, :replace => REPLACE)
+      end
 
-        def matching_encoding(string)
-          string
-        end
+      def remove_invalid_bytes(string)
+        string.scrub(REPLACE)
+      end
 
-        def detect_source_encoding(_string)
-          US_ASCII
-        end
+      def detect_source_encoding(string)
+        string.encoding
       end
     end
   end

data/lib/rspec/support/fuzzy_matcher.rb

@@ -22,8 +22,7 @@ module RSpec
         begin
           expected === actual
         rescue ArgumentError
-          # Some objects, like 0-arg lambdas on 1.9+, raise
-          # ArgumentError for `expected === actual`.
+          # Some objects, like 0-arg lambdas, raise ArgumentError when compared with ===.
           false
         end
       end