Ruby on Rails/第13回勉強会 - Rspecを使ってみるのバックアップ(No.5) : アークウェブ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

1 つのクラス (モジュール) に対して必ず 1 つのスペックファイルというルールはない
spec(1)-(n)Behavior(1)-(n)Example(1)-(n)Expectation

↑

[edit]

Behavior †

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

以下のような書式

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

↑

[edit]

Example †

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

以下のような書式

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

testのset_up、tera_downに相当するbefore / after というメソッドがある。
```
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]

テストとの比較 †

↑

[edit]

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

このページは？ †

目次 †

日時 †

参加者 †

動画 †

本編 †

インストールしてみる †

とりあえず使ってみる †

記述ルールについて †

構造 †

Behavior †

Example †

Expectation †

特殊なExpectation †

テストとの比較 †

まとめ †

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