Ruby on Rails/第13回勉強会 - Rspecを使ってみる http://www.ark-web.jp/sandbox/wiki/244.html

Ruby on Rails/第13回勉強会 - Rspecを使ってみる

このページは？ †

下記のネタを元にRspecについて勉強してみるページです。

• Rubyist Magazine - スはスペックのス 【第 1 回】 RSpec の概要と、RSpec on Rails (モデル編)
  http://jp.rubyist.net/magazine/?0021-Rspec

• File: TUTORIAL.ja
  http://kakutani.com/trans/rspec/TUTORIAL_ja.html

今回は第２回ということで前回の続きです。
前回はRspecの概要についてしか説明できませんでしたが、今回はRspecの実際の使い方について勉強していきます。

• 第一回はこちら
  Ruby on Rails/第12回勉強会 - Rspec概要

目次 †

日時 †

• 2007/10/19(金)

参加者 †

• 志田さん
• 竹村さん
• 進地さん
• 小沼

動画 †

http://www.screencast.com/t/dq7IJeeo6

本編 †

インストールしてみる †

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

• インストール

  $ 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/

  ちゃんとインストールできてた。

とりあえず使ってみる †

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

記述ルールについて †

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

構造 †

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

  $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 つのスペックファイルというルールはない
  • 一つのクラスに対して複数のスペックファイルで振舞を記述してもよい。

Behavior †

• 振舞
• Test::Unit におけるフィクスチャ (テストクラス) に相当する
• 複数のExampleを含む
• 以下のような書式

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

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を実行する最初の一回のみ実行される。

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

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

特殊なExpectation †

• vilolated

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

• pending

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

まとめ †

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

続き †

• Ruby on Rails/第14回勉強会 - Rails上でRspecを使う

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

|

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

Menu

• システム勉強会
• オープンソース・ライセンスなツールなど
• Plaggerでみんなのブックマークをアグリゲート

Movable Type用プラグイン Aシリーズ

ECサイト構築 Zen Cartハイエンド

Tag

最新の20件

ARK-Webビジネスブログの最新記事