Test Doubles, Method Stubs, Message Expectations
1
2
3
thingamajig_double = double ( 'thing-a-ma-jig' )
stub_thingamajig = stub ( 'thing-a-ma-jig' )
mock_thingamajig = mock ( 'thing-a-ma-jig' )
double()
,stub()
,mock()
都会返回一个RSpec::Mocks::Mock
的实例
可以在这个实例上生成method stubs和message expectations
1
2
3
4
5
6
7
8
9
10
11
12
13
describe Statement do
it "logs a message on generate()" do
customer = stub ( 'customer' )
customer . stub ( :name ) . and_return ( 'Aslak' )
logger = mock ( 'logger' )
statement = Statement . new ( customer , logger )
logger . should_receive ( :log ) . with ( /Statement generated for Aslak/ )
statement . generate
end
end
这段代码中, stub('customer')
和mmock('logger')
分别生成了2个test
double
customer.stub(:name)
为customer
double添加了一个method stub(打桩方法), :name为方法名 and_return('Aslak')
表示:name的返回值为Aslak
logger.should_receive(:log)
为logger
double设置了一个对于message name()
的expectation
后面的generate()
方法里, 如果logger
对log()
的调用失败,
则整个example会fail
否则会判断logger.should_receive(:log)
后面的条件是否满足(此处为with(xxx)
,即log()
调用是否带参数xxx)
partial stubbing, partial mocking
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
describe WidgetsController do
describe "PUT update with valid attributes"
it "finds the widget"
widget = Widget . new ()
widget . stub ( :update_attributes ) . and_return ( true )
Widget . should_receive ( :find ) . with ( "37" ) . and_return ( widget )
put :update , :id => 37
end
it "updates the widget's attributes" do
widget = Widget . new ()
Widget . stub ( :find ) . and_return ( widget )
widget . should_receive ( :update_attributes ) . and_return ( true )
put :update , :id => 37
end
it "redirects to the list of widgets"
widget = Widget . new ()
Widget . stub ( :find ) . and_return ( widget )
widget . stub ( :update_attributes ) . and_return ( true )
put :update , :id => 37
response . should redirect_to ( widgets_path )
end
end
end
更多关于Method Stubs
One-Line Shortcut
double()
,stub()
,mock()
第一个参数非必填但是强烈建议有,
因为其会作为失败时的消息
此外还可以接受一个hash作为第二参数
1
customer = double ( 'customer' , :name => 'Bryan' )
等效于
1
2
customer = double ( 'customer' )
customer . stub ( :name ) . and_return ( 'Bryan' )
Implementation Injection
如果一个stub method需要使用多次而且根据条件不同会有不同返回值, 可以用如下方法
多用于before()
里
1
2
3
4
5
6
7
8
ages = double ( 'ages' )
ages . stub ( :age_for ) do | what |
if what == 'drinking'
21
elsif what == 'voting'
18
end
end
方法链
1
2
article = double ()
Article . stub_chain ( :recent , :published , :authored_by ) . and_return ( article )
更多关于Message Expectations
执行次数
should_receive(:xxx)
要求xxx()
被调用且只调用一次,
如果希望调用若干次, 可采用下列方式
1
2
3
4
5
mock_account . should_receive ( :withdraw ) . exactly ( 5 ) . times
network_double . should_receive ( :open_connection ) . at_most ( 5 ) . times
network_double . should_receive ( :open_connection ) . at_least ( 2 ) . times
account_double . should_receive ( :withdraw ) . once
account_double . should_receive ( :deposit ) . twice
如果期待方法不被调用,要使用should_not_receive
1
2
3
network_double . should_not_receive ( :open_connection )
network_double . should_receive ( :open_connection ) . never #不推荐
network_double . should_receive ( :open_connection ) . exactly ( 0 ) . times #不推荐
指定期待的参数, with()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
### 指定一个参数, 且值为50
account_double . should_receive ( :withdraw ) . with ( 50 )
### 可以指定任意个参数
checking_account . should_receive ( :transfer ) . with ( 50 , savings_account )
### 第一个参数为给定值, 第二个参数为Fixnum型任意值
source_account . should_receive ( :transfer ) . with ( target_account , instance_of ( Fixnum ))
### 第一个参数可以为任意类型任意值
source_account . should_receive ( :transfer ) . with ( anything (), 50 )
### 任意类型任意数量参数
source_account . should_receive ( :transfer ) . with ( any_args ())
### 不传参数
collaborator . should_receive ( :message ) . with ( no_args ())
### 参数为包含/不包含给定key/value的Hash
with ( hash_including ( 'Electric' => '123' , 'Gas' => '234' ))
with ( hash_not_including ( 'Electric' => '123' , 'Gas' => '234' ))
### 正则表达式
mock_atm . should_receive ( :login ) . with ( /.* User/ )
自定义的Argument Matchers
自定义一个类, 然后重写==(actual)
方法即可
也可以添加一个description()
方法以提供失败时输出的信息
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
class GreaterThanMatcher
def initialize ( expected )
@expected = expected
end
def description
"a number greater than #{ @expected } "
end
def == ( actual )
actual > @expected
end
end
def greater_than ( floor )
GreaterThanMatcher . new ( floor )
end
calculator . should_receive ( :add ) . with ( greater_than ( 37 ))
Throwing or Raising
and_raise()
可以不传参/一个参数(异常类或异常类实例)
and_throw()
传symbol
1
2
3
4
5
6
7
account_double . should_receive ( :withdraw ) . and_raise
account_double . should_receive ( :withdraw ) . and_raise ( InsufficientFunds )
the_exception = InsufficientFunds . new ( :reason => :on_hold )
account_double . should_receive ( :withdraw ) . and_raise ( the_exception )
account_double . should_receive ( :withdraw ) . and_throw ( :insufficient_funds )
按序执行
1
2
database . should_receive ( :count ) . with ( 'Roster' , :course_id => 37 ) . ordered
database . should_receive ( :add ) . with ( student ) . ordered
只要count()
在add()
之前执行就会pass