rspec-mocks 3.13.7 → 4.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df5f0cc9f39c7b8143bdf25e4b257a2ece85d0ce3b132d4a37b3cc569d6ef94e
-  data.tar.gz: 30ae99bd407c4e45996ddfa971ee376e8f3521a026ce4fe6af0e4cb8ec452f60
+  metadata.gz: e4915179fc75a2e044c363714cd6fa9fd53793a4fb8259b547434a0c9ef30863
+  data.tar.gz: 462d98b713cd2631b9c14a5e15badde5c8bc73478795def839cc903a12d8685b
 SHA512:
-  metadata.gz: cd2282442579d7e2a393ed94cd23161d671f9135996db2553f4714c8727ef7f2bf7fdd4be4cf4d6db44328a0434c71474633fbe108fb3b0c715d2d028749563c
-  data.tar.gz: 7cc97b1522fd69ae712a23c21953e165db5790ccc6dbdab3f06b66384bd485af31f4dfb7553fb9f2ee0ac877112ecf4d8194a8f3079a352f994a38a519e5508c
+  metadata.gz: 17bf39282a033c69d455ea688c166432b103a846aa72b24dec91ee1e714f0a12112f5a04ce2ed2fd69b31a3a7069754f19fc6e278917324aaa5146079b00e8ca
+  data.tar.gz: 47cf0ca37ffbde593befd106ade7f6c0fbf8d638f1d20c1d63d31bc3b26f1bb3fb08f780838106a9170dfc7b7629364adf99117b89cef0e60ed9761c5e8860d6

data/Changelog.md

@@ -1,5 +1,19 @@
 ### Development
-[Full Changelog](https://github.com/rspec/rspec/compare/rspec-mocks-v3.13.7...3-13-maintenance)
+[Full Changelog](https://github.com/rspec/rspec/compare/rspec-mocks-v3.13.7...main)
+
+# 4.0.0.beta1 / 2026-02-18
+
+Breaking Changes:
+
+* Ruby < 3.0 is no longer supported. (Phil Pirozhkov, Jon Rowe, rspec/rspec-mocks#1349, rspec/rspec#258)
+* Remove monkey-patching `should_receive`/`stub` syntax. (Phil Pirozhkov, rspec/rspec-mocks#1365)
+* Remove the deprecated `RSpec::Mocks::CannotSupportArgMutationsError`.
+  (Phil Pirozhkov, rspec/rspec-mocks#1400)
+* Change the default setting for `RSpec::Mocks::Configuration#verify_partial_doubles`
+  to `true`. (Phil Pirozhkov, rspec/rspec-mocks#1409)
+* Remove deprecated `allow_message_expectations_on_nil` example method.
+  (Phil Pirozhkov, rspec/rspec-mocks#1410)
+* Fix stubbing of prepended-only methods. (Lin Jen-Shin, rspec/rspec-mocks#1218)
 
 ### 3.13.7 / 2025-10-31
 [Full Changelog](https://github.com/rspec/rspec/compare/rspec-mocks-v3.13.6...rspec-mocks-v3.13.7)

data/LICENSE.md

@@ -1,6 +1,7 @@
 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

data/README.md

@@ -1,35 +1,11 @@
-# RSpec Mocks [![Build Status](https://github.com/rspec/rspec-mocks/workflows/RSpec%20CI/badge.svg)](https://github.com/rspec/rspec-mocks/actions) [![Code Climate](https://codeclimate.com/github/rspec/rspec-mocks.svg)](https://codeclimate.com/github/rspec/rspec-mocks)
-rspec-mocks is a test-double framework for rspec with support for method stubs,
-fakes, and message expectations on generated test-doubles and real objects
-alike.
+# RSpec::Mocks
 
-## Install
+This is the detailed readme for `rspec-mocks`, see also:
 
-    gem install rspec       # for rspec-core, rspec-expectations, rspec-mocks
-    gem install rspec-mocks # for rspec-mocks only
-
-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.
-
-For information about contributing to RSpec, please refer to the following markdown files:
-* [Build details](BUILD_DETAIL.md)
-* [Code of Conduct](CODE_OF_CONDUCT.md)
-* [Detailed contributing guide](CONTRIBUTING.md)
-* [Development setup guide](DEVELOPMENT.md)
+* [The combined readme](../README.md)
+* [rspec-core](../rspec-core/README.md)
+* [rspec-expectations](../rspec-expectations/README.md)
+* [rspec-support](../rspec-support/README.md)
 
 ## Test Doubles
 
@@ -53,7 +29,7 @@ book = instance_double("Book", :pages => 250)
 Verifying doubles have some clever tricks to enable you to both test in
 isolation without your dependencies loaded while still being able to validate
 them against real objects. More detail is available in [their
-documentation](https://github.com/rspec/rspec-mocks/blob/main/features/verifying_doubles).
+documentation](https://github.com/rspec/rspec/tree/main/rspec-mocks/features/verifying_doubles#readme).
 
 Verifying doubles can also accept custom identifiers, just like double(), e.g.:
 
@@ -405,7 +381,7 @@ your code.
 ## Stubbing and Hiding Constants
 
 See the [mutating constants
-README](https://github.com/rspec/rspec-mocks/blob/main/features/mutating_constants/README.md)
+README](https://github.com/rspec/rspec/tree/main/rspec-mocks/features/mutating_constants)
 for info on this feature.
 
 ## Use `before(:example)`, not `before(:context)`
@@ -456,10 +432,3 @@ you are interested in learning more, here is some recommended reading:
 * Test Double: http://www.martinfowler.com/bliki/TestDouble.html
 * Test Double Patterns: http://xunitpatterns.com/Test%20Double%20Patterns.html
 * Mocks aren't stubs: http://www.martinfowler.com/articles/mocksArentStubs.html
-
-## Also see
-
-* [https://github.com/rspec/rspec](https://github.com/rspec/rspec)
-* [https://github.com/rspec/rspec-core](https://github.com/rspec/rspec-core)
-* [https://github.com/rspec/rspec-expectations](https://github.com/rspec/rspec-expectations)
-* [https://github.com/rspec/rspec-rails](https://github.com/rspec/rspec-rails)

data/lib/rspec/mocks/any_instance/expectation_chain.rb

@@ -25,7 +25,7 @@ module RSpec
         def create_message_expectation_on(instance)
           proxy = ::RSpec::Mocks.space.proxy_for(instance)
           method_name, opts = @expectation_args
-          opts = (opts || {}).merge(:expected_form => IGNORED_BACKTRACE_LINE)
+          opts ||= {}
 
           me = proxy.add_message_expectation(method_name, opts, &@expectation_block)
           if RSpec::Mocks.configuration.yield_receiver_to_any_instance_implementation_blocks?

data/lib/rspec/mocks/any_instance/proxy.rb

@@ -86,7 +86,7 @@ module RSpec
       unless defined?(BasicObject)
         class BasicObject
           # Remove all methods except those expected to be defined on BasicObject
-          (instance_methods.map(&:to_sym) - [:__send__, :"!", :instance_eval, :==, :instance_exec, :"!=", :equal?, :__id__, :__binding__, :object_id]).each do |method|
+          (instance_methods.map(&:to_sym) - [:__send__, :!, :instance_eval, :==, :instance_exec, :!=, :equal?, :__id__, :__binding__, :object_id]).each do |method|
             undef_method method
           end
         end
@@ -105,14 +105,8 @@ module RSpec
           @targets = targets
         end
 
-        if ::RUBY_VERSION.to_f > 1.8
-          def respond_to_missing?(method_name, include_private=false)
-            super || @targets.first.respond_to?(method_name, include_private)
-          end
-        else
-          def respond_to?(method_name, include_private=false)
-            super || @targets.first.respond_to?(method_name, include_private)
-          end
+        def respond_to_missing?(method_name, include_private=false)
+          super || @targets.first.respond_to?(method_name, include_private)
         end
 
         def method_missing(*args, &block)

data/lib/rspec/mocks/any_instance/recorder.rb

@@ -157,7 +157,7 @@ module RSpec
       private
 
         def ancestor_is_an_observer?(ancestor, method_name)
-          return if ancestor == @klass
+          return false if ancestor == @klass
 
           ::RSpec::Mocks.space.
             any_instance_recorder_for(ancestor).already_observing?(method_name)
@@ -202,24 +202,17 @@ module RSpec
             remove_method method_name
 
             # A @klass can have methods implemented (see Method#owner) in @klass
-            # or inherited from a superclass. In ruby 2.2 and earlier, we can copy
-            # a method regardless of the 'owner' and restore it to @klass after
-            # because a call to 'super' from @klass's copied method would end up
-            # calling the original class's superclass's method.
+            # or inherited from a superclass.
             #
-            # With the commit below, available starting in 2.3.0, ruby changed
-            # this behavior and a call to 'super' from the method copied to @klass
+            # A call to 'super' from the method copied to @klass
             # will call @klass's superclass method, which is the original
             # implementer of this method!  This leads to very strange errors
             # if @klass's copied method calls 'super', since it would end up
             # calling itself, the original method implemented in @klass's
             # superclass.
             #
-            # For ruby 2.3 and above, we need to only restore methods that
-            # @klass originally owned.
-            #
-            # https://github.com/ruby/ruby/commit/c8854d2ca4be9ee6946e6d17b0e17d9ef130ee81
-            if RUBY_VERSION < "2.3" || backed_up_method_owner[method_name.to_sym] == self
+            # We need to only restore methods that @klass originally owned.
+            if backed_up_method_owner[method_name.to_sym] == self
               alias_method method_name, alias_method_name
             end
             remove_method alias_method_name
@@ -260,7 +253,8 @@ module RSpec
           backup_method!(method_name)
           recorder = self
           method_was_private = @klass.private_method_defined?(method_name)
-          @klass.__send__(:define_method, method_name) do |*args, &blk|
+
+          @klass.define_method(method_name) do |*args, &blk|
             recorder.playback!(self, method_name)
             __send__(method_name, *args, &blk)
           end
@@ -271,7 +265,7 @@ module RSpec
         def mark_invoked!(method_name)
           backup_method!(method_name)
           recorder = self
-          @klass.__send__(:define_method, method_name) do |*_args, &_blk|
+          @klass.define_method(method_name) do |*_args, &_blk|
             invoked_instance = recorder.instance_that_received(method_name)
             inspect = "#<#{self.class}:#{object_id} #{instance_variables.map { |name| "#{name}=#{instance_variable_get name}" }.join(', ')}>"
             AnyInstance.error_generator.raise_message_already_received_by_other_instance_error(
@@ -280,18 +274,12 @@ module RSpec
           end
         end
 
-        if Support::RubyFeatures.module_prepends_supported?
-          def allow_no_prepended_module_definition_of(method_name)
-            prepended_modules = RSpec::Mocks::Proxy.prepended_modules_of(@klass)
-            problem_mod = prepended_modules.find { |mod| mod.method_defined?(method_name) }
-            return unless problem_mod
+        def allow_no_prepended_module_definition_of(method_name)
+          prepended_modules = RSpec::Mocks::Proxy.prepended_modules_of(@klass)
+          problem_mod = prepended_modules.find { |mod| mod.method_defined?(method_name) }
+          return unless problem_mod
 
-            AnyInstance.error_generator.raise_not_supported_with_prepend_error(method_name, problem_mod)
-          end
-        else
-          def allow_no_prepended_module_definition_of(_method_name)
-            # nothing to do; prepends aren't supported on this version of ruby
-          end
+          AnyInstance.error_generator.raise_not_supported_with_prepend_error(method_name, problem_mod)
         end
       end
     end

data/lib/rspec/mocks/any_instance/stub_chain.rb

@@ -13,7 +13,7 @@ module RSpec
         def create_message_expectation_on(instance)
           proxy = ::RSpec::Mocks.space.proxy_for(instance)
           method_name, opts = @expectation_args
-          opts = (opts || {}).merge(:expected_form => IGNORED_BACKTRACE_LINE)
+          opts ||= {}
 
           stub = proxy.add_stub(method_name, opts, &@expectation_block)
           @recorder.stubs[stub.message] << stub

data/lib/rspec/mocks/argument_list_matcher.rb

@@ -60,14 +60,12 @@ module RSpec
 
         return false if expected_args.size != actual_args.size
 
-        if RUBY_VERSION >= "3"
-          # If the expectation was set with keywords, while the actual method was called with a positional hash argument, they don't match.
-          # If the expectation was set without keywords, e.g., with({a: 1}), then it fine to call it with either foo(a: 1) or foo({a: 1}).
-          # This corresponds to Ruby semantics, as if the method was def foo(options).
-          if Hash === expected_args.last && Hash === actual_args.last
-            if !Hash.ruby2_keywords_hash?(actual_args.last) && Hash.ruby2_keywords_hash?(expected_args.last)
-              return false
-            end
+        # If the expectation was set with keywords, while the actual method was called with a positional hash argument, they don't match.
+        # If the expectation was set without keywords, e.g., with({a: 1}), then it fine to call it with either foo(a: 1) or foo({a: 1}).
+        # This corresponds to Ruby semantics, as if the method was def foo(options).
+        if Hash === expected_args.last && Hash === actual_args.last
+          if !Hash.ruby2_keywords_hash?(actual_args.last) && Hash.ruby2_keywords_hash?(expected_args.last)
+            return false
           end
         end
 
@@ -100,11 +98,11 @@ module RSpec
       def ensure_expected_args_valid!
         if expected_args.count { |a| ArgumentMatchers::AnyArgsMatcher::INSTANCE == a } > 1
           raise ArgumentError, "`any_args` can only be passed to " \
-                "`with` once but you have passed it multiple times."
+                               "`with` once but you have passed it multiple times."
         elsif expected_args.count > 1 && expected_args.any? { |a| ArgumentMatchers::NoArgsMatcher::INSTANCE == a }
           raise ArgumentError, "`no_args` can only be passed as a " \
-                "singleton argument to `with` (i.e. `with(no_args)`), " \
-                "but you have passed additional arguments."
+                               "singleton argument to `with` (i.e. `with(no_args)`), " \
+                               "but you have passed additional arguments."
         end
       end
 

data/lib/rspec/mocks/configuration.rb

@@ -7,7 +7,7 @@ module RSpec
         @yield_receiver_to_any_instance_implementation_blocks = true
         @verify_doubled_constant_names = false
         @transfer_nested_constants = false
-        @verify_partial_doubles = false
+        @verify_partial_doubles = true
         @temporarily_suppress_partial_double_verification = false
         @color = false
       end
@@ -45,69 +45,6 @@ module RSpec
       #   end
       attr_writer :yield_receiver_to_any_instance_implementation_blocks
 
-      # Adds `stub` and `should_receive` to the given
-      # modules or classes. This is usually only necessary
-      # if you application uses some proxy classes that
-      # "strip themselves down" to a bare minimum set of
-      # methods and remove `stub` and `should_receive` in
-      # the process.
-      #
-      # @example
-      #   RSpec.configure do |rspec|
-      #     rspec.mock_with :rspec do |mocks|
-      #       mocks.add_stub_and_should_receive_to Delegator
-      #     end
-      #   end
-      #
-      def add_stub_and_should_receive_to(*modules)
-        modules.each do |mod|
-          Syntax.enable_should(mod)
-        end
-      end
-
-      # Provides the ability to set either `expect`,
-      # `should` or both syntaxes. RSpec uses `expect`
-      # syntax by default. This is needed if you want to
-      # explicitly enable `should` syntax and/or explicitly
-      # disable `expect` syntax.
-      #
-      # @example
-      #   RSpec.configure do |rspec|
-      #     rspec.mock_with :rspec do |mocks|
-      #       mocks.syntax = [:expect, :should]
-      #     end
-      #  end
-      #
-      def syntax=(*values)
-        syntaxes = values.flatten
-        if syntaxes.include?(:expect)
-          Syntax.enable_expect
-        else
-          Syntax.disable_expect
-        end
-
-        if syntaxes.include?(:should)
-          Syntax.enable_should
-        else
-          Syntax.disable_should
-        end
-      end
-
-      # Returns an array with a list of syntaxes
-      # that are enabled.
-      #
-      # @example
-      #   unless RSpec::Mocks.configuration.syntax.include?(:expect)
-      #     raise "this RSpec extension gem requires the rspec-mocks `:expect` syntax"
-      #   end
-      #
-      def syntax
-        syntaxes = []
-        syntaxes << :should  if Syntax.should_enabled?
-        syntaxes << :expect if Syntax.expect_enabled?
-        syntaxes
-      end
-
       def verify_doubled_constant_names?
         !!@verify_doubled_constant_names
       end
@@ -192,13 +129,6 @@ module RSpec
           RSpec::Mocks::MarshalExtension.unpatch!
         end
       end
-
-      # @api private
-      # Resets the configured syntax to the default.
-      def reset_syntaxes_to_default
-        self.syntax = [:should, :expect]
-        RSpec::Mocks::Syntax.warn_about_should!
-      end
     end
 
     # Mocks specific configuration, as distinct from `RSpec.configuration`
@@ -206,7 +136,5 @@ module RSpec
     def self.configuration
       @configuration ||= Configuration.new
     end
-
-    configuration.reset_syntaxes_to_default
   end
 end

data/lib/rspec/mocks/error_generator.rb

@@ -1,4 +1,5 @@
 RSpec::Support.require_rspec_support "object_formatter"
+RSpec::Support.require_rspec_support 'ruby_features'
 
 module RSpec
   module Mocks
@@ -17,14 +18,6 @@ module RSpec
     # invoked.
     MockExpectationAlreadyInvokedError = Class.new(Exception)
 
-    # Raised for situations that RSpec cannot support due to mutations made
-    # externally on arguments that RSpec is holding onto to use for later
-    # comparisons.
-    #
-    # @deprecated We no longer raise this error but the constant remains until
-    #   RSpec 4 for SemVer reasons.
-    CannotSupportArgMutationsError = Class.new(StandardError)
-
     # @private
     UnsupportedMatcherError  = Class.new(StandardError)
     # @private
@@ -202,8 +195,8 @@ module RSpec
       # @private
       def raise_already_invoked_error(message, calling_customization)
         error_message = "The message expectation for #{intro}.#{message} has already been invoked " \
-          "and cannot be modified further (e.g. using `#{calling_customization}`). All message expectation " \
-          "customizations must be applied before it is used for the first time."
+                        "and cannot be modified further (e.g. using `#{calling_customization}`). All message expectation " \
+                        "customizations must be applied before it is used for the first time."
 
         notify MockExpectationAlreadyInvokedError.new(error_message)
       end
@@ -214,8 +207,8 @@ module RSpec
 
       def expectation_on_nil_message(method_name)
         "An expectation of `:#{method_name}` was set on `nil`. " \
-        "To allow expectations on `nil` and suppress this message, set `RSpec::Mocks.configuration.allow_message_expectations_on_nil` to `true`. " \
-        "To disallow expectations on `nil`, set `RSpec::Mocks.configuration.allow_message_expectations_on_nil` to `false`"
+          "To allow expectations on `nil` and suppress this message, set `RSpec::Mocks.configuration.allow_message_expectations_on_nil` to `true`. " \
+          "To disallow expectations on `nil`, set `RSpec::Mocks.configuration.allow_message_expectations_on_nil` to `false`"
       end
 
       # @private
@@ -269,19 +262,17 @@ module RSpec
         expected_args = format_args(expectation.expected_args)
         actual_args = format_received_args(args_for_multiple_calls)
 
-        if RSpec::Support::RubyFeatures.distincts_kw_args_from_positional_hash?
-          expected_hash = expectation.expected_args.last
-          actual_hash = args_for_multiple_calls.last.last
-          if Hash === expected_hash && Hash === actual_hash &&
-            (Hash.ruby2_keywords_hash?(expected_hash) != Hash.ruby2_keywords_hash?(actual_hash))
+        expected_hash = expectation.expected_args.last
+        actual_hash = args_for_multiple_calls.last.last
+        if Hash === expected_hash && Hash === actual_hash &&
+          (Hash.ruby2_keywords_hash?(expected_hash) != Hash.ruby2_keywords_hash?(actual_hash))
 
-            actual_description = Hash.ruby2_keywords_hash?(actual_hash) ? " (keyword arguments)" : " (options hash)"
-            expected_description = Hash.ruby2_keywords_hash?(expected_hash) ? " (keyword arguments)" : " (options hash)"
+          actual_description = Hash.ruby2_keywords_hash?(actual_hash) ? " (keyword arguments)" : " (options hash)"
+          expected_description = Hash.ruby2_keywords_hash?(expected_hash) ? " (keyword arguments)" : " (options hash)"
 
-            if actual_description != expected_description
-              actual_args += actual_description
-              expected_args += expected_description
-            end
+          if actual_description != expected_description
+            actual_args += actual_description
+            expected_args += expected_description
           end
         end
 

data/lib/rspec/mocks/example_methods.rb

@@ -192,16 +192,6 @@ module RSpec
         class_double(*args).as_null_object
       end
 
-      # Disables warning messages about expectations being set on nil.
-      #
-      # By default warning messages are issued when expectations are set on
-      # nil.  This is to prevent false-positives and to catch potential bugs
-      # early on.
-      # @deprecated Use {RSpec::Mocks::Configuration#allow_message_expectations_on_nil} instead.
-      def allow_message_expectations_on_nil
-        RSpec::Mocks.space.proxy_for(nil).warn_about_expectations = false
-      end
-
       # Stubs the named constant with the given value.
       # Like method stubs, the constant will be restored
       # to its original value (or lack of one, if it was
@@ -303,8 +293,7 @@ module RSpec
       #
       # @note This method is usually provided by rspec-expectations. However,
       #   if you use rspec-mocks without rspec-expectations, there's a definition
-      #   of it that is made available here. If you disable the `:expect` syntax
-      #   this method will be undefined.
+      #   of it that is made available here.
 
       # @method allow
       # Used to wrap an object in preparation for stubbing a method
@@ -312,40 +301,42 @@ module RSpec
       #
       # @example
       #   allow(dbl).to receive(:foo).with(5).and_return(:return_value)
-      #
-      # @note If you disable the `:expect` syntax this method will be undefined.
+      def allow(target)
+        AllowanceTarget.new(target)
+      end
 
-      # @method expect_any_instance_of
       # Used to wrap a class in preparation for setting a mock expectation
       # on instances of it.
       #
       # @example
       #   expect_any_instance_of(MyClass).to receive(:foo)
       #
-      # @note If you disable the `:expect` syntax this method will be undefined.
+      def expect_any_instance_of(klass)
+        AnyInstanceExpectationTarget.new(klass)
+      end
 
-      # @method allow_any_instance_of
       # Used to wrap a class in preparation for stubbing a method
       # on instances of it.
       #
       # @example
       #   allow_any_instance_of(MyClass).to receive(:foo)
       #
-      # @note This is only available when you have enabled the `expect` syntax.
+      def allow_any_instance_of(klass)
+        AnyInstanceAllowanceTarget.new(klass)
+      end
 
-      # @method receive
       # Used to specify a message that you expect or allow an object
-      # to receive. The object returned by `receive` supports the same
-      # fluent interface that `should_receive` and `stub` have always
-      # supported, allowing you to constrain the arguments or number of
+      # to receive. The object returned by `receive` supports a fluent
+      # interface, allowing you to constrain the arguments or number of
       # times, and configure how the object should respond to the message.
       #
       # @example
       #   expect(obj).to receive(:hello).with("world").exactly(3).times
       #
-      # @note If you disable the `:expect` syntax this method will be undefined.
+      def receive(method_name, &block)
+        Matchers::Receive.new(method_name, block)
+      end
 
-      # @method receive_messages
       # Shorthand syntax used to setup message(s), and their return value(s),
       # that you expect or allow an object to receive. The method takes a hash
       # of messages and their respective return values. Unlike with `receive`,
@@ -356,9 +347,12 @@ module RSpec
       #   allow(obj).to receive_messages(:speak => "Hello World")
       #   allow(obj).to receive_messages(:speak => "Hello", :meow => "Meow")
       #
-      # @note If you disable the `:expect` syntax this method will be undefined.
+      def receive_messages(message_return_value_hash, &block)
+        matcher = Matchers::ReceiveMessages.new(message_return_value_hash)
+        matcher.warn_about_block if block
+        matcher
+      end
 
-      # @method receive_message_chain
       # @overload receive_message_chain(method1, method2)
       # @overload receive_message_chain("method1.method2")
       # @overload receive_message_chain(method1, method_to_value_hash)
@@ -386,7 +380,9 @@ module RSpec
       #   # Common use in Rails/ActiveRecord:
       #   allow(Article).to receive_message_chain("recent.published") { [Article.new] }
       #
-      # @note If you disable the `:expect` syntax this method will be undefined.
+      def receive_message_chain(*messages, &block)
+        Matchers::ReceiveMessageChain.new(messages, &block)
+      end
 
       # @private
       def self.included(klass)
@@ -425,9 +421,13 @@ module RSpec
         type.new(*args)
       end
 
-      # This module exists to host the `expect` method for cases where
+      # This module exists to provide the `expect` method for cases where
       # rspec-mocks is used w/o rspec-expectations.
       module ExpectHost
+        # @private
+        def expect(target)
+          ExpectationTarget.new(target)
+        end
       end
     end
   end