factory_botとは

簡単にダミーのインスタンスを作成することができるGemです。他のファイルで予め各クラスのインスタンスに定めるプロパティを設定しておき、specファイルからメソッドを利用してその通りのインスタンスを作成します。

導入方法

Gemfileに以下のように記載

Gemfile

group :development, :test do
  #省略
  gem 'factory_bot_rails'
end

bundle installします。

specディレクトリ内に’factories’というディレクトリを作成し、（今回はuserのテストをするので）users.rbというファイルを作成します。

factory_bot を使ってuserを定義する

先ほど作成したfactories/users.rb 内にダミーのuserを定義します。

factories/users.rb

FactoryBot.define do
  factory :user do
    name                  {"tanu"}
    email                 {"test@email.com"}
    password              {"11111111"}
    password_confirmation {"11111111"}
  end
end

定義したuserをテスト内で使う

先に定義したuserは下記のように使用します。

spec/model/user_spec.rb

describe User do
  describe '#create' do
    it 'is invalid without a name' do
      user = FactoryBot.build(:user, name: nil)
      user.valid?
      expect(user.errors[:name]).to include("を入力してください")
    end
  end
end

これは、下記の内容と一緒です。（下記は、factory_botを使用しないで、同じ内容を記述した例）

describe User do
  describe '#create' do
    it 'is invalid without a name' do
      user = User.new(name: "", email: "test@email.com", password: "11111111", password_confirmation: "11111111")
      user.valid?
      expect(user.errors[:name]).to include("を入力してください")
    end
  end
end

なお、

user = FactoryBot.build(:user, name: nil)

の FactoryBotは省略可能で、上記は、

user = build(:user, name: nil)

と書くこともできます。

buildメソッドとcreateメソッド

factory_botのメソッドのうち

build　...　インスタンスを生成するメソッド。newと同じ
create ... データのsaveまでを行う。ただし、saveされたデータは、１回のテストが終わったら消えてしまう。

という特徴がそれぞれあるそうです。

レシーバーの"FactoryBot"という記述を省略する

さらに、rails_helperに下記のような記述をしておくことで、"FactoryBot"という記述は省略できるそうです。

spec/rails_helper.rb


RSpec.configure do |config|
  #下記の記述を追加
  config.include FactoryBot::Syntax::Methods
  #省略
end

上記の記述によって、テストの記述は下記のように省略できます。

user = build(:user, name: nil)

テストはしっかり学習しておくように周りから色々なアドバイスを受けるのですが、なかなか奥が深いですね。また折を見て復習したいです。