README.md

PLEASE NOTE, THIS PROJECT IS NO LONGER BEING MAINTAINED

FactoryGirl Seeds

Don't like factory_girl because it is slow? Do you know that creating records in DB through factory_girl can take up to 50% of total spec run time? And even more!

This tiny gem helps fix that problem by reusing data preloaded before running test suite.

Demo

Without seeds:

Finished in 4 minutes 38.7 seconds
1402 examples, 0 failures, 0 pending

With seeds:

Finished in 2 minutes 40.6 seconds
1402 examples, 0 failures, 0 pending

>> (2.minutes + 40.6.seconds) / (4.minutes + 38.7.seconds)
=> 0.5762468604233943

So it is just about 58% of time before seeds optimization :)

Getting Started

Installation

Add this line to your application's Gemfile:

group :test do
  gem 'factory_girl-seeds'
end

Usage

1. Create records before test suite

FactoryGirl::SeedGenerator.create(:user, name: "Carlos Castaneda")

For example if you are using rspec then add this to config.before(:suite).

2. Use in factory definitions

This is the most important step because most of time factory_girl spends on creating associations which in turn also create associations and so on recursively.

FactoryGirl.define do
  factory :post do
    title "Demo"
    user { seed(:user) }
  end
end

3. Use in it blocks.

Also if you need standard factory without overriding attributes then do not create records. Just use one from preloaded seeds.

it "should do something" do
  user = FactoryGirl.seed(:user)

  # your code here
end

Short DSL also available:

user = seed(:user)

4. Using Factory Girl traits

You can create models via factories and traits (like create(:user, admin)), but you can not obtain it with the seed(:user, :admin). To be able to obtain a record it is recommended to define specific factories with a set of traits and unique names just like in the example in Getting stated guide:

factory :user do
  name "Friendly User"
  login { name }

  trait :male do
    name   "John Doe"
    gender "Male"
  end

  trait :female do
    name   "Jane Doe"
    gender "Female"
  end

  trait :admin do
    admin true
  end

  factory :male_admin,   traits: [:male, :admin]
  factory :female_admin, traits: [:admin, :female]
end

When factories declared in this manner, you can obtain a record with seed(:male_admin)

FactoryGirl::SeedGenerator.create method creates record in DB before transaction begins. Then it block starts transaction so when you update record returned by FactoryGirl.seed it is wrapped in transaction. This guarantees that every it block works with clean record.

Contributing

Please read Code of Conduct and Contributing Guidelines for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Changelog

The changelog is here.

Authors

• Alexander Balashov - Initial work

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License.