module RSpec::Mocks::TestDouble
Implements the methods needed for a pure test double. RSpec::Mocks::Mock includes this module, and it is provided for cases where you want a pure test double without subclassing RSpec::Mocks::Mock.
Public Class Methods
Extends the TestDouble module onto the given object and initializes it as a test double.
@example
module = Module.new RSpec::Mocks::TestDouble.extend_onto(module, "MyMixin", :foo => "bar") module.foo #=> "bar"
# File lib/rspec/mocks/test_double.rb, line 15 def self.extend_onto(object, name=nil, stubs_and_options={}) object.extend self object.send(:__initialize_as_test_double, name, stubs_and_options) end
Creates a new test double with a `name` (that will be used in error messages only)
# File lib/rspec/mocks/test_double.rb, line 22 def initialize(name=nil, stubs_and_options={}) __initialize_as_test_double(name, stubs_and_options) end
Public Instance Methods
This allows for comparing the mock to other objects that proxy such as ActiveRecords belongs_to proxy objects. By making the other object run the comparison, we're sure the call gets delegated to the proxy target.
# File lib/rspec/mocks/test_double.rb, line 43 def ==(other) other == __mock_proxy end
@private
# File lib/rspec/mocks/test_double.rb, line 65 def __build_mock_proxy proxy = Proxy.new(self, @name, @options || {}) proxy.as_null_object if null_object? proxy end
Tells the object to respond to all messages. If specific stub values are declared, they'll work as expected. If not, the receiver is returned.
# File lib/rspec/mocks/test_double.rb, line 29 def as_null_object @__null_object = true __mock_proxy.as_null_object end
@private
# File lib/rspec/mocks/test_double.rb, line 48 def inspect "#<#{self.class}:#{sprintf '0x%x', self.object_id} @name=#{@name.inspect}>" end
Returns true if this object has received `as_null_object`
# File lib/rspec/mocks/test_double.rb, line 35 def null_object? @__null_object end
@private
# File lib/rspec/mocks/test_double.rb, line 60 def respond_to?(message, incl_private=false) __mock_proxy.null_object? ? true : super end
@private
# File lib/rspec/mocks/test_double.rb, line 53 def to_s inspect.gsub('<','[').gsub('>',']') end
Private Instance Methods
# File lib/rspec/mocks/test_double.rb, line 73 def __initialize_as_test_double(name=nil, stubs_and_options={}) @__null_object = false if name.is_a?(Hash) && stubs_and_options.empty? stubs_and_options = name @name = nil else @name = name end @options = extract_options(stubs_and_options) assign_stubs(stubs_and_options) end
# File lib/rspec/mocks/test_double.rb, line 130 def __mock_proxy ::RSpec::Mocks.proxy_for(self) end
# File lib/rspec/mocks/test_double.rb, line 122 def assign_stubs(stubs) stubs.each_pair do |message, response| Mocks.allow_message(self, message).and_return(response) end end
# File lib/rspec/mocks/test_double.rb, line 114 def extract_option(source, target, key, default=nil) if source[key] target[key] = source.delete(key) elsif default target[key] = default end end
# File lib/rspec/mocks/test_double.rb, line 104 def extract_options(stubs_and_options) if stubs_and_options[:null_object] @null_object = stubs_and_options.delete(:null_object) RSpec.deprecate("double('name', :null_object => true)", :replacement => "double('name').as_null_object") end options = {} extract_option(stubs_and_options, options, :__declared_as, 'Mock') options end
# File lib/rspec/mocks/test_double.rb, line 86 def method_missing(message, *args, &block) if __mock_proxy.null_object? case message when :to_int then return 0 when :to_a, :to_ary then return nil end end __mock_proxy.record_message_received(message, *args, &block) begin __mock_proxy.null_object? ? self : super rescue NameError # Required wrapping doubles in an Array on Ruby 1.9.2 raise NoMethodError if [:to_a, :to_ary].include? message __mock_proxy.raise_unexpected_message_error(message, *args) end end