rspec-mocks 2.99.4 → 3.0.0.beta1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +14 -6
- checksums.yaml.gz.sig +2 -0
- data.tar.gz.sig +1 -0
- data/Changelog.md +89 -105
- data/License.txt +1 -0
- data/README.md +77 -57
- data/features/argument_matchers/explicit.feature +5 -5
- data/features/argument_matchers/general_matchers.feature +10 -10
- data/features/argument_matchers/type_matchers.feature +3 -3
- data/features/message_expectations/allow_any_instance_of.feature +1 -1
- data/features/message_expectations/any_instance.feature +27 -5
- data/features/message_expectations/call_original.feature +2 -2
- data/features/message_expectations/expect_message_using_expect.feature +2 -2
- data/features/message_expectations/expect_message_using_should_receive.feature +2 -2
- data/features/message_expectations/receive_counts.feature +7 -7
- data/features/message_expectations/warn_when_expectation_is_set_on_nil.feature +3 -3
- data/features/method_stubs/README.md +3 -0
- data/features/method_stubs/any_instance.feature +11 -11
- data/features/method_stubs/as_null_object.feature +4 -4
- data/features/method_stubs/simple_return_value_with_stub.feature +7 -7
- data/features/method_stubs/stub_chain.feature +3 -3
- data/features/method_stubs/stub_implementation.feature +2 -2
- data/features/method_stubs/to_ary.feature +2 -2
- data/features/mutating_constants/hiding_defined_constant.feature +2 -2
- data/features/mutating_constants/stub_defined_constant.feature +5 -5
- data/features/mutating_constants/stub_undefined_constant.feature +6 -6
- data/features/outside_rspec/configuration.feature +0 -2
- data/features/outside_rspec/standalone.feature +1 -1
- data/features/spies/spy_partial_mock_method.feature +2 -2
- data/features/spies/spy_pure_mock_method.feature +5 -5
- data/features/spies/spy_unstubbed_method.feature +1 -1
- data/features/support/env.rb +10 -1
- data/features/test_frameworks/test_unit.feature +1 -1
- data/features/verifying_doubles/class_doubles.feature +88 -0
- data/features/verifying_doubles/dynamic_classes.feature +72 -0
- data/features/verifying_doubles/introduction.feature +85 -0
- data/features/verifying_doubles/object_doubles.feature +65 -0
- data/features/verifying_doubles/partial_doubles.feature +34 -0
- data/lib/rspec/mocks.rb +8 -34
- data/lib/rspec/mocks/any_instance/chain.rb +4 -34
- data/lib/rspec/mocks/any_instance/expectation_chain.rb +14 -4
- data/lib/rspec/mocks/any_instance/message_chains.rb +27 -12
- data/lib/rspec/mocks/any_instance/recorder.rb +23 -31
- data/lib/rspec/mocks/any_instance/stub_chain.rb +9 -4
- data/lib/rspec/mocks/argument_list_matcher.rb +8 -1
- data/lib/rspec/mocks/argument_matchers.rb +26 -12
- data/lib/rspec/mocks/arity_calculator.rb +66 -0
- data/lib/rspec/mocks/configuration.rb +42 -14
- data/lib/rspec/mocks/error_generator.rb +34 -10
- data/lib/rspec/mocks/example_methods.rb +64 -19
- data/lib/rspec/mocks/extensions/marshal.rb +0 -15
- data/lib/rspec/mocks/framework.rb +4 -4
- data/lib/rspec/mocks/instance_method_stasher.rb +80 -62
- data/lib/rspec/mocks/matchers/have_received.rb +18 -14
- data/lib/rspec/mocks/matchers/receive.rb +29 -7
- data/lib/rspec/mocks/matchers/receive_messages.rb +72 -0
- data/lib/rspec/mocks/message_expectation.rb +95 -148
- data/lib/rspec/mocks/method_double.rb +77 -139
- data/lib/rspec/mocks/method_reference.rb +95 -0
- data/lib/rspec/mocks/mock.rb +1 -1
- data/lib/rspec/mocks/mutate_const.rb +12 -9
- data/lib/rspec/mocks/object_reference.rb +90 -0
- data/lib/rspec/mocks/order_group.rb +49 -7
- data/lib/rspec/mocks/proxy.rb +72 -33
- data/lib/rspec/mocks/proxy_for_nil.rb +2 -2
- data/lib/rspec/mocks/space.rb +13 -18
- data/lib/rspec/mocks/stub_chain.rb +2 -2
- data/lib/rspec/mocks/syntax.rb +61 -36
- data/lib/rspec/mocks/targets.rb +40 -19
- data/lib/rspec/mocks/test_double.rb +12 -56
- data/lib/rspec/mocks/verifying_double.rb +77 -0
- data/lib/rspec/mocks/verifying_message_expecation.rb +60 -0
- data/lib/rspec/mocks/verifying_proxy.rb +151 -0
- data/lib/rspec/mocks/version.rb +1 -1
- data/spec/rspec/mocks/and_call_original_spec.rb +34 -30
- data/spec/rspec/mocks/and_yield_spec.rb +2 -2
- data/spec/rspec/mocks/any_instance/message_chains_spec.rb +1 -1
- data/spec/rspec/mocks/any_instance_spec.rb +53 -260
- data/spec/rspec/mocks/argument_expectation_spec.rb +4 -4
- data/spec/rspec/mocks/arity_calculator_spec.rb +95 -0
- data/spec/rspec/mocks/array_including_matcher_spec.rb +41 -0
- data/spec/rspec/mocks/at_least_spec.rb +4 -32
- data/spec/rspec/mocks/block_return_value_spec.rb +4 -135
- data/spec/rspec/mocks/combining_implementation_instructions_spec.rb +10 -11
- data/spec/rspec/mocks/configuration_spec.rb +79 -0
- data/spec/rspec/mocks/double_spec.rb +10 -78
- data/spec/rspec/mocks/extensions/marshal_spec.rb +0 -8
- data/spec/rspec/mocks/failing_argument_matchers_spec.rb +49 -4
- data/spec/rspec/mocks/instance_method_stasher_spec.rb +20 -3
- data/spec/rspec/mocks/matchers/have_received_spec.rb +74 -0
- data/spec/rspec/mocks/matchers/receive_messages_spec.rb +140 -0
- data/spec/rspec/mocks/matchers/receive_spec.rb +82 -42
- data/spec/rspec/mocks/methods_spec.rb +1 -1
- data/spec/rspec/mocks/{bug_report_830_spec.rb → mock_expectation_error_spec.rb} +4 -3
- data/spec/rspec/mocks/mock_ordering_spec.rb +11 -0
- data/spec/rspec/mocks/mock_space_spec.rb +10 -1
- data/spec/rspec/mocks/mock_spec.rb +26 -82
- data/spec/rspec/mocks/multiple_return_value_spec.rb +1 -1
- data/spec/rspec/mocks/mutate_const_spec.rb +18 -5
- data/spec/rspec/mocks/null_object_mock_spec.rb +6 -4
- data/spec/rspec/mocks/options_hash_spec.rb +3 -3
- data/spec/rspec/mocks/order_group_spec.rb +27 -0
- data/spec/rspec/mocks/partial_mock_spec.rb +101 -1
- data/spec/rspec/mocks/passing_argument_matchers_spec.rb +3 -20
- data/spec/rspec/mocks/record_messages_spec.rb +4 -4
- data/spec/rspec/mocks/serialization_spec.rb +4 -6
- data/spec/rspec/mocks/space_spec.rb +3 -3
- data/spec/rspec/mocks/stub_chain_spec.rb +0 -12
- data/spec/rspec/mocks/stub_spec.rb +23 -44
- data/spec/rspec/mocks/test_double_spec.rb +3 -22
- data/spec/rspec/mocks/verifying_double_spec.rb +327 -0
- data/spec/rspec/mocks/verifying_message_expecation_spec.rb +68 -0
- data/spec/rspec/mocks_spec.rb +16 -39
- data/spec/spec_helper.rb +29 -18
- metadata +131 -86
- metadata.gz.sig +1 -0
- data/features/message_expectations/expect_any_instance_of.feature +0 -27
- data/lib/rspec/mocks/caller_filter.rb +0 -60
- data/lib/rspec/mocks/deprecation.rb +0 -26
- data/lib/rspec/mocks/extensions/instance_exec.rb +0 -34
- data/lib/rspec/mocks/extensions/proc.rb +0 -63
- data/lib/spec/mocks.rb +0 -4
- data/spec/rspec/mocks/and_return_spec.rb +0 -17
- data/spec/rspec/mocks/any_number_of_times_spec.rb +0 -36
- data/spec/rspec/mocks/before_all_spec.rb +0 -74
- data/spec/rspec/mocks/bug_report_10260_spec.rb +0 -8
- data/spec/rspec/mocks/bug_report_10263_spec.rb +0 -27
- data/spec/rspec/mocks/bug_report_11545_spec.rb +0 -32
- data/spec/rspec/mocks/bug_report_496_spec.rb +0 -17
- data/spec/rspec/mocks/bug_report_600_spec.rb +0 -22
- data/spec/rspec/mocks/bug_report_7611_spec.rb +0 -16
- data/spec/rspec/mocks/bug_report_8165_spec.rb +0 -31
- data/spec/rspec/mocks/bug_report_957_spec.rb +0 -22
checksums.yaml
CHANGED
|
@@ -1,7 +1,15 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
|
-
metadata.gz:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
2
|
+
!binary "U0hBMQ==":
|
|
3
|
+
metadata.gz: !binary |-
|
|
4
|
+
MWQyODY3ZjBkNmUxYWY1ZjFlZWNlM2Q0NjZlY2M1OTEwOTI3N2E1ZQ==
|
|
5
|
+
data.tar.gz: !binary |-
|
|
6
|
+
YzI0OGE3YzFmZDQ4MTc5ZmJlODExYjNjNDE5MzMyOGI4ZTE2ZDY2MQ==
|
|
7
|
+
!binary "U0hBNTEy":
|
|
8
|
+
metadata.gz: !binary |-
|
|
9
|
+
OTA4ZmE4NjJhNDhjYTFmMWU4MmM3OTkzMTk3OTQ3M2YyYTNmMzljYzQzNDFm
|
|
10
|
+
MjgwMzE0NDlmZDFmYzVkMzIwZWIzOGYxNjZlN2U1MDMwZDIwNGYxZDkzYWFj
|
|
11
|
+
MDAzM2NmMWEyNDA1NTg5OTBmMzViMzdhYjRlMTUyODNmMDJkMjU=
|
|
12
|
+
data.tar.gz: !binary |-
|
|
13
|
+
YjExYjNmYzZhMTAyZjQyN2RjNWY1NmNhMjRiNmU5NDhjOTY0NWNiYzMxOWUy
|
|
14
|
+
MGMzOGIzOTYzNDhmOWNlNzVkODQ5ZmYyN2RmN2MwZGM2ZThmMWIwY2U3NGIx
|
|
15
|
+
M2Q3ZTFhNTVkZjFjZmJhNmQ4M2NkNTJhMGRiN2IzMmY3ZThkNGQ=
|
checksums.yaml.gz.sig
ADDED
data.tar.gz.sig
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
�旺]v�����h��( *�z(��������:�d-XH�?ibI�4L� �0*�ʆ ˫K��Y?D��u<��);�p��]8�ҥ��P��8�ۥ��v<�MZ�M@���3��ӑ۶�Y���Ͷ�D�ОP �Mɭ �(B�[�Vk�"8��)'�Hs�%�j�ldyg�����Ԅ�f��đ��)�ѻ�gb�L��K��;7r)գC�1�� �lN�vKϣ!���Qr$9�P�ZI� u�'�a��=[�6/e
|
data/Changelog.md
CHANGED
|
@@ -1,70 +1,71 @@
|
|
|
1
|
-
###
|
|
2
|
-
[
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
*
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
1
|
+
### 3.0.0.beta1 / 2013-11-07
|
|
2
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.99.0.beta1...v3.0.0.beta1)
|
|
3
|
+
|
|
4
|
+
Breaking Changes for 3.0.0:
|
|
5
|
+
|
|
6
|
+
* Raise an explicit error if `should_not_receive(...).and_return` is used. (Sam
|
|
7
|
+
Phippen)
|
|
8
|
+
* Remove 1.8.6 workarounds. (Jon Rowe)
|
|
9
|
+
* Remove `stub!` and `unstub!`. (Sam Phippen)
|
|
10
|
+
* Remove `mock(name, methods)` and `stub(name, methods)`, leaving
|
|
11
|
+
`double(name, methods)` for creating test doubles. (Sam Phippen, Michi Huber)
|
|
12
|
+
* Remove `any_number_of_times` since `should_receive(:msg).any_number_of_times`
|
|
13
|
+
is really a stub in a mock's clothing. (Sam Phippen)
|
|
14
|
+
* Remove support for re-using the same null-object test double in multiple
|
|
15
|
+
examples. Test doubles are designed to only live for one example.
|
|
16
|
+
(Myron Marston)
|
|
17
|
+
* Make `at_least(0)` raise an error. (Sam Phippen)
|
|
18
|
+
* Remove support for `require 'spec/mocks'` which had been kept
|
|
19
|
+
in place for backwards compatibility with RSpec 1. (Myron Marston)
|
|
20
|
+
* Blocks provided to `with` are always used as implementation. (Xavier Shay)
|
|
21
|
+
* The config option (added in 2.99) to yield the receiver to
|
|
22
|
+
`any_instance` implementation blocks now defaults to "on". (Sam Phippen)
|
|
17
23
|
|
|
18
24
|
Enhancements:
|
|
19
25
|
|
|
20
|
-
*
|
|
21
|
-
(
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
*
|
|
29
|
-
|
|
26
|
+
* Allow the `have_received` matcher to use a block to set further expectations
|
|
27
|
+
on arguments. (Tim Cowlishaw)
|
|
28
|
+
* Provide `instance_double` and `class_double` to create verifying doubles,
|
|
29
|
+
ported from `rspec-fire`. (Xavier Shay)
|
|
30
|
+
* `as_null_object` on a verifying double only responds to defined methods.
|
|
31
|
+
(Xavier Shay)
|
|
32
|
+
* Provide `object_double` to create verified doubles of specific object
|
|
33
|
+
instances. (Xavier Shay)
|
|
34
|
+
* Provide 'verify_partial_doubles` configuration that provides `object_double`
|
|
35
|
+
like verification behaviour on partial mocks. (Xavier Shay)
|
|
36
|
+
* Improved performance of double creation, particularly those with many
|
|
37
|
+
attributes. (Xavier Shay)
|
|
38
|
+
* Default value of `transfer_nested_constants` option for constant stubbing can
|
|
39
|
+
be configured. (Xavier Shay)
|
|
40
|
+
* Messages can be allowed or expected on in bulk via
|
|
41
|
+
`receive_messages(:message => :value)`. (Jon Rowe)
|
|
42
|
+
* `allow(Klass.any_instance)` and `expect(Klass.any_instance)` now print a
|
|
43
|
+
warning. This is usually a mistake, and users usually want
|
|
44
|
+
`allow_any_instance_of` or `expect_any_instance_of` instead. (Sam Phippen)
|
|
45
|
+
* `instance_double` and `class_double` raise `ArgumentError` if the underlying
|
|
46
|
+
module is loaded and the arity of the method being invoked does not match the
|
|
47
|
+
arity of the method as it is actually implemented. (Andy Lindeman)
|
|
48
|
+
* Spies can now check their invocation ordering is correct. (Jon Rowe)
|
|
30
49
|
|
|
31
50
|
Deprecations:
|
|
32
51
|
|
|
33
|
-
*
|
|
52
|
+
* Using the old `:should` syntax without explicitly configuring it
|
|
53
|
+
is disabled. It will continue to work but will emit a deprecation
|
|
54
|
+
warning in RSpec 3 if you do not explicitly enable it. (Sam Phippen)
|
|
34
55
|
|
|
35
|
-
|
|
36
|
-
[Full Changelog](http://github.com/rspec/rspec-mocks/compare/v2.99.0.rc1...v2.99.0)
|
|
37
|
-
|
|
38
|
-
No changes. Just taking it out of pre-release.
|
|
39
|
-
|
|
40
|
-
### 2.99.0.rc1 / 2014-05-18
|
|
41
|
-
[Full Changelog](http://github.com/rspec/rspec-mocks/compare/v2.99.0.beta2...v2.99.0.rc1)
|
|
42
|
-
|
|
43
|
-
Deprecations:
|
|
44
|
-
|
|
45
|
-
* Deprecate `RSpec::Mocks::TestDouble.extend_onto`. (Myron Marston)
|
|
46
|
-
* Deprecate `RSpec::Mocks::ConstantStubber`. (Jon Rowe)
|
|
47
|
-
* Deprecate `Marshal.dump` monkey-patch without opt-in. (Xavier Shay)
|
|
48
|
-
|
|
49
|
-
### 2.99.0.beta2 / 2014-02-17
|
|
50
|
-
[Full Changelog](http://github.com/rspec/rspec-mocks/compare/v2.99.0.beta1...v2.99.0.beta2)
|
|
51
|
-
|
|
52
|
-
Deprecations:
|
|
56
|
+
Bug Fixes:
|
|
53
57
|
|
|
54
|
-
*
|
|
55
|
-
(Myron Marston)
|
|
56
|
-
*
|
|
57
|
-
`
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
lifecycle (e.g. from a `before(:all)` hook). (Myron Marston)
|
|
61
|
-
* Deprecate re-using a test double in another example. (Myron Marston)
|
|
62
|
-
* Deprecate `and_return { value }` and `and_return` without arguments. (Yuji Nakayama)
|
|
58
|
+
* Fix `and_call_original` to handle a complex edge case involving
|
|
59
|
+
singleton class ancestors. (Marc-André Lafortune, Myron Marston)
|
|
60
|
+
* When generating an error message for unexpected arguments,
|
|
61
|
+
use `#inspect` rather than `#description` if `#description`
|
|
62
|
+
returns `nil` or `''` so that you still get a useful message.
|
|
63
|
+
(Nick DeLuca)
|
|
63
64
|
|
|
64
65
|
### 2.99.0.beta1 / 2013-11-07
|
|
65
|
-
[
|
|
66
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.4...v2.99.0.beta1)
|
|
66
67
|
|
|
67
|
-
Deprecations
|
|
68
|
+
Deprecations
|
|
68
69
|
|
|
69
70
|
* Expecting to use lambdas or other strong arity implementations for stub
|
|
70
71
|
methods with mis-matched arity is deprecated and support for them will be
|
|
@@ -86,26 +87,8 @@ Enhancements:
|
|
|
86
87
|
* Add a config option to yield the receiver to `any_instance` implementation
|
|
87
88
|
blocks. (Sam Phippen)
|
|
88
89
|
|
|
89
|
-
### 2.14.6 / 2014-02-20
|
|
90
|
-
[Full Changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.5...v2.14.6)
|
|
91
|
-
|
|
92
|
-
Bug Fixes:
|
|
93
|
-
|
|
94
|
-
* Ensure `any_instance` method stubs and expectations are torn down regardless of
|
|
95
|
-
expectation failures. (Sam Phippen)
|
|
96
|
-
|
|
97
|
-
### 2.14.5 / 2014-02-01
|
|
98
|
-
[Full Changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.4...v2.14.5)
|
|
99
|
-
|
|
100
|
-
Bug Fixes:
|
|
101
|
-
|
|
102
|
-
* Fix regression that caused block implementations to not receive all
|
|
103
|
-
args on 1.8.7 if the block also receives a block, due to Proc#arity
|
|
104
|
-
reporting `1` no matter how many args the block receives if it
|
|
105
|
-
receives a block, too. (Myron Marston)
|
|
106
|
-
|
|
107
90
|
### 2.14.4 / 2013-10-15
|
|
108
|
-
[
|
|
91
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.3...v2.14.4)
|
|
109
92
|
|
|
110
93
|
Bug Fixes:
|
|
111
94
|
|
|
@@ -115,7 +98,7 @@ Bug Fixes:
|
|
|
115
98
|
the usage of modifications (`and_return` etc) (Jon Rowe)
|
|
116
99
|
|
|
117
100
|
### 2.14.3 / 2013-08-08
|
|
118
|
-
[
|
|
101
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.2...v2.14.3)
|
|
119
102
|
|
|
120
103
|
Bug Fixes:
|
|
121
104
|
|
|
@@ -123,7 +106,7 @@ Bug Fixes:
|
|
|
123
106
|
a prepended Module (Bradley Schaefer)
|
|
124
107
|
|
|
125
108
|
### 2.14.2 / 2013-07-30
|
|
126
|
-
[
|
|
109
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.1...v2.14.2)
|
|
127
110
|
|
|
128
111
|
Bug Fixes:
|
|
129
112
|
|
|
@@ -133,7 +116,7 @@ Bug Fixes:
|
|
|
133
116
|
return a test double rather than stub a method (Myron Marston).
|
|
134
117
|
|
|
135
118
|
### 2.14.1 / 2013-07-07
|
|
136
|
-
[
|
|
119
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.0...v2.14.1)
|
|
137
120
|
|
|
138
121
|
Bug Fixes:
|
|
139
122
|
|
|
@@ -145,7 +128,7 @@ Bug Fixes:
|
|
|
145
128
|
in 3.0. (Myron Marston)
|
|
146
129
|
|
|
147
130
|
### 2.14.0 / 2013-07-06
|
|
148
|
-
[
|
|
131
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.14.0.rc1...v2.14.0)
|
|
149
132
|
|
|
150
133
|
Enhancements:
|
|
151
134
|
|
|
@@ -169,7 +152,7 @@ Bug Fixes:
|
|
|
169
152
|
similar preloading gems (Andy Lindeman).
|
|
170
153
|
|
|
171
154
|
### 2.14.0.rc1 / 2013-05-27
|
|
172
|
-
[
|
|
155
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.13.0...v2.14.0.rc1)
|
|
173
156
|
|
|
174
157
|
Enhancements:
|
|
175
158
|
|
|
@@ -207,6 +190,7 @@ Bug fixes
|
|
|
207
190
|
(Luke Imhoff, Jon Rowe)
|
|
208
191
|
* Fix isolation of `allow_message_expectations_on_nil` (Jon Rowe)
|
|
209
192
|
* Use inspect to format actual arguments on expectations in failure messages (#280, Ben Langfeld)
|
|
193
|
+
* Protect against improperly initialised test doubles (#293) (Joseph Shraibman and Jon Rowe)
|
|
210
194
|
|
|
211
195
|
Deprecations
|
|
212
196
|
|
|
@@ -218,7 +202,7 @@ Deprecations
|
|
|
218
202
|
* Deprecate `at_least(0).times` and `any_number_of_times` (Michi Huber).
|
|
219
203
|
|
|
220
204
|
### 2.13.1 / 2013-04-06
|
|
221
|
-
[
|
|
205
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.13.0...v2.13.1)
|
|
222
206
|
|
|
223
207
|
Bug fixes
|
|
224
208
|
|
|
@@ -226,7 +210,7 @@ Bug fixes
|
|
|
226
210
|
`and_yield`, `and_raise`, `and_return` or `and_throw` (Myron Marston).
|
|
227
211
|
|
|
228
212
|
### 2.13.0 / 2013-02-23
|
|
229
|
-
[
|
|
213
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.12.2...v2.13.0)
|
|
230
214
|
|
|
231
215
|
Bug fixes
|
|
232
216
|
|
|
@@ -256,7 +240,7 @@ Bug fixes
|
|
|
256
240
|
(Myron Marston).
|
|
257
241
|
|
|
258
242
|
### 2.12.2 / 2013-01-27
|
|
259
|
-
[
|
|
243
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.12.1...v.2.12.2)
|
|
260
244
|
|
|
261
245
|
Bug fixes
|
|
262
246
|
|
|
@@ -271,7 +255,7 @@ Bug fixes
|
|
|
271
255
|
versions (Andy Lindeman).
|
|
272
256
|
|
|
273
257
|
### 2.12.1 / 2012-12-21
|
|
274
|
-
[
|
|
258
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.12.0...v2.12.1)
|
|
275
259
|
|
|
276
260
|
Bug fixes
|
|
277
261
|
|
|
@@ -283,7 +267,7 @@ Bug fixes
|
|
|
283
267
|
work properly with constant strings that are prefixed with `::` (Myron Marston).
|
|
284
268
|
|
|
285
269
|
### 2.12.0 / 2012-11-12
|
|
286
|
-
[
|
|
270
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.11.3...v2.12.0)
|
|
287
271
|
|
|
288
272
|
Enhancements
|
|
289
273
|
|
|
@@ -299,7 +283,7 @@ Deprecations:
|
|
|
299
283
|
(Neha Kumari)
|
|
300
284
|
|
|
301
285
|
### 2.11.3 / 2012-09-19
|
|
302
|
-
[
|
|
286
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.11.2...v2.11.3)
|
|
303
287
|
|
|
304
288
|
Bug fixes
|
|
305
289
|
|
|
@@ -313,7 +297,7 @@ Bug fixes
|
|
|
313
297
|
extra time with the wrong arguments (Myron Marston).
|
|
314
298
|
|
|
315
299
|
### 2.11.2 / 2012-08-11
|
|
316
|
-
[
|
|
300
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.11.1...v2.11.2)
|
|
317
301
|
|
|
318
302
|
Bug fixes
|
|
319
303
|
|
|
@@ -325,7 +309,7 @@ Bug fixes
|
|
|
325
309
|
Marston)
|
|
326
310
|
|
|
327
311
|
### 2.11.1 / 2012-07-09
|
|
328
|
-
[
|
|
312
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.11.0...v2.11.1)
|
|
329
313
|
|
|
330
314
|
Bug fixes
|
|
331
315
|
|
|
@@ -335,7 +319,7 @@ Bug fixes
|
|
|
335
319
|
overriden with the null object implementation--`return self`). (Myron Marston)
|
|
336
320
|
|
|
337
321
|
### 2.11.0 / 2012-07-07
|
|
338
|
-
[
|
|
322
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.10.1...v2.11.0)
|
|
339
323
|
|
|
340
324
|
Enhancements
|
|
341
325
|
|
|
@@ -360,7 +344,7 @@ Bug fixes
|
|
|
360
344
|
`Exception` by default, just like ruby does. (Andrew Marshall)
|
|
361
345
|
|
|
362
346
|
### 2.10.1 / 2012-05-05
|
|
363
|
-
[
|
|
347
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.10.0...v2.10.1)
|
|
364
348
|
|
|
365
349
|
Bug fixes
|
|
366
350
|
|
|
@@ -370,14 +354,14 @@ Bug fixes
|
|
|
370
354
|
* fixed failure of `object.should_not_receive(:message).and_return value`
|
|
371
355
|
|
|
372
356
|
### 2.10.0 / 2012-05-03
|
|
373
|
-
[
|
|
357
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.9.0...v2.10.0)
|
|
374
358
|
|
|
375
359
|
Bug fixes
|
|
376
360
|
|
|
377
361
|
* fail fast when an `exactly` or `at_most` expectation is exceeded
|
|
378
362
|
|
|
379
363
|
### 2.9.0 / 2012-03-17
|
|
380
|
-
[
|
|
364
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.8.0...v2.9.0)
|
|
381
365
|
|
|
382
366
|
Enhancements
|
|
383
367
|
|
|
@@ -392,19 +376,19 @@ Bug fixes
|
|
|
392
376
|
|
|
393
377
|
### 2.8.0 / 2012-01-04
|
|
394
378
|
|
|
395
|
-
[
|
|
379
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.8.0.rc2...v2.8.0)
|
|
396
380
|
|
|
397
381
|
No changes for this release. Just releasing with the other rspec gems.
|
|
398
382
|
|
|
399
383
|
### 2.8.0.rc2 / 2011-12-19
|
|
400
384
|
|
|
401
|
-
[
|
|
385
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.8.0.rc1...v2.8.0.rc2)
|
|
402
386
|
|
|
403
387
|
No changes for this release. Just releasing with the other rspec gems.
|
|
404
388
|
|
|
405
389
|
### 2.8.0.rc1 / 2011-11-06
|
|
406
390
|
|
|
407
|
-
[
|
|
391
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.7.0...v2.8.0.rc1)
|
|
408
392
|
|
|
409
393
|
Enhancements
|
|
410
394
|
|
|
@@ -412,7 +396,7 @@ Enhancements
|
|
|
412
396
|
|
|
413
397
|
### 2.7.0 / 2011-10-16
|
|
414
398
|
|
|
415
|
-
[
|
|
399
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.6.0...v2.7.0)
|
|
416
400
|
|
|
417
401
|
Enhancements
|
|
418
402
|
|
|
@@ -435,7 +419,7 @@ Bug fixes
|
|
|
435
419
|
|
|
436
420
|
### 2.6.0 / 2011-05-12
|
|
437
421
|
|
|
438
|
-
[
|
|
422
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.5.0...v2.6.0)
|
|
439
423
|
|
|
440
424
|
Enhancements
|
|
441
425
|
|
|
@@ -449,7 +433,7 @@ Bug fixes
|
|
|
449
433
|
|
|
450
434
|
### 2.5.0 / 2011-02-05
|
|
451
435
|
|
|
452
|
-
[
|
|
436
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.4.0...v2.5.0)
|
|
453
437
|
|
|
454
438
|
Bug fixes
|
|
455
439
|
|
|
@@ -460,14 +444,14 @@ Bug fixes
|
|
|
460
444
|
|
|
461
445
|
### 2.4.0 / 2011-01-02
|
|
462
446
|
|
|
463
|
-
[
|
|
447
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.3.0...v2.4.0)
|
|
464
448
|
|
|
465
449
|
No functional changes in this release, which was made to align with the
|
|
466
450
|
rspec-core-2.4.0 release.
|
|
467
451
|
|
|
468
452
|
### 2.3.0 / 2010-12-12
|
|
469
453
|
|
|
470
|
-
[
|
|
454
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.2.0...v2.3.0)
|
|
471
455
|
|
|
472
456
|
Bug fixes
|
|
473
457
|
|
|
@@ -476,7 +460,7 @@ Bug fixes
|
|
|
476
460
|
|
|
477
461
|
### 2.2.0 / 2010-11-28
|
|
478
462
|
|
|
479
|
-
[
|
|
463
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.1.0...v2.2.0)
|
|
480
464
|
|
|
481
465
|
Enhancements
|
|
482
466
|
|
|
@@ -490,7 +474,7 @@ Bug fix
|
|
|
490
474
|
|
|
491
475
|
### 2.1.0 / 2010-11-07
|
|
492
476
|
|
|
493
|
-
[
|
|
477
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.0.1...v2.1.0)
|
|
494
478
|
|
|
495
479
|
Bug fixes
|
|
496
480
|
|
|
@@ -498,11 +482,11 @@ Bug fixes
|
|
|
498
482
|
|
|
499
483
|
### 2.0.0 / 2010-10-10
|
|
500
484
|
|
|
501
|
-
[
|
|
485
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.0.0.beta.22...v2.0.0)
|
|
502
486
|
|
|
503
487
|
### 2.0.0.rc / 2010-10-05
|
|
504
488
|
|
|
505
|
-
[
|
|
489
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.0.0.beta.22...v2.0.0.rc)
|
|
506
490
|
|
|
507
491
|
Enhancements
|
|
508
492
|
|
|
@@ -516,7 +500,7 @@ Bug fixes
|
|
|
516
500
|
|
|
517
501
|
### 2.0.0.beta.22 / 2010-09-12
|
|
518
502
|
|
|
519
|
-
[
|
|
503
|
+
[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.0.0.beta.20...v2.0.0.beta.22)
|
|
520
504
|
|
|
521
505
|
Bug fixes
|
|
522
506
|
|
data/License.txt
CHANGED
data/README.md
CHANGED
|
@@ -26,9 +26,8 @@ stubs can be declared on test doubles or real objects using the same syntax.
|
|
|
26
26
|
rspec-mocks supports 3 forms for declaring method stubs:
|
|
27
27
|
|
|
28
28
|
```ruby
|
|
29
|
-
book.
|
|
30
|
-
book.
|
|
31
|
-
book.stub(:title).and_return("The RSpec Book")
|
|
29
|
+
allow(book).to receive(:title) { "The RSpec Book" }
|
|
30
|
+
allow(book).to receive(:title).and_return("The RSpec Book")
|
|
32
31
|
```
|
|
33
32
|
|
|
34
33
|
You can also use this shortcut, which creates a test double and declares a
|
|
@@ -60,7 +59,7 @@ arguments to `and_return`. The invocations cycle through the list. The last
|
|
|
60
59
|
value is returned for any subsequent invocations:
|
|
61
60
|
|
|
62
61
|
```ruby
|
|
63
|
-
die.
|
|
62
|
+
allow(die).to receive(:roll).and_return(1,2,3)
|
|
64
63
|
die.roll # => 1
|
|
65
64
|
die.roll # => 2
|
|
66
65
|
die.roll # => 3
|
|
@@ -71,7 +70,7 @@ die.roll # => 3
|
|
|
71
70
|
To return an array in a single invocation, declare an array:
|
|
72
71
|
|
|
73
72
|
```ruby
|
|
74
|
-
team.
|
|
73
|
+
allow(team).to receive(:players).and_return([double(:name => "David")])
|
|
75
74
|
```
|
|
76
75
|
|
|
77
76
|
## Message Expectations
|
|
@@ -82,11 +81,33 @@ expectation is satisfied. If not, the example fails.
|
|
|
82
81
|
|
|
83
82
|
```ruby
|
|
84
83
|
validator = double("validator")
|
|
85
|
-
validator.
|
|
84
|
+
expect(validator).to receive(:validate) { "02134" }
|
|
86
85
|
zipcode = Zipcode.new("02134", validator)
|
|
87
86
|
zipcode.valid?
|
|
88
87
|
```
|
|
89
88
|
|
|
89
|
+
## Test Spies
|
|
90
|
+
|
|
91
|
+
Verifies the given object received the expected message during the course of the
|
|
92
|
+
test. The method must have previously been stubbed in order for messages to be
|
|
93
|
+
verified.
|
|
94
|
+
|
|
95
|
+
Stubbing and verifying messages received in this way implements the Test Spy
|
|
96
|
+
pattern.
|
|
97
|
+
|
|
98
|
+
```ruby
|
|
99
|
+
invitation = double('invitation', :accept => true)
|
|
100
|
+
|
|
101
|
+
user.accept_invitation(invitation)
|
|
102
|
+
|
|
103
|
+
expect(invitation).to have_received(:accept)
|
|
104
|
+
|
|
105
|
+
# You can also use other common message expectations. For example:
|
|
106
|
+
expect(invitation).to have_received(:accept).with(mailer)
|
|
107
|
+
expect(invitation).to have_received(:accept).twice
|
|
108
|
+
expect(invitation).to_not have_received(:accept).with(mailer)
|
|
109
|
+
```
|
|
110
|
+
|
|
90
111
|
## Nomenclature
|
|
91
112
|
|
|
92
113
|
### Mock Objects and Test Stubs
|
|
@@ -112,7 +133,7 @@ For example, in Rails:
|
|
|
112
133
|
|
|
113
134
|
```ruby
|
|
114
135
|
person = double("person")
|
|
115
|
-
Person.
|
|
136
|
+
allow(Person).to receive(:find) { person }
|
|
116
137
|
```
|
|
117
138
|
|
|
118
139
|
In this case we're instrumenting Person to return the person object we've
|
|
@@ -121,27 +142,25 @@ expectation so that the example fails if `find` is not called:
|
|
|
121
142
|
|
|
122
143
|
```ruby
|
|
123
144
|
person = double("person")
|
|
124
|
-
Person.
|
|
145
|
+
expect(Person).to receive(:find) { person }
|
|
125
146
|
```
|
|
126
147
|
|
|
127
|
-
|
|
128
|
-
and `should_receive` methods to every object, including class objects. When we
|
|
129
|
-
use either, RSpec replaces the method we're stubbing or mocking with its own
|
|
148
|
+
RSpec replaces the method we're stubbing or mocking with its own
|
|
130
149
|
test-double-like method. At the end of the example, RSpec verifies any message
|
|
131
150
|
expectations, and then restores the original methods.
|
|
132
151
|
|
|
133
152
|
## Expecting Arguments
|
|
134
153
|
|
|
135
154
|
```ruby
|
|
136
|
-
double.
|
|
137
|
-
double.
|
|
155
|
+
expect(double).to receive(:msg).with(*args)
|
|
156
|
+
expect(double).to_not receive(:msg).with(*args)
|
|
138
157
|
```
|
|
139
158
|
|
|
140
159
|
You can set multiple expectations for the same message if you need to:
|
|
141
160
|
|
|
142
161
|
```ruby
|
|
143
|
-
double.
|
|
144
|
-
double.
|
|
162
|
+
expect(double).to receive(:msg).with("A", 1, 3)
|
|
163
|
+
expect(double).to receive(:msg).with("B", 2, 4)
|
|
145
164
|
```
|
|
146
165
|
|
|
147
166
|
## Argument Matchers
|
|
@@ -157,81 +176,81 @@ rspec-mocks also adds some keyword Symbols that you can use to
|
|
|
157
176
|
specify certain kinds of arguments:
|
|
158
177
|
|
|
159
178
|
```ruby
|
|
160
|
-
double.
|
|
161
|
-
double.
|
|
162
|
-
double.
|
|
163
|
-
double.
|
|
164
|
-
double.
|
|
165
|
-
double.
|
|
166
|
-
double.
|
|
179
|
+
expect(double).to receive(:msg).with(no_args())
|
|
180
|
+
expect(double).to receive(:msg).with(any_args())
|
|
181
|
+
expect(double).to receive(:msg).with(1, kind_of(Numeric), "b") #2nd argument can be any kind of Numeric
|
|
182
|
+
expect(double).to receive(:msg).with(1, boolean(), "b") #2nd argument can be true or false
|
|
183
|
+
expect(double).to receive(:msg).with(1, /abc/, "b") #2nd argument can be any String matching the submitted Regexp
|
|
184
|
+
expect(double).to receive(:msg).with(1, anything(), "b") #2nd argument can be anything at all
|
|
185
|
+
expect(double).to receive(:msg).with(1, duck_type(:abs, :div), "b")
|
|
167
186
|
#2nd argument can be object that responds to #abs and #div
|
|
168
187
|
```
|
|
169
188
|
|
|
170
189
|
## Receive Counts
|
|
171
190
|
|
|
172
191
|
```ruby
|
|
173
|
-
double.
|
|
174
|
-
double.
|
|
175
|
-
double.
|
|
176
|
-
double.
|
|
177
|
-
double.
|
|
178
|
-
double.
|
|
179
|
-
double.
|
|
180
|
-
double.
|
|
181
|
-
double.
|
|
182
|
-
double.
|
|
192
|
+
expect(double).to receive(:msg).once
|
|
193
|
+
expect(double).to receive(:msg).twice
|
|
194
|
+
expect(double).to receive(:msg).exactly(n).times
|
|
195
|
+
expect(double).to receive(:msg).at_least(:once)
|
|
196
|
+
expect(double).to receive(:msg).at_least(:twice)
|
|
197
|
+
expect(double).to receive(:msg).at_least(n).times
|
|
198
|
+
expect(double).to receive(:msg).at_most(:once)
|
|
199
|
+
expect(double).to receive(:msg).at_most(:twice)
|
|
200
|
+
expect(double).to receive(:msg).at_most(n).times
|
|
201
|
+
expect(double).to receive(:msg).any_number_of_times
|
|
183
202
|
```
|
|
184
203
|
|
|
185
204
|
## Ordering
|
|
186
205
|
|
|
187
206
|
```ruby
|
|
188
|
-
double.
|
|
189
|
-
double.
|
|
207
|
+
expect(double).to receive(:msg).ordered
|
|
208
|
+
expect(double).to receive(:other_msg).ordered
|
|
190
209
|
#This will fail if the messages are received out of order
|
|
191
210
|
```
|
|
192
211
|
|
|
193
212
|
This can include the same message with different arguments:
|
|
194
213
|
|
|
195
214
|
```ruby
|
|
196
|
-
double.
|
|
197
|
-
double.
|
|
215
|
+
expect(double).to receive(:msg).with("A", 1, 3).ordered
|
|
216
|
+
expect(double).to receive(:msg).with("B", 2, 4).ordered
|
|
198
217
|
```
|
|
199
218
|
|
|
200
219
|
## Setting Responses
|
|
201
220
|
|
|
202
221
|
Whether you are setting a message expectation or a method stub, you can
|
|
203
222
|
tell the object precisely how to respond. The most generic way is to pass
|
|
204
|
-
a block to `
|
|
223
|
+
a block to `receive`:
|
|
205
224
|
|
|
206
225
|
```ruby
|
|
207
|
-
double.
|
|
226
|
+
expect(double).to receive(:msg) { value }
|
|
208
227
|
```
|
|
209
228
|
|
|
210
229
|
When the double receives the `msg` message, it evaluates the block and returns
|
|
211
230
|
the result.
|
|
212
231
|
|
|
213
232
|
```ruby
|
|
214
|
-
double.
|
|
215
|
-
double.
|
|
233
|
+
expect(double).to receive(:msg).and_return(value)
|
|
234
|
+
expect(double).to receive(:msg).exactly(3).times.and_return(value1, value2, value3)
|
|
216
235
|
# returns value1 the first time, value2 the second, etc
|
|
217
|
-
double.
|
|
236
|
+
expect(double).to receive(:msg).and_raise(error)
|
|
218
237
|
#error can be an instantiated object or a class
|
|
219
238
|
#if it is a class, it must be instantiable with no args
|
|
220
|
-
double.
|
|
221
|
-
double.
|
|
222
|
-
double.
|
|
239
|
+
expect(double).to receive(:msg).and_throw(:msg)
|
|
240
|
+
expect(double).to receive(:msg).and_yield(values,to,yield)
|
|
241
|
+
expect(double).to receive(:msg).and_yield(values,to,yield).and_yield(some,other,values,this,time)
|
|
223
242
|
# for methods that yield to a block multiple times
|
|
224
243
|
```
|
|
225
244
|
|
|
226
245
|
Any of these responses can be applied to a stub as well
|
|
227
246
|
|
|
228
247
|
```ruby
|
|
229
|
-
double.
|
|
230
|
-
double.
|
|
231
|
-
double.
|
|
232
|
-
double.
|
|
233
|
-
double.
|
|
234
|
-
double.
|
|
248
|
+
allow(double).to receive(:msg).and_return(value)
|
|
249
|
+
allow(double).to receive(:msg).and_return(value1, value2, value3)
|
|
250
|
+
allow(double).to receive(:msg).and_raise(error)
|
|
251
|
+
allow(double).to receive(:msg).and_throw(:msg)
|
|
252
|
+
allow(double).to receive(:msg).and_yield(values,to,yield)
|
|
253
|
+
allow(double).to receive(:msg).and_yield(values,to,yield).and_yield(some,other,values,this,time)
|
|
235
254
|
```
|
|
236
255
|
|
|
237
256
|
## Arbitrary Handling
|
|
@@ -242,8 +261,8 @@ to come with an Array argument that has a specific length, but you don't care
|
|
|
242
261
|
what is in it. You could do this:
|
|
243
262
|
|
|
244
263
|
```ruby
|
|
245
|
-
double.
|
|
246
|
-
arg.size.
|
|
264
|
+
expect(double).to receive(:msg) do |arg|
|
|
265
|
+
expect(arg.size).to eq 7
|
|
247
266
|
end
|
|
248
267
|
```
|
|
249
268
|
|
|
@@ -251,7 +270,7 @@ If the method being stubbed itself takes a block, and you need to yield to it
|
|
|
251
270
|
in some special way, you can use this:
|
|
252
271
|
|
|
253
272
|
```ruby
|
|
254
|
-
double.
|
|
273
|
+
expect(double).to receive(:msg) do |&arg|
|
|
255
274
|
begin
|
|
256
275
|
arg.call
|
|
257
276
|
ensure
|
|
@@ -268,7 +287,7 @@ the object responds to the message. You can use `and_call_original`
|
|
|
268
287
|
to achieve this:
|
|
269
288
|
|
|
270
289
|
```ruby
|
|
271
|
-
Person.
|
|
290
|
+
expect(Person).to receive(:find).and_call_original
|
|
272
291
|
Person.find # => executes the original find method and returns the result
|
|
273
292
|
```
|
|
274
293
|
|
|
@@ -278,7 +297,7 @@ Combining the message name with specific arguments, receive counts and responses
|
|
|
278
297
|
you can get quite a bit of detail in your expectations:
|
|
279
298
|
|
|
280
299
|
```ruby
|
|
281
|
-
double.
|
|
300
|
+
expect(double).to receive(:<<).with("illegal value").once.and_raise(ArgumentError)
|
|
282
301
|
```
|
|
283
302
|
|
|
284
303
|
While this is a good thing when you really need it, you probably don't really
|
|
@@ -303,8 +322,9 @@ There are many different viewpoints about the meaning of mocks and stubs. If
|
|
|
303
322
|
you are interested in learning more, here is some recommended reading:
|
|
304
323
|
|
|
305
324
|
* Mock Objects: http://www.mockobjects.com/
|
|
306
|
-
* Endo-Testing: http://
|
|
307
|
-
* Mock Roles, Not Objects: http://
|
|
325
|
+
* Endo-Testing: http://stalatest.googlecode.com/svn/trunk/Literatur/mockobjects.pdf
|
|
326
|
+
* Mock Roles, Not Objects: http://jmock.org/oopsla2004.pdf
|
|
327
|
+
* Test Double: http://www.martinfowler.com/bliki/TestDouble.html
|
|
308
328
|
* Test Double Patterns: http://xunitpatterns.com/Test%20Double%20Patterns.html
|
|
309
329
|
* Mocks aren't stubs: http://www.martinfowler.com/articles/mocksArentStubs.html
|
|
310
330
|
|