thewoolleyman-mocha 0.9.3.20081219131457
Sign up to get free protection for your applications and to get access to all the features.
- data/COPYING +3 -0
- data/MIT-LICENSE +7 -0
- data/README +35 -0
- data/RELEASE +257 -0
- data/Rakefile +199 -0
- data/examples/misc.rb +44 -0
- data/examples/mocha.rb +26 -0
- data/examples/stubba.rb +65 -0
- data/lib/mocha.rb +47 -0
- data/lib/mocha/any_instance_method.rb +54 -0
- data/lib/mocha/argument_iterator.rb +21 -0
- data/lib/mocha/backtrace_filter.rb +17 -0
- data/lib/mocha/cardinality.rb +95 -0
- data/lib/mocha/central.rb +27 -0
- data/lib/mocha/change_state_side_effect.rb +19 -0
- data/lib/mocha/class_method.rb +86 -0
- data/lib/mocha/configuration.rb +60 -0
- data/lib/mocha/deprecation.rb +22 -0
- data/lib/mocha/exception_raiser.rb +17 -0
- data/lib/mocha/expectation.rb +451 -0
- data/lib/mocha/expectation_error.rb +15 -0
- data/lib/mocha/expectation_list.rb +50 -0
- data/lib/mocha/in_state_ordering_constraint.rb +19 -0
- data/lib/mocha/inspect.rb +67 -0
- data/lib/mocha/instance_method.rb +16 -0
- data/lib/mocha/is_a.rb +9 -0
- data/lib/mocha/logger.rb +15 -0
- data/lib/mocha/metaclass.rb +13 -0
- data/lib/mocha/method_matcher.rb +21 -0
- data/lib/mocha/mini_test_adapter.rb +50 -0
- data/lib/mocha/mock.rb +200 -0
- data/lib/mocha/mockery.rb +181 -0
- data/lib/mocha/module_method.rb +16 -0
- data/lib/mocha/multiple_yields.rb +20 -0
- data/lib/mocha/names.rb +53 -0
- data/lib/mocha/no_yields.rb +11 -0
- data/lib/mocha/object.rb +187 -0
- data/lib/mocha/parameter_matchers.rb +27 -0
- data/lib/mocha/parameter_matchers/all_of.rb +42 -0
- data/lib/mocha/parameter_matchers/any_of.rb +47 -0
- data/lib/mocha/parameter_matchers/any_parameters.rb +40 -0
- data/lib/mocha/parameter_matchers/anything.rb +33 -0
- data/lib/mocha/parameter_matchers/base.rb +15 -0
- data/lib/mocha/parameter_matchers/equals.rb +42 -0
- data/lib/mocha/parameter_matchers/has_entries.rb +45 -0
- data/lib/mocha/parameter_matchers/has_entry.rb +56 -0
- data/lib/mocha/parameter_matchers/has_key.rb +42 -0
- data/lib/mocha/parameter_matchers/has_value.rb +42 -0
- data/lib/mocha/parameter_matchers/includes.rb +40 -0
- data/lib/mocha/parameter_matchers/instance_of.rb +42 -0
- data/lib/mocha/parameter_matchers/is_a.rb +42 -0
- data/lib/mocha/parameter_matchers/kind_of.rb +42 -0
- data/lib/mocha/parameter_matchers/not.rb +42 -0
- data/lib/mocha/parameter_matchers/object.rb +15 -0
- data/lib/mocha/parameter_matchers/optionally.rb +55 -0
- data/lib/mocha/parameter_matchers/regexp_matches.rb +43 -0
- data/lib/mocha/parameter_matchers/responds_with.rb +43 -0
- data/lib/mocha/parameter_matchers/yaml_equivalent.rb +43 -0
- data/lib/mocha/parameters_matcher.rb +37 -0
- data/lib/mocha/pretty_parameters.rb +28 -0
- data/lib/mocha/return_values.rb +31 -0
- data/lib/mocha/sequence.rb +42 -0
- data/lib/mocha/single_return_value.rb +17 -0
- data/lib/mocha/single_yield.rb +18 -0
- data/lib/mocha/standalone.rb +166 -0
- data/lib/mocha/state_machine.rb +91 -0
- data/lib/mocha/stubbing_error.rb +16 -0
- data/lib/mocha/test_case_adapter.rb +103 -0
- data/lib/mocha/unexpected_invocation.rb +18 -0
- data/lib/mocha/yield_parameters.rb +31 -0
- data/lib/mocha_standalone.rb +2 -0
- data/lib/stubba.rb +4 -0
- data/test/acceptance/acceptance_test_helper.rb +38 -0
- data/test/acceptance/bug_18914_test.rb +43 -0
- data/test/acceptance/bug_21465_test.rb +34 -0
- data/test/acceptance/bug_21563_test.rb +25 -0
- data/test/acceptance/expected_invocation_count_test.rb +196 -0
- data/test/acceptance/failure_messages_test.rb +64 -0
- data/test/acceptance/minitest_test.rb +130 -0
- data/test/acceptance/mocha_example_test.rb +98 -0
- data/test/acceptance/mocha_test_result_test.rb +84 -0
- data/test/acceptance/mock_test.rb +100 -0
- data/test/acceptance/mock_with_initializer_block_test.rb +51 -0
- data/test/acceptance/mocked_methods_dispatch_test.rb +78 -0
- data/test/acceptance/optional_parameters_test.rb +70 -0
- data/test/acceptance/parameter_matcher_test.rb +209 -0
- data/test/acceptance/partial_mocks_test.rb +47 -0
- data/test/acceptance/return_value_test.rb +52 -0
- data/test/acceptance/sequence_test.rb +186 -0
- data/test/acceptance/standalone_test.rb +139 -0
- data/test/acceptance/states_test.rb +70 -0
- data/test/acceptance/stub_any_instance_method_test.rb +195 -0
- data/test/acceptance/stub_class_method_test.rb +203 -0
- data/test/acceptance/stub_everything_test.rb +56 -0
- data/test/acceptance/stub_instance_method_test.rb +203 -0
- data/test/acceptance/stub_module_method_test.rb +163 -0
- data/test/acceptance/stub_test.rb +52 -0
- data/test/acceptance/stubba_example_test.rb +102 -0
- data/test/acceptance/stubba_test.rb +15 -0
- data/test/acceptance/stubba_test_result_test.rb +66 -0
- data/test/acceptance/stubbing_error_backtrace_test.rb +64 -0
- data/test/acceptance/stubbing_method_unnecessarily_test.rb +65 -0
- data/test/acceptance/stubbing_non_existent_any_instance_method_test.rb +130 -0
- data/test/acceptance/stubbing_non_existent_class_method_test.rb +157 -0
- data/test/acceptance/stubbing_non_existent_instance_method_test.rb +147 -0
- data/test/acceptance/stubbing_non_public_any_instance_method_test.rb +130 -0
- data/test/acceptance/stubbing_non_public_class_method_test.rb +163 -0
- data/test/acceptance/stubbing_non_public_instance_method_test.rb +143 -0
- data/test/acceptance/stubbing_on_non_mock_object_test.rb +64 -0
- data/test/deprecation_disabler.rb +15 -0
- data/test/execution_point.rb +36 -0
- data/test/method_definer.rb +24 -0
- data/test/simple_counter.rb +13 -0
- data/test/test_helper.rb +11 -0
- data/test/test_runner.rb +33 -0
- data/test/unit/any_instance_method_test.rb +126 -0
- data/test/unit/array_inspect_test.rb +16 -0
- data/test/unit/backtrace_filter_test.rb +19 -0
- data/test/unit/cardinality_test.rb +56 -0
- data/test/unit/central_test.rb +65 -0
- data/test/unit/change_state_side_effect_test.rb +41 -0
- data/test/unit/class_method_test.rb +237 -0
- data/test/unit/date_time_inspect_test.rb +21 -0
- data/test/unit/exception_raiser_test.rb +42 -0
- data/test/unit/expectation_list_test.rb +57 -0
- data/test/unit/expectation_test.rb +459 -0
- data/test/unit/hash_inspect_test.rb +16 -0
- data/test/unit/in_state_ordering_constraint_test.rb +43 -0
- data/test/unit/metaclass_test.rb +22 -0
- data/test/unit/method_matcher_test.rb +23 -0
- data/test/unit/mock_test.rb +295 -0
- data/test/unit/mockery_test.rb +149 -0
- data/test/unit/multiple_yields_test.rb +18 -0
- data/test/unit/no_yields_test.rb +18 -0
- data/test/unit/object_inspect_test.rb +37 -0
- data/test/unit/object_test.rb +82 -0
- data/test/unit/parameter_matchers/all_of_test.rb +26 -0
- data/test/unit/parameter_matchers/any_of_test.rb +26 -0
- data/test/unit/parameter_matchers/anything_test.rb +21 -0
- data/test/unit/parameter_matchers/equals_test.rb +25 -0
- data/test/unit/parameter_matchers/has_entries_test.rb +51 -0
- data/test/unit/parameter_matchers/has_entry_test.rb +62 -0
- data/test/unit/parameter_matchers/has_key_test.rb +36 -0
- data/test/unit/parameter_matchers/has_value_test.rb +37 -0
- data/test/unit/parameter_matchers/includes_test.rb +25 -0
- data/test/unit/parameter_matchers/instance_of_test.rb +25 -0
- data/test/unit/parameter_matchers/is_a_test.rb +25 -0
- data/test/unit/parameter_matchers/kind_of_test.rb +25 -0
- data/test/unit/parameter_matchers/not_test.rb +26 -0
- data/test/unit/parameter_matchers/regexp_matches_test.rb +25 -0
- data/test/unit/parameter_matchers/responds_with_test.rb +25 -0
- data/test/unit/parameter_matchers/stub_matcher.rb +27 -0
- data/test/unit/parameter_matchers/yaml_equivalent_test.rb +25 -0
- data/test/unit/parameters_matcher_test.rb +121 -0
- data/test/unit/return_values_test.rb +63 -0
- data/test/unit/sequence_test.rb +104 -0
- data/test/unit/single_return_value_test.rb +14 -0
- data/test/unit/single_yield_test.rb +18 -0
- data/test/unit/state_machine_test.rb +98 -0
- data/test/unit/string_inspect_test.rb +11 -0
- data/test/unit/yield_parameters_test.rb +93 -0
- metadata +226 -0
@@ -0,0 +1,60 @@
|
|
1
|
+
module Mocha # :nodoc:
|
2
|
+
|
3
|
+
# Configuration settings
|
4
|
+
class Configuration
|
5
|
+
|
6
|
+
DEFAULTS = { :stubbing_method_unnecessarily => :allow, :stubbing_method_on_non_mock_object => :allow, :stubbing_non_existent_method => :allow, :stubbing_non_public_method => :allow }
|
7
|
+
|
8
|
+
class << self
|
9
|
+
|
10
|
+
# :call-seq: allow(action)
|
11
|
+
#
|
12
|
+
# Allow the specified <tt>action</tt> (as a symbol).
|
13
|
+
# The <tt>actions</tt> currently available are <tt>:stubbing_method_unnecessarily, :stubbing_method_on_non_mock_object, :stubbing_non_existent_method, :stubbing_non_public_method</tt>.
|
14
|
+
def allow(action)
|
15
|
+
configuration[action] = :allow
|
16
|
+
end
|
17
|
+
|
18
|
+
def allow?(action) # :nodoc:
|
19
|
+
configuration[action] == :allow
|
20
|
+
end
|
21
|
+
|
22
|
+
# :call-seq: warn_when(action)
|
23
|
+
#
|
24
|
+
# Warn if the specified <tt>action</tt> (as a symbol) is attempted.
|
25
|
+
# The <tt>actions</tt> currently available are <tt>:stubbing_method_unnecessarily, :stubbing_method_on_non_mock_object, :stubbing_non_existent_method, :stubbing_non_public_method</tt>.
|
26
|
+
def warn_when(action)
|
27
|
+
configuration[action] = :warn
|
28
|
+
end
|
29
|
+
|
30
|
+
def warn_when?(action) # :nodoc:
|
31
|
+
configuration[action] == :warn
|
32
|
+
end
|
33
|
+
|
34
|
+
# :call-seq: prevent(action)
|
35
|
+
#
|
36
|
+
# Raise a StubbingError if the specified <tt>action</tt> (as a symbol) is attempted.
|
37
|
+
# The <tt>actions</tt> currently available are <tt>:stubbing_method_unnecessarily, :stubbing_method_on_non_mock_object, :stubbing_non_existent_method, :stubbing_non_public_method</tt>.
|
38
|
+
def prevent(action)
|
39
|
+
configuration[action] = :prevent
|
40
|
+
end
|
41
|
+
|
42
|
+
def prevent?(action) # :nodoc:
|
43
|
+
configuration[action] == :prevent
|
44
|
+
end
|
45
|
+
|
46
|
+
def reset_configuration # :nodoc:
|
47
|
+
@configuration = nil
|
48
|
+
end
|
49
|
+
|
50
|
+
private
|
51
|
+
|
52
|
+
def configuration # :nodoc:
|
53
|
+
@configuration ||= DEFAULTS.dup
|
54
|
+
end
|
55
|
+
|
56
|
+
end
|
57
|
+
|
58
|
+
end
|
59
|
+
|
60
|
+
end
|
@@ -0,0 +1,22 @@
|
|
1
|
+
module Mocha
|
2
|
+
|
3
|
+
class Deprecation
|
4
|
+
|
5
|
+
class << self
|
6
|
+
|
7
|
+
attr_accessor :mode, :messages
|
8
|
+
|
9
|
+
def warning(message)
|
10
|
+
@messages << message
|
11
|
+
$stderr.puts "Mocha deprecation warning: #{message}" unless mode == :disabled
|
12
|
+
$stderr.puts caller.join("\n ") if mode == :debug
|
13
|
+
end
|
14
|
+
|
15
|
+
end
|
16
|
+
|
17
|
+
self.mode = :enabled
|
18
|
+
self.messages = []
|
19
|
+
|
20
|
+
end
|
21
|
+
|
22
|
+
end
|
@@ -0,0 +1,17 @@
|
|
1
|
+
module Mocha # :nodoc:
|
2
|
+
|
3
|
+
class ExceptionRaiser # :nodoc:
|
4
|
+
|
5
|
+
def initialize(exception, message)
|
6
|
+
@exception, @message = exception, message
|
7
|
+
end
|
8
|
+
|
9
|
+
def evaluate
|
10
|
+
raise @exception, @exception.to_s if @exception.is_a?(Module) && @exception.ancestors.include?(Interrupt)
|
11
|
+
raise @exception, @message if @message
|
12
|
+
raise @exception
|
13
|
+
end
|
14
|
+
|
15
|
+
end
|
16
|
+
|
17
|
+
end
|
@@ -0,0 +1,451 @@
|
|
1
|
+
require 'mocha/method_matcher'
|
2
|
+
require 'mocha/parameters_matcher'
|
3
|
+
require 'mocha/expectation_error'
|
4
|
+
require 'mocha/return_values'
|
5
|
+
require 'mocha/exception_raiser'
|
6
|
+
require 'mocha/yield_parameters'
|
7
|
+
require 'mocha/is_a'
|
8
|
+
require 'mocha/in_state_ordering_constraint'
|
9
|
+
require 'mocha/change_state_side_effect'
|
10
|
+
require 'mocha/cardinality'
|
11
|
+
|
12
|
+
module Mocha # :nodoc:
|
13
|
+
|
14
|
+
# Methods on expectations returned from Mock#expects, Mock#stubs, Object#expects and Object#stubs.
|
15
|
+
class Expectation
|
16
|
+
|
17
|
+
# :call-seq: times(range) -> expectation
|
18
|
+
#
|
19
|
+
# Modifies expectation so that the number of calls to the expected method must be within a specific +range+.
|
20
|
+
#
|
21
|
+
# +range+ can be specified as an exact integer or as a range of integers
|
22
|
+
# object = mock()
|
23
|
+
# object.expects(:expected_method).times(3)
|
24
|
+
# 3.times { object.expected_method }
|
25
|
+
# # => verify succeeds
|
26
|
+
#
|
27
|
+
# object = mock()
|
28
|
+
# object.expects(:expected_method).times(3)
|
29
|
+
# 2.times { object.expected_method }
|
30
|
+
# # => verify fails
|
31
|
+
#
|
32
|
+
# object = mock()
|
33
|
+
# object.expects(:expected_method).times(2..4)
|
34
|
+
# 3.times { object.expected_method }
|
35
|
+
# # => verify succeeds
|
36
|
+
#
|
37
|
+
# object = mock()
|
38
|
+
# object.expects(:expected_method).times(2..4)
|
39
|
+
# object.expected_method
|
40
|
+
# # => verify fails
|
41
|
+
def times(range)
|
42
|
+
@cardinality = Cardinality.times(range)
|
43
|
+
self
|
44
|
+
end
|
45
|
+
|
46
|
+
# :call-seq: once() -> expectation
|
47
|
+
#
|
48
|
+
# Modifies expectation so that the expected method must be called exactly once.
|
49
|
+
# Note that this is the default behaviour for an expectation, but you may wish to use it for clarity/emphasis.
|
50
|
+
# object = mock()
|
51
|
+
# object.expects(:expected_method).once
|
52
|
+
# object.expected_method
|
53
|
+
# # => verify succeeds
|
54
|
+
#
|
55
|
+
# object = mock()
|
56
|
+
# object.expects(:expected_method).once
|
57
|
+
# object.expected_method
|
58
|
+
# object.expected_method
|
59
|
+
# # => verify fails
|
60
|
+
#
|
61
|
+
# object = mock()
|
62
|
+
# object.expects(:expected_method).once
|
63
|
+
# # => verify fails
|
64
|
+
def once
|
65
|
+
@cardinality = Cardinality.exactly(1)
|
66
|
+
self
|
67
|
+
end
|
68
|
+
|
69
|
+
# :call-seq: never() -> expectation
|
70
|
+
#
|
71
|
+
# Modifies expectation so that the expected method must never be called.
|
72
|
+
# object = mock()
|
73
|
+
# object.expects(:expected_method).never
|
74
|
+
# object.expected_method
|
75
|
+
# # => verify fails
|
76
|
+
#
|
77
|
+
# object = mock()
|
78
|
+
# object.expects(:expected_method).never
|
79
|
+
# object.expected_method
|
80
|
+
# # => verify succeeds
|
81
|
+
def never
|
82
|
+
@cardinality = Cardinality.exactly(0)
|
83
|
+
self
|
84
|
+
end
|
85
|
+
|
86
|
+
# :call-seq: at_least(minimum_number_of_times) -> expectation
|
87
|
+
#
|
88
|
+
# Modifies expectation so that the expected method must be called at least a +minimum_number_of_times+.
|
89
|
+
# object = mock()
|
90
|
+
# object.expects(:expected_method).at_least(2)
|
91
|
+
# 3.times { object.expected_method }
|
92
|
+
# # => verify succeeds
|
93
|
+
#
|
94
|
+
# object = mock()
|
95
|
+
# object.expects(:expected_method).at_least(2)
|
96
|
+
# object.expected_method
|
97
|
+
# # => verify fails
|
98
|
+
def at_least(minimum_number_of_times)
|
99
|
+
@cardinality = Cardinality.at_least(minimum_number_of_times)
|
100
|
+
self
|
101
|
+
end
|
102
|
+
|
103
|
+
# :call-seq: at_least_once() -> expectation
|
104
|
+
#
|
105
|
+
# Modifies expectation so that the expected method must be called at least once.
|
106
|
+
# object = mock()
|
107
|
+
# object.expects(:expected_method).at_least_once
|
108
|
+
# object.expected_method
|
109
|
+
# # => verify succeeds
|
110
|
+
#
|
111
|
+
# object = mock()
|
112
|
+
# object.expects(:expected_method).at_least_once
|
113
|
+
# # => verify fails
|
114
|
+
def at_least_once
|
115
|
+
at_least(1)
|
116
|
+
self
|
117
|
+
end
|
118
|
+
|
119
|
+
# :call-seq: at_most(maximum_number_of_times) -> expectation
|
120
|
+
#
|
121
|
+
# Modifies expectation so that the expected method must be called at most a +maximum_number_of_times+.
|
122
|
+
# object = mock()
|
123
|
+
# object.expects(:expected_method).at_most(2)
|
124
|
+
# 2.times { object.expected_method }
|
125
|
+
# # => verify succeeds
|
126
|
+
#
|
127
|
+
# object = mock()
|
128
|
+
# object.expects(:expected_method).at_most(2)
|
129
|
+
# 3.times { object.expected_method }
|
130
|
+
# # => verify fails
|
131
|
+
def at_most(maximum_number_of_times)
|
132
|
+
@cardinality = Cardinality.at_most(maximum_number_of_times)
|
133
|
+
self
|
134
|
+
end
|
135
|
+
|
136
|
+
# :call-seq: at_most_once() -> expectation
|
137
|
+
#
|
138
|
+
# Modifies expectation so that the expected method must be called at most once.
|
139
|
+
# object = mock()
|
140
|
+
# object.expects(:expected_method).at_most_once
|
141
|
+
# object.expected_method
|
142
|
+
# # => verify succeeds
|
143
|
+
#
|
144
|
+
# object = mock()
|
145
|
+
# object.expects(:expected_method).at_most_once
|
146
|
+
# 2.times { object.expected_method }
|
147
|
+
# # => verify fails
|
148
|
+
def at_most_once()
|
149
|
+
at_most(1)
|
150
|
+
self
|
151
|
+
end
|
152
|
+
|
153
|
+
# :call-seq: with(*expected_parameters, &matching_block) -> expectation
|
154
|
+
#
|
155
|
+
# Modifies expectation so that the expected method must be called with +expected_parameters+.
|
156
|
+
# object = mock()
|
157
|
+
# object.expects(:expected_method).with(:param1, :param2)
|
158
|
+
# object.expected_method(:param1, :param2)
|
159
|
+
# # => verify succeeds
|
160
|
+
#
|
161
|
+
# object = mock()
|
162
|
+
# object.expects(:expected_method).with(:param1, :param2)
|
163
|
+
# object.expected_method(:param3)
|
164
|
+
# # => verify fails
|
165
|
+
# May be used with parameter matchers in Mocha::ParameterMatchers.
|
166
|
+
#
|
167
|
+
# If a +matching_block+ is given, the block is called with the parameters passed to the expected method.
|
168
|
+
# The expectation is matched if the block evaluates to +true+.
|
169
|
+
# object = mock()
|
170
|
+
# object.expects(:expected_method).with() { |value| value % 4 == 0 }
|
171
|
+
# object.expected_method(16)
|
172
|
+
# # => verify succeeds
|
173
|
+
#
|
174
|
+
# object = mock()
|
175
|
+
# object.expects(:expected_method).with() { |value| value % 4 == 0 }
|
176
|
+
# object.expected_method(17)
|
177
|
+
# # => verify fails
|
178
|
+
def with(*expected_parameters, &matching_block)
|
179
|
+
@parameters_matcher = ParametersMatcher.new(expected_parameters, &matching_block)
|
180
|
+
self
|
181
|
+
end
|
182
|
+
|
183
|
+
# :call-seq: yields(*parameters) -> expectation
|
184
|
+
#
|
185
|
+
# Modifies expectation so that when the expected method is called, it yields with the specified +parameters+.
|
186
|
+
# object = mock()
|
187
|
+
# object.expects(:expected_method).yields('result')
|
188
|
+
# yielded_value = nil
|
189
|
+
# object.expected_method { |value| yielded_value = value }
|
190
|
+
# yielded_value # => 'result'
|
191
|
+
# May be called multiple times on the same expectation for consecutive invocations. Also see Expectation#then.
|
192
|
+
# object = mock()
|
193
|
+
# object.stubs(:expected_method).yields(1).then.yields(2)
|
194
|
+
# yielded_values_from_first_invocation = []
|
195
|
+
# yielded_values_from_second_invocation = []
|
196
|
+
# object.expected_method { |value| yielded_values_from_first_invocation << value } # first invocation
|
197
|
+
# object.expected_method { |value| yielded_values_from_second_invocation << value } # second invocation
|
198
|
+
# yielded_values_from_first_invocation # => [1]
|
199
|
+
# yielded_values_from_second_invocation # => [2]
|
200
|
+
def yields(*parameters)
|
201
|
+
@yield_parameters.add(*parameters)
|
202
|
+
self
|
203
|
+
end
|
204
|
+
|
205
|
+
# :call-seq: multiple_yields(*parameter_groups) -> expectation
|
206
|
+
#
|
207
|
+
# Modifies expectation so that when the expected method is called, it yields multiple times per invocation with the specified +parameter_groups+.
|
208
|
+
# object = mock()
|
209
|
+
# object.expects(:expected_method).multiple_yields(['result_1', 'result_2'], ['result_3'])
|
210
|
+
# yielded_values = []
|
211
|
+
# object.expected_method { |*values| yielded_values << values }
|
212
|
+
# yielded_values # => [['result_1', 'result_2'], ['result_3]]
|
213
|
+
# May be called multiple times on the same expectation for consecutive invocations. Also see Expectation#then.
|
214
|
+
# object = mock()
|
215
|
+
# object.stubs(:expected_method).multiple_yields([1, 2], [3]).then.multiple_yields([4], [5, 6])
|
216
|
+
# yielded_values_from_first_invocation = []
|
217
|
+
# yielded_values_from_second_invocation = []
|
218
|
+
# object.expected_method { |*values| yielded_values_from_first_invocation << values } # first invocation
|
219
|
+
# object.expected_method { |*values| yielded_values_from_second_invocation << values } # second invocation
|
220
|
+
# yielded_values_from_first_invocation # => [[1, 2], [3]]
|
221
|
+
# yielded_values_from_second_invocation # => [[4], [5, 6]]
|
222
|
+
def multiple_yields(*parameter_groups)
|
223
|
+
@yield_parameters.multiple_add(*parameter_groups)
|
224
|
+
self
|
225
|
+
end
|
226
|
+
|
227
|
+
# :call-seq: returns(value) -> expectation
|
228
|
+
# returns(*values) -> expectation
|
229
|
+
#
|
230
|
+
# Modifies expectation so that when the expected method is called, it returns the specified +value+.
|
231
|
+
# object = mock()
|
232
|
+
# object.stubs(:stubbed_method).returns('result')
|
233
|
+
# object.stubbed_method # => 'result'
|
234
|
+
# object.stubbed_method # => 'result'
|
235
|
+
# If multiple +values+ are given, these are returned in turn on consecutive calls to the method.
|
236
|
+
# object = mock()
|
237
|
+
# object.stubs(:stubbed_method).returns(1, 2)
|
238
|
+
# object.stubbed_method # => 1
|
239
|
+
# object.stubbed_method # => 2
|
240
|
+
# May be called multiple times on the same expectation. Also see Expectation#then.
|
241
|
+
# object = mock()
|
242
|
+
# object.stubs(:expected_method).returns(1, 2).then.returns(3)
|
243
|
+
# object.expected_method # => 1
|
244
|
+
# object.expected_method # => 2
|
245
|
+
# object.expected_method # => 3
|
246
|
+
# May be called in conjunction with Expectation#raises on the same expectation.
|
247
|
+
# object = mock()
|
248
|
+
# object.stubs(:expected_method).returns(1, 2).then.raises(Exception)
|
249
|
+
# object.expected_method # => 1
|
250
|
+
# object.expected_method # => 2
|
251
|
+
# object.expected_method # => raises exception of class Exception1
|
252
|
+
# Note that in Ruby a method returning multiple values is exactly equivalent to a method returning an Array of those values.
|
253
|
+
# object = mock()
|
254
|
+
# object.stubs(:expected_method).returns([1, 2])
|
255
|
+
# x, y = object.expected_method
|
256
|
+
# x # => 1
|
257
|
+
# y # => 2
|
258
|
+
def returns(*values)
|
259
|
+
@return_values += ReturnValues.build(*values)
|
260
|
+
self
|
261
|
+
end
|
262
|
+
|
263
|
+
# :call-seq: raises(exception = RuntimeError, message = nil) -> expectation
|
264
|
+
#
|
265
|
+
# Modifies expectation so that when the expected method is called, it raises the specified +exception+ with the specified +message+.
|
266
|
+
# object = mock()
|
267
|
+
# object.expects(:expected_method).raises(Exception, 'message')
|
268
|
+
# object.expected_method # => raises exception of class Exception and with message 'message'
|
269
|
+
# May be called multiple times on the same expectation. Also see Expectation#then.
|
270
|
+
# object = mock()
|
271
|
+
# object.stubs(:expected_method).raises(Exception1).then.raises(Exception2)
|
272
|
+
# object.expected_method # => raises exception of class Exception1
|
273
|
+
# object.expected_method # => raises exception of class Exception2
|
274
|
+
# May be called in conjunction with Expectation#returns on the same expectation.
|
275
|
+
# object = mock()
|
276
|
+
# object.stubs(:expected_method).raises(Exception).then.returns(2, 3)
|
277
|
+
# object.expected_method # => raises exception of class Exception1
|
278
|
+
# object.expected_method # => 2
|
279
|
+
# object.expected_method # => 3
|
280
|
+
def raises(exception = RuntimeError, message = nil)
|
281
|
+
@return_values += ReturnValues.new(ExceptionRaiser.new(exception, message))
|
282
|
+
self
|
283
|
+
end
|
284
|
+
|
285
|
+
# :call-seq: then() -> expectation
|
286
|
+
# then(state_machine.is(state)) -> expectation
|
287
|
+
#
|
288
|
+
# <tt>then()</tt> is used as syntactic sugar to improve readability. It has no effect on state of the expectation.
|
289
|
+
# object = mock()
|
290
|
+
# object.stubs(:expected_method).returns(1, 2).then.raises(Exception).then.returns(4)
|
291
|
+
# object.expected_method # => 1
|
292
|
+
# object.expected_method # => 2
|
293
|
+
# object.expected_method # => raises exception of class Exception
|
294
|
+
# object.expected_method # => 4
|
295
|
+
#
|
296
|
+
# <tt>then(state_machine.is(state))</tt> is used to change the +state_machine+ to the specified +state+ when the invocation occurs.
|
297
|
+
#
|
298
|
+
# See also Standalone#states, StateMachine and Expectation#when.
|
299
|
+
# power = states('power').starts_as('off')
|
300
|
+
#
|
301
|
+
# radio = mock('radio')
|
302
|
+
# radio.expects(:switch_on).then(power.is('on'))
|
303
|
+
# radio.expects(:select_channel).with('BBC Radio 4').when(power.is('on'))
|
304
|
+
# radio.expects(:adjust_volume).with(+5).when(power.is('on'))
|
305
|
+
# radio.expects(:select_channel).with('BBC World Service').when(power.is('on'))
|
306
|
+
# radio.expects(:adjust_volume).with(-5).when(power.is('on'))
|
307
|
+
# radio.expects(:switch_off).then(power.is('off'))
|
308
|
+
def then(*parameters)
|
309
|
+
if parameters.length == 1
|
310
|
+
state = parameters.first
|
311
|
+
add_side_effect(ChangeStateSideEffect.new(state))
|
312
|
+
end
|
313
|
+
self
|
314
|
+
end
|
315
|
+
|
316
|
+
# :call-seq: when(state_machine.is(state)) -> exception
|
317
|
+
#
|
318
|
+
# Constrains the expectation to occur only when the +state_machine+ is in the named +state+.
|
319
|
+
#
|
320
|
+
# See also Standalone#states, StateMachine#starts_as and Expectation#then.
|
321
|
+
# power = states('power').starts_as('off')
|
322
|
+
#
|
323
|
+
# radio = mock('radio')
|
324
|
+
# radio.expects(:switch_on).then(power.is('on'))
|
325
|
+
# radio.expects(:select_channel).with('BBC Radio 4').when(power.is('on'))
|
326
|
+
# radio.expects(:adjust_volume).with(+5).when(power.is('on'))
|
327
|
+
# radio.expects(:select_channel).with('BBC World Service').when(power.is('on'))
|
328
|
+
# radio.expects(:adjust_volume).with(-5).when(power.is('on'))
|
329
|
+
# radio.expects(:switch_off).then(power.is('off'))
|
330
|
+
def when(state_predicate)
|
331
|
+
add_ordering_constraint(InStateOrderingConstraint.new(state_predicate))
|
332
|
+
self
|
333
|
+
end
|
334
|
+
|
335
|
+
# :call-seq: in_sequence(*sequences) -> expectation
|
336
|
+
#
|
337
|
+
# Constrains this expectation so that it must be invoked at the current point in the sequence.
|
338
|
+
#
|
339
|
+
# To expect a sequence of invocations, write the expectations in order and add the in_sequence(sequence) clause to each one.
|
340
|
+
#
|
341
|
+
# Expectations in a sequence can have any invocation count.
|
342
|
+
#
|
343
|
+
# If an expectation in a sequence is stubbed, rather than expected, it can be skipped in the sequence.
|
344
|
+
#
|
345
|
+
# See also Standalone#sequence.
|
346
|
+
# breakfast = sequence('breakfast')
|
347
|
+
#
|
348
|
+
# egg = mock('egg')
|
349
|
+
# egg.expects(:crack).in_sequence(breakfast)
|
350
|
+
# egg.expects(:fry).in_sequence(breakfast)
|
351
|
+
# egg.expects(:eat).in_sequence(breakfast)
|
352
|
+
def in_sequence(*sequences)
|
353
|
+
sequences.each { |sequence| add_in_sequence_ordering_constraint(sequence) }
|
354
|
+
self
|
355
|
+
end
|
356
|
+
|
357
|
+
# :stopdoc:
|
358
|
+
|
359
|
+
attr_reader :backtrace
|
360
|
+
|
361
|
+
def initialize(mock, expected_method_name, backtrace = nil)
|
362
|
+
@mock = mock
|
363
|
+
@method_matcher = MethodMatcher.new(expected_method_name.to_sym)
|
364
|
+
@parameters_matcher = ParametersMatcher.new
|
365
|
+
@ordering_constraints = []
|
366
|
+
@side_effects = []
|
367
|
+
@cardinality, @invocation_count = Cardinality.exactly(1), 0
|
368
|
+
@return_values = ReturnValues.new
|
369
|
+
@yield_parameters = YieldParameters.new
|
370
|
+
@backtrace = backtrace || caller
|
371
|
+
end
|
372
|
+
|
373
|
+
def add_ordering_constraint(ordering_constraint)
|
374
|
+
@ordering_constraints << ordering_constraint
|
375
|
+
end
|
376
|
+
|
377
|
+
def add_in_sequence_ordering_constraint(sequence)
|
378
|
+
sequence.constrain_as_next_in_sequence(self)
|
379
|
+
end
|
380
|
+
|
381
|
+
def add_side_effect(side_effect)
|
382
|
+
@side_effects << side_effect
|
383
|
+
end
|
384
|
+
|
385
|
+
def perform_side_effects
|
386
|
+
@side_effects.each { |side_effect| side_effect.perform }
|
387
|
+
end
|
388
|
+
|
389
|
+
def in_correct_order?
|
390
|
+
@ordering_constraints.all? { |ordering_constraint| ordering_constraint.allows_invocation_now? }
|
391
|
+
end
|
392
|
+
|
393
|
+
def matches_method?(method_name)
|
394
|
+
@method_matcher.match?(method_name)
|
395
|
+
end
|
396
|
+
|
397
|
+
def match?(actual_method_name, *actual_parameters)
|
398
|
+
@method_matcher.match?(actual_method_name) && @parameters_matcher.match?(actual_parameters) && in_correct_order?
|
399
|
+
end
|
400
|
+
|
401
|
+
def invocations_allowed?
|
402
|
+
@cardinality.invocations_allowed?(@invocation_count)
|
403
|
+
end
|
404
|
+
|
405
|
+
def satisfied?
|
406
|
+
@cardinality.satisfied?(@invocation_count)
|
407
|
+
end
|
408
|
+
|
409
|
+
def invoke
|
410
|
+
@invocation_count += 1
|
411
|
+
perform_side_effects()
|
412
|
+
if block_given? then
|
413
|
+
@yield_parameters.next_invocation.each do |yield_parameters|
|
414
|
+
yield(*yield_parameters)
|
415
|
+
end
|
416
|
+
end
|
417
|
+
@return_values.next
|
418
|
+
end
|
419
|
+
|
420
|
+
def verified?(assertion_counter = nil)
|
421
|
+
assertion_counter.increment if assertion_counter && @cardinality.needs_verifying?
|
422
|
+
@cardinality.verified?(@invocation_count)
|
423
|
+
end
|
424
|
+
|
425
|
+
def used?
|
426
|
+
@cardinality.used?(@invocation_count)
|
427
|
+
end
|
428
|
+
|
429
|
+
def mocha_inspect
|
430
|
+
message = "#{@cardinality.mocha_inspect}, "
|
431
|
+
message << case @invocation_count
|
432
|
+
when 0 then "not yet invoked"
|
433
|
+
when 1 then "already invoked once"
|
434
|
+
when 2 then "already invoked twice"
|
435
|
+
else "already invoked #{@invocation_count} times"
|
436
|
+
end
|
437
|
+
message << ": "
|
438
|
+
message << method_signature
|
439
|
+
message << "; #{@ordering_constraints.map { |oc| oc.mocha_inspect }.join("; ")}" unless @ordering_constraints.empty?
|
440
|
+
message
|
441
|
+
end
|
442
|
+
|
443
|
+
def method_signature
|
444
|
+
"#{@mock.mocha_inspect}.#{@method_matcher.mocha_inspect}#{@parameters_matcher.mocha_inspect}"
|
445
|
+
end
|
446
|
+
|
447
|
+
# :startdoc:
|
448
|
+
|
449
|
+
end
|
450
|
+
|
451
|
+
end
|