RSpec と Cucumber

RSpec と
Cucumber
とみたまさひろ
2011-01-15

RSpec と Cucumber Powered by Rabbit 0.9.2

自己紹介
✓ とみたまさひろ
✓ プログラマー
✓ mailto:tommy@tmtm.org
✓ http://d.hatena.ne.jp/tmtms
✓ http://twitter.com/tmtms
1/63

自己紹介

✓ 日本Rubyの会
✓ 日本MySQLユーザ会
✓ Ruby/MySQL ライブラリ
✓ Ruby歴, MySQL歴十数年

2/63

自己紹介

こんな本書きました

3/63

NSEG

✓ #1 Rubyの黒魔術
✓ #3 はじめてのRuby拡張ライブラ
リ
✓ #6 Ruby紹介

4/63

今回は
RSpec と
Cucumber
の話
RSpec と Cucumber
5/63
Powered by Rabbit 0.9.2

読みやすく
て自動実行
できるテスト 6/63

RSpec
7/63

RSpec

✓ Rubyプログラム用の TDDツール
✓ 最新バージョン 2.4
✓ http://relishapp.com/rspec

8/63

RSpec

9/63

「The RSpec Book」

10/63

特徴

✓ 英語っぽい
✓ モックが強力&簡単
✓ ファイル変更時に自動的実行
✓ テストカバー率が測れる

11/63

インストール

% sudo gem install rspec

12/63

基本的な書き方

✓ ファイル名は *_spec.rb
✓ ○○について --- describe
✓ ○○の場合 --- context
✓ ○○となること --- it

13/63

基本的な書き方
describe Array do
context 'when new' do
it 'should be empty' do
Array.new.should be_empty
end
it 'size should == 0' do
Array.new.size.should == 0
end
end
end
14/63

実行

% rspec array_spec.rb
..

Finished in 0.00054 seconds
2 examples, 0 failures

15/63

ドキュメントっぽい出力
% rspec -fd array_spec.rb

Array
when new
should be empty
size should == 0

16/63

冗長
describe Array do
it 'should be empty' do
Array.new.should be_empty
end
it 'size should == 0' do
Array.new.size.should == 0
end
end
end
17/63

簡潔に

describe Array do
it{should be_empty}
its(:size){should == 0}
end
end
18/63

出力
% rspec -fd b.rb

Array
when new
should be empty
size
should == 0

19/63

subject

describe Array do
context 'when new with 3' do
subject{Array.new(3)}
it{should == [nil, nil, nil]}
its(:size){should == 3}
end
end

20/63

before & after
describe Hoge do
before do # 前処理
@hoge = Hoge.new
end
after do # 後処理
@hoge.close
end
it '...' do
@hoge.fuga.should == 123
end
end
21/63

should
✓ ==, =~, >, >=, <, <=
✓ be_xxx : obj.xxx? メソッドが真
✓ be_true, be_false, be_nil
✓ [1,2,3].should have(3).items
✓ [1,2,3].should include(2)
22/63

例外処理

expect{...}.to
raise_error(RuntimeError, 'msg...')

23/63

英語っぽいっていってもやりす
ぎだろJK

ary = []
expect{ary.push 123}.to
change{ary.size}.from(0).to(1)

24/63

モック 25/63

モック

✓ ダミーのオブジェクト
✓ ファイル, ネットワーク, DB, 時刻,
etc...
✓ double() でモックオブジェクトを
作成

26/63

モック

obj = double 'label', :size=>3
obj.size #=> 3
obj.hoge #=> Error

27/63

モック

obj = double 'Array'
obj.stub(:size).and_return 3
obj.stub(:values_at).with(0).and_return 'a'
# 呼ばれなかったらエラー
obj.should_receive(:fetch)

28/63

モック

# 一度だけ呼び出される
obj.should_receive(:hoge).once
# n回以上呼び出される
obj.should_receive(:hoge).at_least(n).times
# 引数が正規表現に一致する
obj.should_receive(:hoge).with(/.../)
# 引数が文字列
obj.should_receive(:hoge).with(an_instance_of(String))
# 引数が :key=>val を含むハッシュ
obj.should_receive(:hoge).with(hash_including(:key=>val))

29/63

既存オブジェクトのメソッドを置
き換え可能

it の中だけで有効
# 特定の時刻で実行したいテスト
before do
t = Time.local(2011,1,15,18,30,0)
Time.stub(:now).and_return t
end
its(:tmpfile){should == '20110115183000.tmp'}

30/63

モックを返す

before do
# どんなメソッド呼び出しもエラーにしない
logger = double('Logger').as_null_object
Logger.stub(:new).and_return logger
end
it ...

31/63

自動
RSpec と Cucumber
実行 32/63

autotest

.rspec
lib/hoge.rb
spec/hoge_spec.rb
hoge.rb が変更されると自動的に
hoge_spec.rb が実行される
33/63

インストール&実行

% sudo gem install ZenTest

% autotest

34/63

デモ
RSpec と Cucumber
35/63

カバレッジ

✓ テストカバー率を測れる
✓ Ruby 1.9 ではまだちゃんと動作
しない(？)

36/63

RCov

37/63

インストール&実行

% sudo gem install rcov

% rcov rspec spec/hoge_spec.rb

テスト対象のものだけ集計
% rcov -x ^/ -x _spec.rb rspec spec/hoge_spec.rb

38/63

デモ
RSpec と Cucumber
39/63

RSpec の
話はここま
で
RSpec と Cucumber
40/63

Cucumber
41/63

Cucumber
✓ 受け入れテスト用ツール
✓ プログラムを外部からテスト
✓ テスト対象の言語は問わない
✓ テスト自体は Ruby で記述
✓ http://cukes.info/
42/63

Cucumber

43/63

「はじめる！ Cucumber」

達人出版会の電子書籍。Railsプログラムのテスト
44/63

インストール

% sudo gem install cucumber

45/63

書き方
# language: ja
フィーチャ: ○○できる
○○として、
○○したい。
なぜなら、○○だから。
シナリオ: ○○すると○○される
前提 ○○の状態
もし ○○する
かつ ○○する
ならば ○○されること
46/63

文章で書ける

✓ プログラマじゃなくても読める
✓ プログラマじゃなくても書ける
…かは微妙

47/63

こんな場面で

✓ Web アプリケーションのテスト
✓ Rails で使うと便利な機能多数
✓ Rails や Web アプリ以外でも使
える

48/63

今回の例は

✓ SMTPの送信テスト
✓ プログラム開発以外にも使える
よ！
✓ Rails 以外にも使えるよ！
というか Rails 知らないし

49/63

feature ファイル

# language: ja
フィーチャ: メールが送信できる
SMTPクライアントとして、
メールを送信したい。
なぜなら、メールを利用者に届けたいから。
シナリオ: 接続するとバナーが返る
前提サーバーが起動している
もし 25番ポートに接続する
ならば "220 "応答が返されること

50/63

実行

% cucumber smtp.feature
# language: ja
フィーチャ: メールが送信できる
SMTPクライアントとして、
メールを送信したい。
なぜなら、メールを利用者に届けたいから。
シナリオ: 接続するとバナーが返る # smtp.feature:7
前提サーバーが起動している # step_definitions/smtp_steps.rb:2
もし25番ポートに接続する # step_definitions/smtp_steps.rb:7
ならば"220 "応答が返されること # step_definitions/smtp_steps.rb:11
1 scenario (1 passed)
3 steps (3 passed)
0m0.002s

51/63

HTML出力

% cucumber smtp.feature -f html -o /tmp/smtp.html

52/63

HTML出力

53/63

仕組み

features/
├── smtp.feature
└── step_definitions/
└── smtp_steps.rb
✓ step_definitions 配下のスクリプト
で対応する処理を実行
54/63

step_definitions ファイル
前提 'サーバーが起動している' do
system 'ps -ef | grep -q postfix/master'
$?.should be_success
end
もし '25番ポートに接続する' do
@sock = TCPSocket.new('localhost', 25)
end

ならば '"220 "応答が返されること' do
@sock.gets.should =~ /^220 /
end
55/63

少し動的に

前提 'サーバーが起動している' do
system 'ps -ef | grep -q postfix/master'
$?.should be_success
end

もし /(d+)番ポートに接続する/ do |port|
@sock = TCPSocket.new('localhost', port)
end
ならば /"(.*)"応答が返されること/ do |status|
@sock.gets.should =~ /^#{status}/
end

56/63

既存の定義を利用して定義

シナリオ: RCPT TO が受け付けられる
前提 MAIL FROM まで指定済み
もし RCPT TO で tommy@localhost を指定する
ならば "250 "応答が返されること

57/63

既存の定義を利用して定義

前提 'MAIL FROM まで指定済み' do
もし '25番ポートに接続する'
ならば '"220 "応答が返されること'
@sock.puts "MAIL FROM:<hoge@example.com>"
ならば '"250 "応答が返されること'
end

もし /RCPT TO で (.*) を指定する/ do |rcpt|
@sock.puts "RCPT TO:<#{rcpt}>"
end

58/63

表を使う

シナリオアウトライン: 宛先に応じた応答が返る
前提 MAIL FROM まで指定済み
もし RCPT TO で <宛先> を指定する
ならば <結果>応答が返されること

例:
| 宛先 | 結果 |
| tommy@localhost | "250 " |
| fuga@example.com | "550 " |

59/63

結果

60/63

Rails で使うと

feature ファイルに
✓ ○○に○○と入力する
✓ ○○ボタンをクリックする
✓ ○○と表示されていること
と書ける機能が用意されているらしい
61/63

自動でできる
ことは
機械にやらせ
よう
RSpec と Cucumber
62/63

ご清聴あ
りがとうご
ざいました
RSpec と Cucumber
63/63

RSpec と Cucumber

More Related Content

Similar to RSpec と Cucumber (20)

More from Masahiro Tomita (20)

Recently uploaded (11)

RSpec と Cucumber