opal-rspec 0.6.2 → 0.7.0.rc.1

data/rspec-mocks/lib/rspec/mocks/configuration.rb

@@ -1,157 +0,0 @@
-module RSpec
-  module Mocks
-    # Provides configuration options for rspec-mocks.
-    class Configuration
-      def initialize
-        @yield_receiver_to_any_instance_implementation_blocks = true
-        @verify_doubled_constant_names = false
-        @transfer_nested_constants = false
-        @verify_partial_doubles = false
-      end
-
-      def yield_receiver_to_any_instance_implementation_blocks?
-        @yield_receiver_to_any_instance_implementation_blocks
-      end
-
-      # Sets whether or not RSpec will yield the receiving instance of a
-      # message to blocks that are used for any_instance stub implementations.
-      # When set, the first yielded argument will be the receiving instance.
-      # Defaults to `true`.
-      #
-      # @example
-      #
-      #   RSpec.configure do |rspec|
-      #     rspec.mock_with :rspec do |mocks|
-      #       mocks.yield_receiver_to_any_instance_implementation_blocks = false
-      #     end
-      #   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
-
-      # When this is set to true, an error will be raised when
-      # `instance_double` or `class_double` is given the name of an undefined
-      # constant. You probably only want to set this when running your entire
-      # test suite, with all production code loaded. Setting this for an
-      # isolated unit test will prevent you from being able to isolate it!
-      attr_writer :verify_doubled_constant_names
-
-      def transfer_nested_constants?
-        !!@transfer_nested_constants
-      end
-
-      # Sets the default for the `transfer_nested_constants` option when
-      # stubbing constants.
-      attr_writer :transfer_nested_constants
-
-      # When set to true, partial mocks will be verified the same as object
-      # doubles. Any stubs will have their arguments checked against the original
-      # method, and methods that do not exist cannot be stubbed.
-      def verify_partial_doubles=(val)
-        @verify_partial_doubles = !!val
-      end
-
-      def verify_partial_doubles?
-        @verify_partial_doubles
-      end
-
-      # Monkey-patch `Marshal.dump` to enable dumping of mocked or stubbed
-      # objects. By default this will not work since RSpec mocks works by
-      # adding singleton methods that cannot be serialized. This patch removes
-      # these singleton methods before serialization. Setting to falsey removes
-      # the patch.
-      #
-      # This method is idempotent.
-      def patch_marshal_to_support_partial_doubles=(val)
-        if val
-          RSpec::Mocks::MarshalExtension.patch!
-        else
-          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`
-    # which is core RSpec configuration.
-    def self.configuration
-      @configuration ||= Configuration.new
-    end
-
-    configuration.reset_syntaxes_to_default
-  end
-end

data/rspec-mocks/lib/rspec/mocks/error_generator.rb

@@ -1,253 +0,0 @@
-module RSpec
-  module Mocks
-    # Raised when a message expectation is not satisfied.
-    MockExpectationError = Class.new(Exception)
-
-    # Raised when a test double is used after it has been torn
-    # down (typically at the end of an rspec-core example).
-    ExpiredTestDoubleError = Class.new(MockExpectationError)
-
-    # Raised when doubles or partial doubles are used outside of the per-test lifecycle.
-    OutsideOfExampleError = Class.new(StandardError)
-
-    # @private
-    UnsupportedMatcherError  = Class.new(StandardError)
-    # @private
-    NegationUnsupportedError = Class.new(StandardError)
-    # @private
-    VerifyingDoubleNotDefinedError = Class.new(StandardError)
-
-    # @private
-    class ErrorGenerator
-      attr_writer :opts
-
-      def initialize(target, name)
-        @target = target
-        @name = name
-      end
-
-      # @private
-      def opts
-        @opts ||= {}
-      end
-
-      # @private
-      def raise_unexpected_message_error(message, *args)
-        __raise "#{intro} received unexpected message :#{message}#{arg_message(*args)}"
-      end
-
-      # @private
-      def raise_unexpected_message_args_error(expectation, *args)
-        expected_args = format_args(*expectation.expected_args)
-        actual_args = format_received_args(*args)
-        __raise "#{intro} received #{expectation.message.inspect} with " \
-                "unexpected arguments\n  expected: #{expected_args}\n" \
-                "       got: #{actual_args}"
-      end
-
-      # @private
-      def raise_missing_default_stub_error(expectation, *args)
-        expected_args = format_args(*expectation.expected_args)
-        actual_args = format_received_args(*args)
-        __raise "#{intro} received #{expectation.message.inspect} with " \
-                "unexpected arguments\n  expected: #{expected_args}\n" \
-                "       got: #{actual_args}\n Please stub a default value " \
-                "first if message might be received with other args as well. \n"
-      end
-
-      # @private
-      def raise_similar_message_args_error(expectation, *args_for_multiple_calls)
-        expected_args = format_args(*expectation.expected_args)
-        actual_args = args_for_multiple_calls.map { |a| format_received_args(*a) }.join(", ")
-        __raise "#{intro} received #{expectation.message.inspect} with " \
-                "unexpected arguments\n  expected: #{expected_args}\n" \
-                "       got: #{actual_args}"
-      end
-
-      # rubocop:disable Style/ParameterLists
-      # @private
-      def raise_expectation_error(message, expected_received_count, argument_list_matcher, actual_received_count, expectation_count_type, *args)
-        expected_part = expected_part_of_expectation_error(expected_received_count, expectation_count_type, argument_list_matcher)
-        received_part = received_part_of_expectation_error(actual_received_count, *args)
-        __raise "(#{intro}).#{message}#{format_args(*args)}\n    #{expected_part}\n    #{received_part}"
-      end
-      # rubocop:enable Style/ParameterLists
-
-      # @private
-      def raise_unimplemented_error(doubled_module, method_name)
-        __raise "%s does not implement: %s" % [
-          doubled_module.description,
-          method_name
-        ]
-      end
-
-      # @private
-      def raise_non_public_error(method_name, visibility)
-        raise NoMethodError, "%s method `%s' called on %s" % [
-          visibility, method_name, intro
-        ]
-      end
-
-      # @private
-      def raise_invalid_arguments_error(verifier)
-        __raise verifier.error_message
-      end
-
-      # @private
-      def raise_expired_test_double_error
-        raise ExpiredTestDoubleError,
-              "#{intro} was originally created in one example but has leaked into " \
-              "another example and can no longer be used. rspec-mocks' doubles are " \
-              "designed to only last for one example, and you need to create a new " \
-              "one in each example you wish to use it for."
-      end
-
-      # @private
-      def received_part_of_expectation_error(actual_received_count, *args)
-        "received: #{count_message(actual_received_count)}" +
-          actual_method_call_args_description(actual_received_count, args)
-      end
-
-      # @private
-      def expected_part_of_expectation_error(expected_received_count, expectation_count_type, argument_list_matcher)
-        "expected: #{count_message(expected_received_count, expectation_count_type)}" +
-          expected_method_call_args_description(argument_list_matcher.expected_args)
-      end
-
-      # @private
-      def actual_method_call_args_description(count, args)
-        method_call_args_description(args) ||
-          if count > 0 && args.length > 0
-            " with arguments: #{args.inspect.gsub(/\A\[(.+)\]\z/, '(\1)')}"
-          else
-            ""
-          end
-      end
-
-      # @private
-      def expected_method_call_args_description(args)
-        method_call_args_description(args) ||
-          if args.length > 0
-            " with arguments: #{format_args(*args)}"
-          else
-            ""
-          end
-      end
-
-      # @private
-      def method_call_args_description(args)
-        case args.first
-        when ArgumentMatchers::AnyArgsMatcher then " with any arguments"
-        when ArgumentMatchers::NoArgsMatcher  then " with no arguments"
-        end
-      end
-
-      # @private
-      def describe_expectation(message, expected_received_count, _actual_received_count, *args)
-        "have received #{message}#{format_args(*args)} #{count_message(expected_received_count)}"
-      end
-
-      # @private
-      def raise_out_of_order_error(message)
-        __raise "#{intro} received :#{message} out of order"
-      end
-
-      # @private
-      def raise_block_failed_error(message, detail)
-        __raise "#{intro} received :#{message} but passed block failed with: #{detail}"
-      end
-
-      # @private
-      def raise_missing_block_error(args_to_yield)
-        __raise "#{intro} asked to yield |#{arg_list(*args_to_yield)}| but no block was passed"
-      end
-
-      # @private
-      def raise_wrong_arity_error(args_to_yield, signature)
-        __raise "#{intro} yielded |#{arg_list(*args_to_yield)}| to block with #{signature.description}"
-      end
-
-      # @private
-      def raise_only_valid_on_a_partial_double(method)
-        __raise "#{intro} is a pure test double. `#{method}` is only " \
-                "available on a partial double."
-      end
-
-      # @private
-      def raise_expectation_on_unstubbed_method(method)
-        __raise "#{intro} expected to have received #{method}, but that " \
-                "object is not a spy or method has not been stubbed."
-      end
-
-      # @private
-      def raise_expectation_on_mocked_method(method)
-        __raise "#{intro} expected to have received #{method}, but that " \
-                "method has been mocked instead of stubbed or spied."
-      end
-
-      def self.raise_double_negation_error(wrapped_expression)
-        raise "Isn't life confusing enough? You've already set a " \
-              "negative message expectation and now you are trying to " \
-              "negate it again with `never`. What does an expression like " \
-              "`#{wrapped_expression}.not_to receive(:msg).never` even mean?"
-      end
-
-    private
-
-      def intro
-        if @name
-          "Double #{@name.inspect}"
-        elsif TestDouble === @target
-          "Double"
-        elsif Class === @target
-          "<#{@target.inspect} (class)>"
-        elsif @target
-          @target
-        else
-          "nil"
-        end
-      end
-
-      def __raise(message)
-        message = opts[:message] unless opts[:message].nil?
-        Kernel.raise(RSpec::Mocks::MockExpectationError, message)
-      end
-
-      def arg_message(*args)
-        " with " + format_args(*args)
-      end
-
-      def format_args(*args)
-        args.empty? ? "(no args)" : "(" + arg_list(*args) + ")"
-      end
-
-      def arg_list(*args)
-        args.map { |arg| arg_has_valid_description(arg) ? arg.description : arg.inspect }.join(", ")
-      end
-
-      def arg_has_valid_description(arg)
-        return false unless arg.respond_to?(:description)
-
-        !arg.description.nil? && !arg.description.empty?
-      end
-
-      def format_received_args(*args)
-        args.empty? ? "(no args)" : "(" + received_arg_list(*args) + ")"
-      end
-
-      def received_arg_list(*args)
-        args.map(&:inspect).join(", ")
-      end
-
-      def count_message(count, expectation_count_type=nil)
-        return "at least #{times(count.abs)}" if count < 0 || expectation_count_type == :at_least
-        return "at most #{times(count)}" if expectation_count_type == :at_most
-        times(count)
-      end
-
-      def times(count)
-        "#{count} time#{count == 1 ? '' : 's'}"
-      end
-    end
-  end
-end

data/rspec-mocks/lib/rspec/mocks/example_methods.rb

@@ -1,379 +0,0 @@
-RSpec::Support.require_rspec_mocks 'object_reference'
-
-module RSpec
-  module Mocks
-    # Contains methods intended to be used from within code examples.
-    # Mix this in to your test context (such as a test framework base class)
-    # to use rspec-mocks with your test framework. If you're using rspec-core,
-    # it'll take care of doing this for you.
-    module ExampleMethods
-      include RSpec::Mocks::ArgumentMatchers
-
-      # @overload double()
-      # @overload double(name)
-      #   @param name [String/Symbol] used to clarify intent
-      # @overload double(stubs)
-      #   @param stubs (Hash) hash of message/return-value pairs
-      # @overload double(name, stubs)
-      #   @param name [String/Symbol] used to clarify intent
-      #   @param stubs (Hash) hash of message/return-value pairs
-      # @return (Double)
-      #
-      # Constructs an instance of [RSpec::Mocks::Double](RSpec::Mocks::Double) configured
-      # with an optional name, used for reporting in failure messages, and an optional
-      # hash of message/return-value pairs.
-      #
-      # @example
-      #
-      #   book = double("book", :title => "The RSpec Book")
-      #   book.title #=> "The RSpec Book"
-      #
-      #   card = double("card", :suit => "Spades", :rank => "A")
-      #   card.suit  #=> "Spades"
-      #   card.rank  #=> "A"
-      #
-      def double(*args)
-        ExampleMethods.declare_double(Double, *args)
-      end
-
-      # @overload instance_double(doubled_class)
-      #   @param doubled_class [String, Class]
-      # @overload instance_double(doubled_class, stubs)
-      #   @param doubled_class [String, Class]
-      #   @param stubs [Hash] hash of message/return-value pairs
-      # @return InstanceVerifyingDouble
-      #
-      # Constructs a test double against a specific class. If the given class
-      # name has been loaded, only instance methods defined on the class are
-      # allowed to be stubbed. In all other ways it behaves like a
-      # [double](double).
-      def instance_double(doubled_class, *args)
-        ref = ObjectReference.for(doubled_class)
-        ExampleMethods.declare_verifying_double(InstanceVerifyingDouble, ref, *args)
-      end
-
-      # @overload class_double(doubled_class)
-      #   @param doubled_class [String, Module]
-      # @overload class_double(doubled_class, stubs)
-      #   @param doubled_class [String, Module]
-      #   @param stubs [Hash] hash of message/return-value pairs
-      # @return ClassVerifyingDouble
-      #
-      # Constructs a test double against a specific class. If the given class
-      # name has been loaded, only class methods defined on the class are
-      # allowed to be stubbed. In all other ways it behaves like a
-      # [double](double).
-      def class_double(doubled_class, *args)
-        ref = ObjectReference.for(doubled_class)
-        ExampleMethods.declare_verifying_double(ClassVerifyingDouble, ref, *args)
-      end
-
-      # @overload object_double(object_or_name)
-      #   @param object_or_name [String, Object]
-      # @overload object_double(object_or_name, stubs)
-      #   @param object_or_name [String, Object]
-      #   @param stubs [Hash] hash of message/return-value pairs
-      # @return ObjectVerifyingDouble
-      #
-      # Constructs a test double against a specific object. Only the methods
-      # the object responds to are allowed to be stubbed. If a String argument
-      # is provided, it is assumed to reference a constant object which is used
-      # for verification. In all other ways it behaves like a [double](double).
-      def object_double(object_or_name, *args)
-        ref = ObjectReference.for(object_or_name, :allow_direct_object_refs)
-        ExampleMethods.declare_verifying_double(ObjectVerifyingDouble, ref, *args)
-      end
-
-      # @overload spy()
-      # @overload spy(name)
-      #   @param name [String/Symbol] used to clarify intent
-      # @overload spy(stubs)
-      #   @param stubs (Hash) hash of message/return-value pairs
-      # @overload spy(name, stubs)
-      #   @param name [String/Symbol] used to clarify intent
-      #   @param stubs (Hash) hash of message/return-value pairs
-      # @return (Double)
-      #
-      # Constructs a test double that is optimized for use with
-      # `have_received`. With a normal double one has to stub methods in order
-      # to be able to spy them. A spy automatically spies on all methods.
-      def spy(*args)
-        double(*args).as_null_object
-      end
-
-      # @overload instance_spy(doubled_class)
-      #   @param doubled_class [String, Class]
-      # @overload instance_spy(doubled_class, stubs)
-      #   @param doubled_class [String, Class]
-      #   @param stubs [Hash] hash of message/return-value pairs
-      # @return InstanceVerifyingDouble
-      #
-      # Constructs a test double that is optimized for use with `have_received`
-      # against a specific class. If the given class name has been loaded, only
-      # instance methods defined on the class are allowed to be stubbed.  With
-      # a normal double one has to stub methods in order to be able to spy
-      # them. An instance_spy automatically spies on all instance methods to
-      # which the class responds.
-      def instance_spy(*args)
-        instance_double(*args).as_null_object
-      end
-
-      # @overload object_spy(object_or_name)
-      #   @param object_or_name [String, Object]
-      # @overload object_spy(object_or_name, stubs)
-      #   @param object_or_name [String, Object]
-      #   @param stubs [Hash] hash of message/return-value pairs
-      # @return ObjectVerifyingDouble
-      #
-      # Constructs a test double that is optimized for use with `have_received`
-      # against a specific object. Only instance methods defined on the object
-      # are allowed to be stubbed.  With a normal double one has to stub
-      # methods in order to be able to spy them. An object_spy automatically
-      # spies on all methods to which the object responds.
-      def object_spy(*args)
-        object_double(*args).as_null_object
-      end
-
-      # @overload class_spy(doubled_class)
-      #   @param doubled_class [String, Module]
-      # @overload class_spy(doubled_class, stubs)
-      #   @param doubled_class [String, Module]
-      #   @param stubs [Hash] hash of message/return-value pairs
-      # @return ClassVerifyingDouble
-      #
-      # Constructs a test double that is optimized for use with `have_received`
-      # against a specific class. If the given class name has been loaded,
-      # only class methods defined on the class are allowed to be stubbed.
-      # With a normal double one has to stub methods in order to be able to spy
-      # them. An class_spy automatically spies on all class methods to which the
-      # class responds.
-      def class_spy(*args)
-        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.
-      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
-      # undefined) when the example completes.
-      #
-      # @param constant_name [String] The fully qualified name of the constant. The current
-      #   constant scoping at the point of call is not considered.
-      # @param value [Object] The value to make the constant refer to. When the
-      #   example completes, the constant will be restored to its prior state.
-      # @param options [Hash] Stubbing options.
-      # @option options :transfer_nested_constants [Boolean, Array<Symbol>] Determines
-      #   what nested constants, if any, will be transferred from the original value
-      #   of the constant to the new value of the constant. This only works if both
-      #   the original and new values are modules (or classes).
-      # @return [Object] the stubbed value of the constant
-      #
-      # @example
-      #
-      #   stub_const("MyClass", Class.new) # => Replaces (or defines) MyClass with a new class object.
-      #   stub_const("SomeModel::PER_PAGE", 5) # => Sets SomeModel::PER_PAGE to 5.
-      #
-      #   class CardDeck
-      #     SUITS = [:Spades, :Diamonds, :Clubs, :Hearts]
-      #     NUM_CARDS = 52
-      #   end
-      #
-      #   stub_const("CardDeck", Class.new)
-      #   CardDeck::SUITS # => uninitialized constant error
-      #   CardDeck::NUM_CARDS # => uninitialized constant error
-      #
-      #   stub_const("CardDeck", Class.new, :transfer_nested_constants => true)
-      #   CardDeck::SUITS # => our suits array
-      #   CardDeck::NUM_CARDS # => 52
-      #
-      #   stub_const("CardDeck", Class.new, :transfer_nested_constants => [:SUITS])
-      #   CardDeck::SUITS # => our suits array
-      #   CardDeck::NUM_CARDS # => uninitialized constant error
-      def stub_const(constant_name, value, options={})
-        ConstantMutator.stub(constant_name, value, options)
-      end
-
-      # Hides the named constant with the given value. The constant will be
-      # undefined for the duration of the test.
-      #
-      # Like method stubs, the constant will be restored to its original value
-      # when the example completes.
-      #
-      # @param constant_name [String] The fully qualified name of the constant.
-      #   The current constant scoping at the point of call is not considered.
-      #
-      # @example
-      #
-      #   hide_const("MyClass") # => MyClass is now an undefined constant
-      def hide_const(constant_name)
-        ConstantMutator.hide(constant_name)
-      end
-
-      # Verifies that the given object received the expected message during the
-      # course of the test. On a spy objects or as null object doubles this
-      # works for any method, on other objects the method must have
-      # been stubbed beforehand in order for messages to be verified.
-      #
-      # Stubbing and verifying messages received in this way implements the
-      # Test Spy pattern.
-      #
-      # @param method_name [Symbol] name of the method expected to have been
-      #   called.
-      #
-      # @example
-      #
-      #   invitation = double('invitation', accept: true)
-      #   user.accept_invitation(invitation)
-      #   expect(invitation).to have_received(:accept)
-      #
-      #   # You can also use most message expectations:
-      #   expect(invitation).to have_received(:accept).with(mailer).once
-      def have_received(method_name, &block)
-        Matchers::HaveReceived.new(method_name, &block)
-      end
-
-      # @method expect
-      # Used to wrap an object in preparation for setting a mock expectation
-      # on it.
-      #
-      # @example
-      #
-      #   expect(obj).to receive(:foo).with(5).and_return(:return_value)
-      #
-      # @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.
-
-      # @method allow
-      # Used to wrap an object in preparation for stubbing a method
-      # on it.
-      #
-      # @example
-      #
-      #   allow(dbl).to receive(:foo).with(5).and_return(:return_value)
-      #
-      # @note If you disable the `:expect` syntax this method will be undefined.
-
-      # @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.
-
-      # @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.
-
-      # @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
-      # 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.
-
-      # @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`,
-      # you cannot apply further customizations using a block or the fluent
-      # interface.
-      #
-      # @example
-      #
-      #   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.
-
-      # @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)
-      #
-      # stubs/mocks a chain of messages on an object or test double.
-      #
-      # ## Warning:
-      #
-      # Chains can be arbitrarily long, which makes it quite painless to
-      # violate the Law of Demeter in violent ways, so you should consider any
-      # use of `receive_message_chain` a code smell. Even though not all code smells
-      # indicate real problems (think fluent interfaces), `receive_message_chain` still
-      # results in brittle examples.  For example, if you write
-      # `allow(foo).to receive_message_chain(:bar, :baz => 37)` in a spec and then the
-      # implementation calls `foo.baz.bar`, the stub will not work.
-      #
-      # @example
-      #
-      #     allow(double).to receive_message_chain("foo.bar") { :baz }
-      #     allow(double).to receive_message_chain(:foo, :bar => :baz)
-      #     allow(double).to receive_message_chain(:foo, :bar) { :baz }
-      #
-      #     # Given any of ^^ these three forms ^^:
-      #     double.foo.bar # => :baz
-      #
-      #     # 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.
-
-      # @private
-      def self.included(klass)
-        klass.class_exec do
-          # This gets mixed in so that if `RSpec::Matchers` is included in
-          # `klass` later, it's definition of `expect` will take precedence.
-          include ExpectHost unless method_defined?(:expect)
-        end
-      end
-
-      # @private
-      def self.declare_verifying_double(type, ref, *args)
-        if RSpec::Mocks.configuration.verify_doubled_constant_names? &&
-          !ref.defined?
-
-          raise VerifyingDoubleNotDefinedError,
-                "#{ref.description} is not a defined constant. " \
-                "Perhaps you misspelt it? " \
-                "Disable check with verify_doubled_constant_names configuration option."
-        end
-
-        declare_double(type, ref, *args)
-      end
-
-      # @private
-      def self.declare_double(type, *args)
-        args << {} unless Hash === args.last
-        type.new(*args)
-      end
-
-      # This module exists to host the `expect` method for cases where
-      # rspec-mocks is used w/o rspec-expectations.
-      module ExpectHost
-      end
-    end
-  end
-end