RSpec の履歴(No.7)

&tag(RSpec);

目次†[edit]

参考情報†[edit]

RSpecとは何か†[edit]

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

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

↑

使用方法(簡単編)†[edit]

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編)†[edit]

↑

インストール†[edit]

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編)†[edit]

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

↑

インストール†[edit]

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

↑

テスト実行†[edit]

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より速いかも。

↑

サンプル†[edit]

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

↑

railsプロジェクトを生成†[edit]

普通に生成。

↑

インストール†[edit]

Gemfileに追加し、bundle実行

↑

モデルの生成†[edit]

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

↑

マイグレーション実行†[edit]

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
```

↑

フィクスチャ作成†[edit]

spec/fixtures/blogs.ymlを作る

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

↑

spec作成†[edit]

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実行†[edit]

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

↑

マッチャー一覧†[edit]

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

↑

Tips†[edit]

↑

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

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

↑

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

↑

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

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