Class: MiniTest::Mock
Overview
All mock objects are an instance of Mock
Instance Method Summary collapse
- #__respond_to? ⇒ Object
-
#expect(name, retval, args = []) ⇒ Object
Expect that method
name
is called, optionally withargs
, and returnsretval
. -
#initialize ⇒ Mock
constructor
:nodoc:.
-
#method_missing(sym, *args) ⇒ Object
:nodoc:.
-
#respond_to?(sym) ⇒ Boolean
:nodoc:.
-
#verify ⇒ Object
Verify that all methods were called as expected.
Constructor Details
#initialize ⇒ Mock
:nodoc:
20 21 22 23 |
# File 'lib/minitest/mock.rb', line 20 def initialize # :nodoc: @expected_calls = {} @actual_calls = Hash.new {|h,k| h[k] = [] } end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(sym, *args) ⇒ Object
:nodoc:
72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/minitest/mock.rb', line 72 def method_missing(sym, *args) # :nodoc: expected = @expected_calls[sym] unless expected then raise NoMethodError, "unmocked method %p, expected one of %p" % [sym, @expected_calls.keys.sort_by(&:to_s)] end expected_args, retval = expected[:args], expected[:retval] unless expected_args.size == args.size raise ArgumentError, "mocked method %p expects %d arguments, got %d" % [sym, expected[:args].size, args.size] end @actual_calls[sym] << { :retval => retval, :args => expected_args.zip(args).map { |mod, a| mod if mod === a } } retval end |
Instance Method Details
#__respond_to? ⇒ Object
12 |
# File 'lib/minitest/mock.rb', line 12 alias :__respond_to? :respond_to? |
#expect(name, retval, args = []) ⇒ Object
Expect that method name
is called, optionally with args
, and returns retval
.
@mock.expect(:meaning_of_life, 42)
@mock.meaning_of_life # => 42
@mock.expect(:do_something_with, true, [some_obj, true])
@mock.do_something_with(some_obj, true) # => true
args
is compared to the expected args using case equality (ie, the ‘===’ operator), allowing for less specific expectations.
@mock.expect(:uses_any_string, true, [String])
@mock.uses_any_string("foo") # => true
@mock.verify # => true
@mock.expect(:uses_one_string, true, ["foo"]
@mock.uses_one_string("bar") # => true
@mock.verify # => raises MockExpectationError
46 47 48 49 |
# File 'lib/minitest/mock.rb', line 46 def expect(name, retval, args=[]) @expected_calls[name] = { :retval => retval, :args => args } self end |
#respond_to?(sym) ⇒ Boolean
:nodoc:
95 96 97 98 |
# File 'lib/minitest/mock.rb', line 95 def respond_to?(sym) # :nodoc: return true if @expected_calls.has_key?(sym) return __respond_to?(sym) end |
#verify ⇒ Object
Verify that all methods were called as expected. Raises MockExpectationError
if the mock object was not called as expected.
56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 |
# File 'lib/minitest/mock.rb', line 56 def verify @expected_calls.each_key do |name| expected = @expected_calls[name] msg1 = "expected #{name}, #{expected.inspect}" msg2 = "#{msg1}, got #{@actual_calls[name].inspect}" raise MockExpectationError, msg2 if @actual_calls.has_key? name and not @actual_calls[name].include?(expected) raise MockExpectationError, msg1 unless @actual_calls.has_key? name and @actual_calls[name].include?(expected) end true end |