1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
module Mocha
module ParameterMatchers
# @abstract Subclass and implement +#matches?+ and +#mocha_inspect+ to define a custom matcher. Also add a suitably named instance method to {ParameterMatchers} to build an instance of the new matcher c.f. {#equals}.
class Base
# A shorthand way of combining two matchers when both must match.
#
# Returns a new {AllOf} parameter matcher combining two matchers using a logical AND.
#
# This shorthand will not work with an implicit equals match. Instead, an explicit {Equals} matcher should be used.
#
# @param [Base] other parameter matcher.
# @return [AllOf] parameter matcher.
#
# @see Expectation#with
#
# @example Alternative ways to combine matchers with a logical AND.
# object = mock()
# object.expects(:run).with(all_of(has_key(:foo), has_key(:bar)))
# object.run(foo: 'foovalue', bar: 'barvalue')
#
# # is exactly equivalent to
#
# object.expects(:run).with(has_key(:foo) & has_key(:bar))
# object.run(foo: 'foovalue', bar: 'barvalue)
def &(other)
AllOf.new(self, other)
end
# A shorthand way of combining two matchers when at least one must match.
#
# Returns a new +AnyOf+ parameter matcher combining two matchers using a logical OR.
#
# This shorthand will not work with an implicit equals match. Instead, an explicit {Equals} matcher should be used.
#
# @param [Base] other parameter matcher.
# @return [AnyOf] parameter matcher.
#
# @see Expectation#with
#
# @example Alternative ways to combine matchers with a logical OR.
# object = mock()
# object.expects(:run).with(any_of(has_key(:foo), has_key(:bar)))
# object.run(foo: 'foovalue')
#
# # is exactly equivalent to
#
# object.expects(:run).with(has_key(:foo) | has_key(:bar))
# object.run(foo: 'foovalue')
#
# @example Using an explicit {Equals} matcher in combination with {#|}.
# object.expects(:run).with(equals(1) | equals(2))
# object.run(1) # passes
# object.run(2) # passes
# object.run(3) # fails
def |(other)
AnyOf.new(self, other)
end
end
end
end
|
