RSpec2.4.0をRails3.0.3で学ぶ(その1)

Ruby

å‹•æ©Ÿ

Ruby on RailsとRSpecの入門にあたってるびまを参考にさせてもらった。丁寧に説明をしていて、とてもよい記事だと思った。
ただ、RailsとRSpecバージョンが上がってコマンドなどに違いが出てしまっているため、そのままでは実践できない。
これから書くことは、Rails=3.0.3とRSpec=2.4.0を利用して、上記サイトからRSpecを学ぶのをお手伝いできればよいなと思う。差異のみなので、元の記事を読みながら、コマンド実行時やコード記述時などにこちらの内容を見てほしい。

内容

Railsのバージョン確認
 rails -v
Rails プロジェクトの作成
rails new myblog -T -J
RSpec on Rails のインストール
gem install rspec-rails
Gemfileの修正

Gemfile

group :test, :development do
  gem "rspec-rails", "~> 2.4"
end
RSpec on Rails 用ファイルの生成
script/rails generate rspec:install
ジェネレータで Blog モデルを生成する
rails generate scaffold Blog name:string
マイグレーションファイルを編集する

db/migrate/yyyyMMddhhmmss_create_blogs.rb

class CreateBlogs < ActiveRecord::Migration
  def self.up
    create_table :blogs do |t|
      t.string :name, :null => false # null 不可にする

      t.timestamps
    end
  end

  def self.down
    drop_table :blogs
  end
end
データベースを作成する
rake db:migrate
magic comment

Ruby1.9の場合、日本語をファイル内で使用すると例外が発生する。それを回避するには、下記のコードをファイルの最初の行に入れる必要がある。これ以降のspecファイルの最初の行には必ず入れること。発生する理由については、http://jp.rubyist.net/magazine/?0025-Ruby19_m17n#l18が詳しい。

# coding: utf-8
Blog のバリデーションのスペックを定義する

spec/models/blog_spec.rb

describe Blog, "#name が設定されていない場合" do
  before(:each) do
    @blog = Blog.new
    @blog.should have(1).errors_on(:name)
  end

  it "バリデーションに失敗すること" do
    @blog.should_not be_valid
  end
end
Blog クラスに期待される振舞を実装する

app/models/blog.rb

class Blog < ActiveRecord::Base
  validates :name, :presence => true
end

app/model/blog_spec.rb

describe Blog, "#name が設定されていない場合" do
  before(:each) do
    @blog = Blog.new
    @blog.should have(1).errors_on(:name)
  end

  it "バリデーションに失敗すること" do
    @blog.should_not be_valid
  end
end
ジェネレータで Entry モデルを生成する
rails generate model Entry title:string body:text posted_on:date created_at:timestamp updated_at:timestamp blog_id:integer
マイグレーションファイルを編集する

db/migrate/yyyyMMddhhmmss_create_entries.rb

class CreateEntries < ActiveRecord::Migration
  def self.up
    create_table :entries do |t|
      t.string :title, :null => false
      t.text :body, :null => false
      t.date :posted_on
      t.timestamp :created_at
      t.timestamp :updated_at
      t.integer :blog_id, :null => false

      t.timestamps
    end
  end

  def self.down
    drop_table :entries
  end
end
(spec/fixturesを作成する)

なぜかspec/fixturesが作成されなかったため、自分で作成した。ymlファイルはこの下に置けばよい。

mkdir spec/fixtures
「Entry は特定の Blog に属すること」をスペックとして定義する

spec/models/entry_spec.rb

describe Entry do
  fixtures :entries, :blogs

  before(:each) do
    @entry = entries(:kakutani_earliest)
  end

  it "は特定のブログに属すること" do
    @entry.blog.should == blogs(:kakutani)
  end
end
Entry に belongs_to を実装する

app/models/entry.rb

class Entry < ActiveRecord::Base
  belongs_to :blog
end
Blog に has_many を実装する

app/models/blog.rb

class Blog < ActiveRecord::Base
  validates :name, :presence => true
  has_many :entries
end
記事の投稿日に期待する振舞を定義する

app/models/entry.rb

# 元の記事のまま「before_save」を利用すると、DEPRECATION WARNINGが発生する
# 下記のように、メソッドを作成して定義すると解決する
class Entry < ActiveRecord::Base
  belongs_to :blog

  before_save :fill_posted_on

  def fill_posted_on
    self.posted_on ||= Date.today
  end
end