Ruby on Rails/第13回勉強会 - Rspecを使ってみるのバックアップ(No.6) : アークウェブWebマーケティングSandBox

$ su
# gem install rspec
Bulk updating Gem source index for: http://gems.rubyforge.org
Successfully installed rspec-1.0.8
Installing ri documentation for rspec-1.0.8...
Installing RDoc documentation for rspec-1.0.8...

ちゃんとインストールされたかチェック
```
$spec -v
RSpec-1.0.8 (r2338) - BDD for Ruby
http://rspec.rubyforge.org/
```
ちゃんとインストールできてた。

↑

[edit]

とりあえず使ってみる †

http://jp.rubyist.net/magazine/?0021-Rspec#l19

上記ページでサンプルとしてあるArrayクラスへの振舞の記述をしてみる。

$emacs test/rspec/array_spec.rb

で以下を貼り付け

describe Array, "when empty" do
  before do
    @empty_array = []
  end

  it "should be empty" do
    @empty_array.should be_empty
  end

  it "should size 0" do
    @empty_array.size.should == 0
  end

  after do
    @empty_array = nil
  end
end

で実行

$ spec array_spec.rb
..

Finished in 0.047857 seconds

2 examples, 0 failures

うーん、サンプル通り。

色をつける
```
$ spec -c test/rspec/array_spec.rb 
```

仕様書っぽく出力する

$ spec -fs test/rspec/array_spec.rb 

Array when empty
- should be empty
- should size 0

Finished in 0.007583 seconds

2 examples, 0 failures

↑

[edit]

記述ルールについて †

http://jp.rubyist.net/magazine/?0021-Rspec#l26

↑

[edit]

構造 †

Rspecの構成要素	記述例	testUnitで対応するもの
specファイル	array_rspec.rb	Testファイル
Behavior	describe Array, "when empty" do end	testクラス
Example	it "should be empty" do end	testケース
Expectation	@empty_array.should be_empty	assert文

上記の対応を実際のサンプルで確認する。

$emacs test/rspec/array_spec.rb  #specファイル
----
describe Array, "when empty" do #Behavior
  before do
    @empty_array = []
  end

  it "should be empty" do #Example
    @empty_array.should be_empty #Expectation
  end

  it "should size 0" do #Example
    @empty_array.size.should == 0 #Expectation
  end

  after do
    @empty_array = nil
  end
end

上記の各要素の関連図
- spec(1)-(n)Behavior(1)-(n)Example(1)-(n)Expectation
スペックファイルとテスト対象のプログラムの関連
- 1 つのクラス (モジュール) に対して必ず 1 つのスペックファイルというルールはない
- 一つのクラスに対して複数のスペックファイルで振舞を記述してもよい。

↑

[edit]

Behavior †

振舞
Test::Unit におけるフィクスチャ (テストクラス) に相当する
複数のExampleを含む

以下のような書式

describe Array "when empty" do #Arrayクラスがemptyのときの振舞
  ..
end

↑

[edit]

Example †

実行可能なサンプル
Test::Unit におけるテストメソッドに相当する
複数のExpectationを含む

以下のような書式

 it "should be empty" do #空であること
   ...
 end

Exampleとは違うが、テストユニットにおけるset_up / tera_downに相当するbefore / after というメソッドがRspecにはある。
```
before do
  振
end
after do
end
```
- before(:all),after(:all)というものもある。これはExampleのたびにではなく、Behaviourを実行する最初の一回のみ実行される。

↑

[edit]

Expectation †

プログラムに期待する動作や動作結果
Test::Unit におけるassert文に相当する

以下のような書式

result.should == 37 #結果は37となる

↓一般化

actual.should matcher(expected)

matcherの部分には以下のようなものを使うことができる

マッチャ

演算子のマッチャ
マッチャ名	内容
<
<=
==
===
=~

>=
演算子以外のビルトインのマッチャ
be_close(expected, delta)	「(actual - expected).abs < delta」が成立することを期待します
change	actual が Proc である場合に利用できます。change の引数を使って、期待するオブジェクト状態の変化を記述します。後ほど説明しますが、RDocの記述も参照してください
eql(expected)
equal(expected)
have(number).items	要素数が number であることを期待します
have_at_least(number).items
have_at_most(number).items
have_exactly
include(expected)	actual が String か Array である場合に、actual.include?(expected) を期待します
match(regexp)	actial =~ regexp であることを期待します
raise_error(expected)
respond_to(*names)
satisfy{}
throw_symbol(:expected=nil)
その他のマッチャ
be_xxx	should be_empty,be_instance_of,be_kind_oflなど。(be_a_kind_ofなど冠詞をつけることもできる)
be_true
be_false
have_xxx

他にもユーザー自身でマッチャを定義することもできる

↑

[edit]

特殊なExpectation †

vilolated

violated "always fail!" # 必ず実行に失敗する

pending

pending("for obvious reason") do
   true.should be_false # 保留したい評価(未実装など)
end

↑

[edit]

まとめ †

インストールの仕方が分かった！
記述の仕方が分かった！
利便性はまだよく分からない！

投稿者小沼? | パーマリンク?

tag: Ruby on Rails?, 勉強会?,テスト?

アークウェブWebマーケティングSandBox

このページは？ †

目次 †

日時 †

参加者 †

動画 †

本編 †

インストールしてみる †

とりあえず使ってみる †

記述ルールについて †

構造 †

Behavior †

Example †

Expectation †

特殊なExpectation †

まとめ †

アークウェブのサービスやソリューションはこちら