RSpec の履歴(No.10)

目次†

参考情報†

Rails
WebMock
database_cleaner
factory_girl
Rubyist Magazine - スはスペックのス【第 1 回】 RSpec の概要と、RSpec on Rails (モデル編)
RSpecの標準Matcher一覧表 - 本当は怖い情報科学
RSpecでテストコードを書いたまとめ - (ﾟ∀ﾟ)o彡 sasata299's blog
Rails3+Guard+Spork+RSpec
A Guide to Testing Rails Applications ― Ruby on Rails Guides RSpecじゃなくて、minitestを使いたい場合

RSpecとは何か†

プログラムの振る舞いを記述するためのドメイン特化言語

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

↑

使用方法(簡単編)†

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

実行。-cオプションをつけると色を表示できる(rspec -c ...)

$ rspec array_spec.rb
rspec array_spec.rb
..

Finished in 0.00312 seconds
2 examples, 0 failures

↑

使用方法(Rails4編)†

↑

インストール†

Gemfileに追加

group :development, :test do
  gem "rspec-rails", "~>2.14.0"
  gem "factory_girl_rails", "~>4.2.1"
end

group :test do
  gem "faker", "~>1.1.2"
  gem "capybara", "~>2.1.0"
  gem "database_cleaner", "~>1.0.1"
  gem "launchy", "~>2.3.0"
  gem "selenium-webdriver", "~>2.39.0"
end

bundle実行
```
bundle install --path vendor/bundle
```

インストール

 bundle exec rails generate rspec:install
      create  .rspec
      create  spec
      create  spec/spec_helper.rb

上のように、Gemfileでgroupを指定したときは、config/application.rbを編集する。これでモデルやコントローラーを作成したときに、*_spec.rbファイルを作る挙動を制御できる。

    config.generators do |g|
      g.test_framework :rspec,
        fixtures: true,
        view_specs: false,
        helper_specs: false,
        routing_specs: false,
        controller_specs: true,
        request_specs: false
      g.fixture_replacement :factory_girl, dir: "spec/factories"
    end

※注意事項)

ちなみに以下のようにgroup指定して、rspec-railsを使う場合、普通にscaffoldするとspecが作られない。
```
group :development, :test do
  gem "rspec-rails"
end
```
これはbundle execの環境がproductionであるため。group指定を以下のようにあらためるか(意味ないけど…)
```
group :production, :development, :test do
  gem "rspec-rails"
end
```

RAILS_ENVを指定する。

RAILS_ENV=development bundle exec rails g

でも間違えないように。config/application.rbをいじったほうが簡単。

↑

使用方法(Rails3編)†

RSpecでRailsのテストをしてみるテスト。 | Ginpen.com

↑

インストール†

Gemfileに追加
```
gem 'rspec-rails'
```
bundle実行
```
bundle install --path=vendor/bundle
```

RSpec用の共通ファイルを用意

bundle exec rails g rspec:install
      create  .rspec
      create  spec
      create  spec/spec_helper.rb

↑

テスト実行†

bundle exec rake spec	spec以下の全てのspecを実行
bundle exec rake spec	spec/modles以下の全てのspecを実行。
bundle exec rake SPEC=spec/models/entry_spec.rb	個別のspecを実行
bundle exec rspec spec/models/entry_spec.rb	個別のspecを実行rakeより速いかも。

↑

サンプル†

Rails 3 でやってみた --『スはスペックのス【第 1 回】 RSpec の概要と、RSpec on Rails (モデル編)』 - 牌語備忘録 - pygo
ブログサンプルを作ってみる

↑

railsプロジェクトを生成†

普通に生成。

↑

インストール†

Gemfileに追加し、bundle実行

↑

モデルの生成†

bundleで実行する

 $ bundle exec rails generate model Blog name:string
 invoke  active_record
      create    db/migrate/20130419052115_create_blogs.rb
      create    app/models/blog.rb
      invoke    rspec
      create      spec/models/blog_spec.rb

↑

マイグレーション実行†

null不可に変更。

class CreateBlogs < ActiveRecord::Migration
  def change
    create_table :blogs do |t|
      t.string :name, :null => false
      t.timestamps
    end
  end
end

マイグレーションを実行する。
```
$ bundle exec rake db:migrate
```

↑

フィクスチャ作成†

spec/fixtures/blogs.ymlを作る

one:
  id: 1
  name: その1
two:
  id: 2
  name: その2

↑

spec作成†

spec/models.blog_spec.rb

# -*- coding: utf-8 -*-
require 'spec_helper'

describe Blog, "#name が設定されていない場合:" do
  before(:each) do
    @blog = Blog.new
  end
  it "バリデーションに失敗すること" do
    @blog.should_not be_valid
  end
end

↑

spec実行†

rake spec SPEC=spec/models/blog_spec.rbを実行する。この段階では失敗。
```
bundle exec rake pec SPEC=spec/models/blog_spec.rb
```

次のようにvalidateすれば成功するようになる

class Blog < ActiveRecord::Base
  attr_accessible :name

  validates  :name, presence:true
end

↑

ひな形の生成†

↑

単体のcontroller specのひな形を生成†

 bundle exec rails g rspec:controller softwares

↑

マッチャー一覧†

xxx.should マッチャー / yyy.should_not マッチャーのように使用する(==もマッチャー)。
RSpecの標準Matcher一覧表 - 本当は怖い情報科学

↑

Tips†

↑

データファイルを読み込む†

ruby on rails - relative File Path in RSpec - Stack Overflowにあるように、__FILE__を使うしかない?

↑

トラブルシューティング†

↑

spec実行時に「`require': cannot load such file -- spec_helper (LoadError)」†

spec_helperを作ってないのかもしれない。以下のコマンドを実行してみる。　rails generate rspec:install

↑

describeでエラー発生「syntax error, unexpected keyword_do_block, expecting => (SyntaxError)」†

describeの書き方が変わったらしい。Myron Marston » RSpec 2.99 and 3.0 RC1 have been released!によると、「Issue a deprecation when described_class is accessed from within a nested describe <SomeClass> example group, since described_class will return the innermost described class in RSpec 3 rather than the outermost described class, as it behaved in RSpec 2. (Myron Marston)」とある。
- 以前:
```
describe Simple, :type => :model ,'説明分' do
```
- 以後:
```
describe '説明分', :type => :model  do
```

RSpec の履歴(No.10)

目次†

関連ページ†

参考情報†

RSpecとは何か†

使用方法(簡単編)†

使用方法(Rails4編)†

インストール†

使用方法(Rails3編)†

インストール†

テスト実行†

サンプル†

railsプロジェクトを生成†

インストール†

モデルの生成†

マイグレーション実行†

フィクスチャ作成†

spec作成†

spec実行†

ひな形の生成†

単体のcontroller specのひな形を生成†

マッチャー一覧†

Tips†

データファイルを読み込む†

トラブルシューティング†

spec実行時に「`require': cannot load such file -- spec_helper (LoadError)」†

describeでエラー発生「syntax error, unexpected keyword_do_block, expecting => (SyntaxError)」†