Class: Object

Inherits:
BasicObject
Includes:
Mocha::ObjectMethods
Defined in:
lib/mocha/object.rb,
lib/mocha/is_a.rb,
lib/mocha/inspect.rb,
lib/mocha/metaclass.rb,
lib/mocha/parameter_matchers/object.rb

Overview

Methods added all objects to allow mocking and stubbing on real objects.

Methods return a Mocha::Expectation which can be further modified by methods on Mocha::Expectation.

Instance Method Summary collapse

Methods included from Mocha::ObjectMethods

#__metaclass__, #mocha_inspect, #to_matcher

Instance Method Details

#expects(method_name_or_hash) ⇒ Object

:call-seq: expects(method_name) -> expectation

expects(method_names_vs_return_values) -> last expectation

Adds an expectation that a method identified by method_name Symbol must be called exactly once with any parameters. Returns the new expectation which can be further modified by methods on Mocha::Expectation.

product = Product.new
product.expects(:save).returns(true)
assert_equal true, product.save

The original implementation of Product#save is replaced temporarily.

The original implementation of Product#save is restored at the end of the test.

If method_names_vs_return_values is a Hash, an expectation will be set up for each entry using the key as method_name and value as return_value.

product = Product.new
product.expects(:valid? => true, :save => true)

# exactly equivalent to

product = Product.new
product.expects(:valid?).returns(true)
product.expects(:save).returns(true)



51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/mocha/object.rb', line 51

def expects(method_name_or_hash)
  expectation = nil
  mockery = Mocha::Mockery.instance
  iterator = Mocha::ArgumentIterator.new(method_name_or_hash)
  iterator.each { |*args|
    method_name = args.shift
    mockery.on_stubbing(self, method_name)
    method = stubba_method.new(stubba_object, method_name)
    mockery.stubba.stub(method)
    expectation = mocha.expects(method_name, caller)
    expectation.returns(args.shift) if args.length > 0
  }
  expectation
end

#method_exists?(method, include_public_methods = true) ⇒ Boolean

:nodoc:

Returns:

  • (Boolean) 


103
104
105
106
107
108
109
110
111
 
# File 'lib/mocha/object.rb', line 103

def method_exists?(method, include_public_methods = true) # :nodoc:
  if include_public_methods
    return true if public_methods(include_superclass_methods = true).include?(method)
    return true if respond_to?(method.to_sym)
  end
  return true if protected_methods(include_superclass_methods = true).include?(method)
  return true if private_methods(include_superclass_methods = true).include?(method)
  return false
end

#mocha ⇒ Object

:nodoc:



13
14
15
 
# File 'lib/mocha/object.rb', line 13

def mocha # :nodoc:
  @mocha ||= Mocha::Mockery.instance.mock_impersonating(self)
end

#reset_mocha ⇒ Object

:nodoc:



17
18
19
 
# File 'lib/mocha/object.rb', line 17

def reset_mocha # :nodoc:
  @mocha = nil
end

#stubba_method ⇒ Object

:nodoc:



21
22
23
 
# File 'lib/mocha/object.rb', line 21

def stubba_method # :nodoc:
  Mocha::InstanceMethod
end

#stubba_object ⇒ Object

:nodoc:



25
26
27
 
# File 'lib/mocha/object.rb', line 25

def stubba_object # :nodoc:
  self
end

#stubs(method_name_or_hash) ⇒ Object

:call-seq: stubs(method_name) -> expectation

stubs(method_names_vs_return_values) -> last expectation

Adds an expectation that a method identified by method_name Symbol may be called any number of times with any parameters. Returns the new expectation which can be further modified by methods on Mocha::Expectation.

product = Product.new
product.stubs(:save).returns(true)
assert_equal true, product.save

The original implementation of Product#save is replaced temporarily.

The original implementation of Product#save is restored at the end of the test.

If method_names_vs_return_values is a Hash, an expectation will be set up for each entry using the key as method_name and value as return_value.

product = Product.new
product.stubs(:valid? => true, :save => true)

# exactly equivalent to

product = Product.new
product.stubs(:valid?).returns(true)
product.stubs(:save).returns(true)



88
89
90
91
92
93
94
95
96
97
98
99
100
101
 
# File 'lib/mocha/object.rb', line 88

def stubs(method_name_or_hash)
  expectation = nil
  mockery = Mocha::Mockery.instance
  iterator = Mocha::ArgumentIterator.new(method_name_or_hash)
  iterator.each { |*args|
    method_name = args.shift
    mockery.on_stubbing(self, method_name)
    method = stubba_method.new(stubba_object, method_name)
    mockery.stubba.stub(method)
    expectation = mocha.stubs(method_name, caller)
    expectation.returns(args.shift) if args.length > 0
  }
  expectation
end