rspec と cucumber

RSpec と Cucumber Powered by Rabbit 0.9.2

RSpec と Cucumber

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

自己紹介

とみたまさひろ✓

プログラマー✓

mailto:tommy@tmtm.org✓

http://d.hatena.ne.jp/tmtms✓

http://twitter.com/tmtms✓

自己紹介

日本Rubyの会✓

日本MySQLユーザ会✓

Ruby/MySQL ライブラリ✓

Ruby歴, MySQL歴十数年✓

自己紹介

こんな本書きました

#1 Rubyの黒魔術✓

#3 はじめてのRuby拡張ライブラリ

#6 Ruby紹介✓

今回は RSpec と

Cucumber の話

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

RSpec7/63

Rubyプログラム用の TDDツール✓

最新バージョン 2.4✓

http://relishapp.com/rspec✓

「The RSpec Book」

特徴

英語っぽい✓

モックが強力&簡単✓

ファイル変更時に自動的実行✓

テストカバー率が測れる✓

インストール

% sudo gem install rspec

基本的な書き方

ファイル名は *_spec.rb✓

○○について --- describe✓

○○の場合 --- context✓

○○となること --- it✓

基本的な書き方

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 endend

実行

% rspec array_spec.rb..

Finished in 0.00054 seconds2 examples, 0 failures

ドキュメントっぽい出力

% rspec -fd array_spec.rb

Array when new should be empty size should == 0

冗長

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 endend

簡潔に

describe Array do context 'when new' do it{should be_empty} its(:size){should == 0} endend

出力

% rspec -fd b.rb

Array when new should be empty size should == 0

subject

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

before & after

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

should

==, =~, >, >=, <, <=✓

be_xxx : obj.xxx? メソッドが真✓

be_true, be_false, be_nil✓

[1,2,3].should have(3).items✓

[1,2,3].should include(2)✓

例外処理

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

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

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

モック25/63

モック

ダミーのオブジェクト✓

ファイル, ネットワーク, DB, 時刻, etc...

double() でモックオブジェクトを作成

モック

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

モック

obj = double 'Array'obj.stub(:size).and_return 3obj.stub(:values_at).with(0).and_return 'a'

# 呼ばれなかったらエラーobj.should_receive(:fetch)

モック

# 一度だけ呼び出される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))

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

it の中だけで有効

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

モックを返す

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

自動実行

autotest

.rspeclib/hoge.rbspec/hoge_spec.rb

hoge.rb が変更されると自動的にhoge_spec.rb が実行される

インストール&実行

% sudo gem install ZenTest

% autotest

デモ35/63

カバレッジ

テストカバー率を測れる✓

Ruby 1.9 ではまだちゃんと動作しない(？)

インストール&実行

% sudo gem install rcov

% rcov rspec spec/hoge_spec.rb

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

デモ39/63

RSpec の話はここま

で40/63

Cucumber

受け入れテスト用ツール✓

プログラムを外部からテスト✓

テスト対象の言語は問わない✓

テスト自体は Ruby で記述✓

http://cukes.info/✓

Cucumber

「はじめる！ Cucumber」

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

インストール

% sudo gem install cucumber

書き方

# language: jaフィーチャ: ○○できる ○○として、 ○○したい。なぜなら、○○だから。

シナリオ: ○○すると○○される前提 ○○の状態もし ○○するかつ ○○するならば ○○されること

文章で書ける

プログラマじゃなくても読める✓

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

こんな場面で

Web アプリケーションのテスト✓

Rails で使うと便利な機能多数✓

Rails や Web アプリ以外でも使える

今回の例は

SMTPの送信テスト✓

プログラム開発以外にも使えるよ！

Rails 以外にも使えるよ！というか Rails 知らないし

feature ファイル

# language: jaフィーチャ: メールが送信できる SMTPクライアントとして、メールを送信したい。なぜなら、メールを利用者に届けたいから。

シナリオ: 接続するとバナーが返る前提サーバーが起動しているもし 25番ポートに接続するならば "220 "応答が返されること

実行

% 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

HTML出力

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

HTML出力

仕組み

features/├── smtp.feature└── step_definitions/ └── smtp_steps.rb

step_definitions 配下のスクリプトで対応する処理を実行

step_definitions ファイル

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

もし '25番ポートに接続する' do @sock = TCPSocket.new('localhost', 25)end

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

少し動的に

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

もし /(\d+)番ポートに接続する/ do |port| @sock = TCPSocket.new('localhost', port)end

ならば /\"(.*)\"応答が返されること/ do |status| @sock.gets.should =~ /^#{status}/end

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

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

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

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

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

表を使う

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

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

結果

Rails で使うと

feature ファイルに

○○に○○と入力する✓

○○ボタンをクリックする✓

○○と表示されていること✓

と書ける機能が用意されているらしい

自動でできることは

機械にやらせよう

ご清聴ありがとうございました

rspec と cucumber

Technology

bdd: cucumber + selenium + java

rspec com doubles

tdd - prática com rspec

bdd and cucumber at barcampgz

appium + cucumber framework

intro a rspec, bdd, webapps user acceptance testing

cucumber on kazan.rb

bdd & cucumber

testando rails apps com rspec

rspec on rails tutorial

introduction to guard + rspec

soft industry alliance gmbh · selenium webdriver capybara,...

rspec basics

system automation mit puppet und...

testes Ágeis com bdd · chelimsky, d at al., 2010 - the...

bdd cucumber em 25 minutos

rspec my best practice

rspec - testando suas aplicações ruby on rails

atdd with cucumber

outside-in development with cucumber