Prefactory

The ease and fidelity of factories with the performance of static fixtures.

Prefactory allows you to create factory objects and perform other expensive ActiveRecord operations in RSpec before(:all) blocks, transparently wrapping example groups in nested transactions to automatically roll back any data changes that occur during a specific test.

Requirements

ActiveRecord >= 4
RSpec
FactoryGirl
A database for which ActiveRecord supports nested transactions (e.g. MySQL, Postgresql)

Installation

Add the gem to the :test group in your Rails application's Gemfile:

group :test do
  gem 'prefactory'
end

Add this to your RSpec spec_helper.rb

RSpec.configure do |config|
  config.include Prefactory

  # ensure Rails' transaction fixtures are disabled
  config.use_transactional_fixtures = false

  # optional, to enable shorthand creation
  # using only Factory name (see examples, below)
  config.include FactoryGirl::Syntax::Methods
end

Example

describe User do
  before :all do   # executes once

    # invokes FactoryGirl.create(:user)
    # reference object as 'friend' in tests
    prefactory_add(:friend) { FactoryGirl.create :user }

    # invokes create(:user) if available, e.g
    # if rspec is configured with:
    #   config.include FactoryGirl::Syntax::Methods
    # reference object as 'user' in examples
    prefactory_add :user

  end

  # convenience method, equivalent to:
  # before(:all) do
  #   prefactory_add(:other_friend) do
  #     create :user
  #   end
  # end
  set!(:other_friend) { create :user }

  context 'a new user has no friends' do

    it { user.friends.count.should == 0 }

    context 'with a friend' do
      before(:all) { user.add_friend(friend) }   # executes once

      it { user.friends.count.should == 1 }

      # these changes will be transparently rolled back
      it "allows removing the friend" do
        expect { user.remove_friend(friend) }.to_not raise_error
        user.friends.count.should == 0
      end

      it "disallows adding the same friend again" do
        expect { user.add_friend(friend) }.to raise_error
        user.friends.count.should == 1
      end

      # these changes will be transparently rolled back
      it "allows adding a different friend" do
        expect { user.add_friend(other_friend) }.to_not raise_error
        user.friends.count.should == 2
      end

      it { user.friends.should include friend }
      it { user.friends.should_not include other_friend }
    end
  end
end

Contributing

Fork it ( http://github.com/socialcast/prefactory/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a pull request

Prefactory

Requirements

Installation

Example

Contributing

Copyright