module RSpec::Mocks::TestDouble

Implements the methods needed for a pure test double. RSpec::Mocks::Double includes this module, and it is provided for cases where you want a pure test double without subclassing RSpec::Mocks::Double.

Public Class Methods

new (name=nil, stubs={})

Creates a new test double with a ‘name` (that will be used in error messages only)

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 9
def initialize(name=nil, stubs={})
  @__expired = false
  if Hash === name && stubs.empty?
    stubs = name
    @name = nil
  else
    @name = name
  end
  assign_stubs(stubs)
end

Public Instance Methods

== (other)

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 rspec-mocks/lib/rspec/mocks/test_double.rb, line 36
def ==(other)
  other == __mock_proxy
end

__build_mock_proxy_unless_expired (order_group)

@private

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 58
def __build_mock_proxy_unless_expired(order_group)
  __raise_expired_error || __build_mock_proxy(order_group)
end

__disallow_further_usage! ()

@private

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 63
def __disallow_further_usage!
  @__expired = true
end

as_null_object ()

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 rspec-mocks/lib/rspec/mocks/test_double.rb, line 23
def as_null_object
  __mock_proxy.as_null_object
end

freeze ()

Override for default freeze implementation to prevent freezing of test doubles.

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 69
def freeze
  RSpec.warn_with("WARNING: you attempted to freeze a test double. This is explicitly a no-op as freezing doubles can lead to undesired behaviour when resetting tests.")
  self
end

inspect ()

@private

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 41
def inspect
  TestDoubleFormatter.format(self)
end

null_object? ()

Returns true if this object has received ‘as_null_object`

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 28
def null_object?
  __mock_proxy.null_object?
end

respond_to? (message, incl_private=false)

@private

Calls superclass method

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 51
def respond_to?(message, incl_private=false)
  return true if __mock_proxy.null_object?

  super
end

to_s ()

@private

# File rspec-mocks/lib/rspec/mocks/test_double.rb, line 46
def to_s
  inspect.tr('<', '[').tr('>', ']')
end