Fabrication!

研究社 新英和中辞典 fabrication 音節 fab ・ ri ・ ca ・ tion 発音記号 / f`æbrɪkéɪʃən / 【名詞】 1 【不可算名詞】 製作 ; 作り 上げ ， でっちあげ ; 偽造 . 2 【可算名詞】 作り ごと，うそ .

機械工学英和和英辞典 [fuel] fabrication 成型加工

Fabrication is a simple, powerful object generation library. Fabrication はシンプルで強力な、 オブジェクト生成ライブラリです。 公式サイト（ http://fabricationgem.org/ ）より

オブジェクト生成？ ↓ これ MyObject.new MyObject.create

それだけ？ 何が嬉しいの？

例： もしもこんな クラスが あったら……

class Book validates :title, presence: true validates :author, presence: true validates :price, presence: true validates :stock, presence: true end 本

４つの必須属性

テスト： タイトルが空なら invalid になること

book = Book.new(title: '', author: 'foo', publisher: 'bar', price: 100) book.should be_invalid 書いてみる

book = Book.new(title: '', # < 空です author: 'foo', # < foo です publisher: 'bar', # < bar です price: 100) # < 100 です book.should be_invalid # < それは不正です コードから伝わる情報

book = Book.new(title: '', # < お前らうるさい author: 'foo', # < えー publisher: 'bar', # < えー price: 100) # < えー book.should be_invalid # < それは不正です ノイズ。

Fabrication!

まず準備として

Fabricator(:book) do title 'MyTitle' author 'MyAuthor' publisher 'MyPublisher' price 1 end

無難なデフォルト値を 定義しておく

book = Fabricate.build(:book, title: '') book.should be_invalid 書いてみるⅡ

book = Fabricate.build(:book, title: '') # < タイトルが空です book.should be_invalid # < それは不正です author < …… publisher < …… price < …… コードから伝わる情報Ⅱ

明確

Fabrication!

http://fabricationgem.org/

ActiveRecord objects

Mongoid Documents

Sequel Models

Installation - インストール -

gem install fabrication

Gemfile: # 基本的にテストで使うが、 # rails console でも使えると便利 group :development, :test do gem 'fabrication' end > bundle install

Defining Fabricators - Fabricator の定義 -

あるクラスに どういうデフォルト値を 与えるか？

例えばこんなクラス # name と job を持つ Person クラス Person.new( name: 'Taro', job: 'Programmer')

# spec/fabricators/person_fabricator.rb Fabricator(:person) do name 'Taro' job 'Programmer' end :personというFabricatorの定義

実際に生成する

3種類の生成メソッド # new して save (create) したものを返す Fabricate (:person) # new だけして save せずに返す Fabricate. build (:person) # 属性の Hash を返す Fabricate. attributes_for (:person)

person = Fabricate(:person, name: &quot;Hanako&quot; ) person.name # => “Hanako” person.job # => “Programmer” 属性の値を明示する

# ( 引数の Hash の方が優先 ) Fabricate(:person, :name => &quot;Ichiro&quot;) do job &quot;Baseballer&quot; end ブロックも渡せる

基本的な使い方 以上。

もっと詳しく Fabricator 定義

# spec/fabricators/person_fabricator.rb Fabricator(:person) do name 'Taro' job 'Programmer' end 再掲

Fabricator(:person) do # テストデータ生成ライブラリを使う name { Faker::Name.name } # ランダムな値を使う job { %w( Singer Desinger Manager).sample } end ブロックも使える

Fabricator(:person) do name { %w(alice bob carol).sample } # 名前からメールアドレスを決める email { |person| &quot;#{ person.name }@example.com&quot; } end 属性は上から順に決まっていく

# 呼ぶごとに 0 から増えてい く Fabricate. sequence # シーケンスに名前をつけて区別する Fabricate.sequence( :name ) # 0 じゃなく 99 から始める Fabricate.sequence(:number, 99 ) # ブロックも渡せる Fabricate.sequence(:name) { |i| &quot;Name #{i}&quot; } Sequence

Fabricator(:person) do ssn { sequence(:ssn, 111111111) } email { sequence(:email) { |i| &quot;user#{i}@example.com&quot; } } end ユニーク制約にはSequence

class Person belongs_to :vehicle # 乗り物 validates :vehicle_id, presence: true # … は必須 end # Vehicle は↓これでいいとして、 class Vehicle validates :name, presence: true end Fabricator(:vehicle) do name 'name1' end 例：Personは必ずVehicleを持つ

# こう書けるが、 Fabricator(:person) do vehicle { Fabricate( :vehicle ) } end # これでも同じ意味になる Fabricator(:person) do vehicle end ただ属性名だけを書く

例：属性名とモデル名が違う場合 class Person belongs_to :ride, class_name: 'Vehicle' validates :vehicle_id, presence: true end # person.vehicle ではなく person.ride # で Vehicle オブジェクトにアクセス

:fabricatorオプションを渡す # こう書けるが Fabricator(:person) do ride { Fabricate( :vehicle ) } end # これでも同じ意味になる Fabricator(:person) do ride( fabricator: :vehicle ) end

継承 Fabricator(:person) do name 'name1' age 20 end # :person をベースに :child を定義する Fabricator(:child, from: :person ) do age 10 end child = Fabricate(:child) child.name # => 'name1' child.age # => 10

対コンストラクタ # x と y が無いと new できない class Location def initialize(x, y) @x, @y = x, y end end Fabricator(:location) do on_init { init_with (30.284167, -81.396111) } end

Callback Fabricator(:person) do # Fabricate.build 後に geolocate! する after_build { |person| place.geolocate! } # Fabricate(:person) 後に Restaurant を作る after_create { |person| Fabricate(:restaurant, place: person.place) } end

Configuration - 設定 -

ここに Fabricator 定義を置けば 勝手に読まれる spec/fabricators/**/*fabricator.rb test/fabricators/**/*fabricator.rb

Fabrication.configure do |config| # fabricator 定義の置き場所 fabricator_dir = &quot;data/fabricators&quot; # 複数ある場合は配列でもよし # fabricator_dir = [&quot;data/fabricators&quot;, # &quot;spec/fabricators&quot;] end

Fabrication!

使用上の注意 （リアル話）

Fabricator(:item) do seller( fabricator: :shop ) main_category( fabricator: :category ) sub_categories( fabricator: :category, count: 3 ) users( fabricator: :user, count: 3 ) etc... etc... end 連鎖

テスト時間 30 分 -> 2 時間

これをプロジェクト初期に明示、周知

根本的に、 テストの速度は大事 。 教訓

ちなみに、こうして解決しました Fabricator(:item) do main_category do Category.first || Fabricate(:category) end end by @kengos

describe User do it 'full_name は苗字＋名前になる ' do user = Fabricate(:user) user.full_name.should == 'Yamada Taro' end end テストの可読性

テスト対象の値は明示する。 it 'full_name は苗字＋名前になる ' do user = Fabricate(:user, first_name: 'Taro', last_name: 'Yamada' ) user.full_name.should == 'Yamada Taro' end

合わせて読みたいサイト２つ

Test Context Arrangement Recipebook @moro, RubyKaigi2011 http://www. slideshare .net/moro/test-context-arrangement-recipebook 使い分けの研究

resource （生成・変更される）

event （関連）

データ生成方法３種類

fixture （ fixtures/foo.yml ）

fixture replacement （ fabricator ）

before/setup （ Foo.new ）

どれに何を使うべきか

Fabrication の目的 ・テストを書きやすく ・テストを読みやすく

RSpec の入門とその一歩先へ http://d.hatena.ne.jp/t-wada/20100228/p1 t-wadaの日記 RSpecも知っとこう

ありがとう ございました