factory_girl 4.2.0 → 4.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6276447e1d14327c827a7b14fe08b3bbc729d07b
+  data.tar.gz: d8eac964100d437c88ad82ad217a267285ff7461
+SHA512:
+  metadata.gz: c25de9107b3313fe1b40d5713f2a2446ce569bb68923eb8a084af42c50a050571e4b98fee61bf534d77bce8b3751cf832b65793d4058dceb8571e369ab4fa7e8
+  data.tar.gz: 8464e558d14c2a3e0f890af7010dc4c85652c56656a6d0d9b2ec948eb0519e9be15fad7ce843f7124c6437d97343d70b2e320d3e7e2df034e7ce5be5f4f5aca6

data/.travis.yml

@@ -1,16 +1,17 @@
 rvm:
-  - 1.9.2
   - 1.9.3
+  - 2.0.0
   - jruby-19mode
 before_install:
   - gem update --system
+install: "bundle install"
 script: "bundle exec rake spec:unit spec:acceptance features"
 jdk:
   - openjdk6
 gemfile:
-  - gemfiles/3.0.gemfile
   - gemfiles/3.1.gemfile
   - gemfiles/3.2.gemfile
+  - gemfiles/4.0.gemfile
 branches:
   only:
     - master

data/Appraisals

@@ -1,15 +1,11 @@
-appraise "3.0" do
-  gem "activerecord", "~> 3.0.19"
-end
-
 appraise "3.1" do
-  gem "activerecord", "~> 3.1.10"
+  gem "activerecord", "~> 3.1.12"
 end
 
 appraise "3.2" do
-  gem "activerecord", "~> 3.2.11"
+  gem "activerecord", "~> 3.2.15"
 end
 
 appraise '4.0' do
-  gem 'activerecord', github: 'rails/rails'
+  gem 'activerecord', "~> 4.0.1"
 end

data/GETTING_STARTED.md

@@ -19,7 +19,7 @@ gem "factory_girl", "~> 4.0"
 JRuby users: FactoryGirl works with JRuby starting with 1.6.7.2 (latest stable, as per July 2012).
 JRuby has to be used in 1.9 mode, for that, use JRUBY_OPTS environment variable:
 
-```
+```bash
 export JRUBY_OPTS=--1.9
 ```
 
@@ -30,7 +30,7 @@ Using Without Bundler
 
 If you're not using Bundler, be sure to have the gem installed and call:
 
-```
+```ruby
 require 'factory_girl'
 ```
 
@@ -498,7 +498,7 @@ factory :user do
 end
 
 # will increase value counter for :email which is shared by :sender and :receiver
-FactoryGirl.next(:sender)
+FactoryGirl.generate(:sender)
 ```
 
 Define aliases and use default value (1) for the counter
@@ -563,7 +563,7 @@ Traits can be used as attributes:
 factory :week_long_published_story_with_title, parent: :story do
   published
   week_long_publishing
-  title { "Publishing that was started at {start_at}" }
+  title { "Publishing that was started at #{start_at}" }
 end
 ```
 
@@ -695,6 +695,24 @@ end
 # creates an admin user with name "John Doe"
 FactoryGirl.create(:post).author
 ```
+
+Finally, traits can be used within other traits to mix in their attributes.
+
+```ruby
+FactoryGirl.define do
+  factory :order do
+    trait :completed do
+      completed_at { 3.days.ago }
+    end
+
+    trait :refunded do
+      completed
+      refunded_at { 1.day.ago }
+    end
+  end
+end
+```
+
 Callbacks
 ---------
 
@@ -748,6 +766,40 @@ factory :user do
 end
 ```
 
+To override callbacks for all factories, define them within the
+`FactoryGirl.define` block:
+
+```ruby
+FactoryGirl.define do
+  after(:build) {|object| puts "Built #{object}" }
+  after(:create) {|object| AuditLog.create(attrs: object.attributes) }
+
+  factory :user do
+    name "John Doe"
+  end
+end
+```
+
+You can also call callbacks that rely on `Symbol#to_proc`:
+
+```ruby
+# app/models/user.rb
+class User < ActiveRecord::Base
+  def confirm!
+    # confirm the user account
+  end
+end
+
+# spec/factories.rb
+FactoryGirl.define do
+  factory :user do
+    after :create, &:confirm!
+  end
+end
+
+FactoryGirl.create(:user) # creates the user and confirms it
+```
+
 Modifying factories
 -------------------
 
@@ -816,6 +868,13 @@ To set the attributes for each of the factories, you can pass in a hash as you n
 twenty_year_olds = FactoryGirl.build_list(:user, 25, date_of_birth: 20.years.ago)
 ```
 
+There's also a set of `*_pair` methods for creating two records at a time:
+
+```ruby
+built_users   = FactoryGirl.build_pair(:user) # array of two built users
+created_users = FactoryGirl.create_pair(:user) # array of two created users
+```
+
 Custom Construction
 -------------------
 
@@ -835,7 +894,7 @@ class User
 end
 
 # factories.rb
-sequence(:name) {|n| "person#{n}@example.com" }
+sequence(:email) {|n| "person#{n}@example.com" }
 
 factory :user do
   ignore do
@@ -1103,3 +1162,40 @@ config.after(:suite) do
   puts @factory_girl_results
 end
 ```
+
+Rails Preloaders and RSpec
+--------------------------
+
+When running RSpec with a Rails preloader such as `spring` or `zeus`, it's possible
+to encounter an `ActiveRecord::AssociationTypeMismatch` error when creating a factory
+with associations, as below:
+
+```ruby
+FactoryGirl.define do
+  factory :united_states, class: Location do
+    name 'United States'
+    association :location_group, factory: :north_america
+  end
+  
+  factory :north_america, class: LocationGroup do
+    name 'North America'
+  end
+end
+```
+
+The error occurs during the run of the test suite:
+
+```
+Failure/Error: united_states = FactoryGirl.create(:united_states)
+ActiveRecord::AssociationTypeMismatch:
+  LocationGroup(#70251250797320) expected, got LocationGroup(#70251200725840)
+```
+
+The two possible solutions are to either run the suite without the preloader, or
+to add `FactoryGirl.reload` to the RSpec configuration, like so:
+
+```ruby
+RSpec.configure do |config|
+  config.before(:suite) { FactoryGirl.reload }
+end
+```

data/Gemfile

@@ -1,5 +1,5 @@
 source "http://rubygems.org"
 
-gem "activerecord", :require => false
+gem "activerecord", ">= 3.0.0", :require => false
 
 gemspec

data/Gemfile.lock

@@ -1,57 +1,61 @@
 PATH
   remote: .
   specs:
-    factory_girl (4.2.0)
+    factory_girl (4.3.0)
       activesupport (>= 3.0.0)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    activemodel (3.2.3)
-      activesupport (= 3.2.3)
-      builder (~> 3.0.0)
-    activerecord (3.2.3)
-      activemodel (= 3.2.3)
-      activesupport (= 3.2.3)
-      arel (~> 3.0.2)
-      tzinfo (~> 0.3.29)
-    activesupport (3.2.3)
-      i18n (~> 0.6)
-      multi_json (~> 1.0)
-    appraisal (0.5.1)
+    activemodel (4.0.0)
+      activesupport (= 4.0.0)
+      builder (~> 3.1.0)
+    activerecord (4.0.0)
+      activemodel (= 4.0.0)
+      activerecord-deprecated_finders (~> 1.0.2)
+      activesupport (= 4.0.0)
+      arel (~> 4.0.0)
+    activerecord-deprecated_finders (1.0.3)
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    appraisal (0.5.2)
       bundler
       rake
-    arel (3.0.2)
-    aruba (0.4.11)
-      childprocess (>= 0.2.3)
+    arel (4.0.0)
+    aruba (0.5.3)
+      childprocess (>= 0.3.6)
       cucumber (>= 1.1.1)
-      ffi (>= 1.0.11)
-      rspec (>= 2.7.0)
-    bourne (1.3.0)
-      mocha (= 0.13.0)
-    builder (3.0.4)
-    childprocess (0.3.2)
-      ffi (~> 1.0.6)
-    cucumber (1.2.1)
+      rspec-expectations (>= 2.7.0)
+    atomic (1.1.10)
+    atomic (1.1.10-java)
+    bourne (1.5.0)
+      mocha (>= 0.13.2, < 0.15)
+    builder (3.1.4)
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    cucumber (1.2.5)
       builder (>= 2.1.2)
       diff-lcs (>= 1.1.3)
-      gherkin (~> 2.11.0)
-      json (>= 1.4.6)
+      gherkin (~> 2.11.7)
+      multi_json (~> 1.3)
     diff-lcs (1.1.3)
-    ffi (1.0.11)
-    ffi (1.0.11-java)
-    gherkin (2.11.5)
-      json (>= 1.4.6)
-    gherkin (2.11.5-java)
-      json (>= 1.4.6)
-    i18n (0.6.1)
-    json (1.7.5)
-    json (1.7.5-java)
+    ffi (1.9.0)
+    ffi (1.9.0-java)
+    gherkin (2.11.8)
+      multi_json (~> 1.3)
+    gherkin (2.11.8-java)
+      multi_json (~> 1.3)
+    i18n (0.6.4)
     metaclass (0.0.1)
-    mocha (0.13.0)
+    minitest (4.7.5)
+    mocha (0.14.0)
       metaclass (~> 0.0.1)
-    multi_json (1.5.0)
-    rake (0.9.2.2)
+    multi_json (1.7.7)
+    rake (10.1.0)
     rspec (2.12.0)
       rspec-core (~> 2.12.0)
       rspec-expectations (~> 2.12.0)
@@ -59,22 +63,26 @@ GEM
     rspec-core (2.12.2)
     rspec-expectations (2.12.1)
       diff-lcs (~> 1.1.3)
-    rspec-mocks (2.12.1)
-    simplecov (0.6.2)
-      multi_json (~> 1.3)
-      simplecov-html (~> 0.5.3)
-    simplecov-html (0.5.3)
-    sqlite3 (1.3.7)
-    timecop (0.3.5)
-    tzinfo (0.3.33)
-    yard (0.8.1)
+    rspec-mocks (2.12.2)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    sqlite3 (1.3.8)
+    thread_safe (0.1.2)
+      atomic
+    thread_safe (0.1.2-java)
+      atomic
+    timecop (0.6.2.2)
+    tzinfo (0.3.37)
+    yard (0.8.7)
 
 PLATFORMS
   java
   ruby
 
 DEPENDENCIES
-  activerecord
+  activerecord (>= 3.0.0)
   appraisal (~> 0.5.1)
   aruba
   bourne

data/README.md

@@ -1,4 +1,4 @@
-# factory_girl [![Build Status](https://secure.travis-ci.org/thoughtbot/factory_girl.png)](http://travis-ci.org/thoughtbot/factory_girl?branch=master) [![Dependency Status](https://gemnasium.com/thoughtbot/factory_girl.png)](https://gemnasium.com/thoughtbot/factory_girl)
+# factory_girl [![Build Status](https://secure.travis-ci.org/thoughtbot/factory_girl.png)](http://travis-ci.org/thoughtbot/factory_girl?branch=master) [![Dependency Status](https://gemnasium.com/thoughtbot/factory_girl.png)](https://gemnasium.com/thoughtbot/factory_girl) [![Code Climate](https://codeclimate.com/github/thoughtbot/factory_girl.png)](https://codeclimate.com/github/thoughtbot/factory_girl)
 
 factory_girl is a fixtures replacement with a straightforward definition syntax, support for multiple build strategies (saved instances, unsaved instances, attribute hashes, and stubbed objects), and support for multiple factories for the same class (user, admin_user, and so on), including factory inheritance.
 
@@ -51,16 +51,9 @@ Please see the [contribution guidelines](https://github.com/thoughtbot/factory_g
 Credits
 -------
 
-factory_girl was written by Joe Ferris with contributions from several authors, including:
-
-* Alex Sharp
-* Eugene Bolshakov
-* Jon Yurek
-* Josh Nichols
-* Josh Owens
-* Nate Sutton
-* Josh Clayton
-* Thomas Walpole
+factory_girl was originally written by Joe Ferris and is now maintained by Josh
+Clayton. Many improvements and bugfixes were contributed by the [open source
+community](https://github.com/thoughtbot/factory_girl/graphs/contributors).
 
 ![thoughtbot](http://thoughtbot.com/assets/tm/logo.png)
 
@@ -71,4 +64,4 @@ The names and logos for thoughtbot are trademarks of thoughtbot, inc.
 License
 -------
 
-factory_girl is Copyright © 2008-2013 Joe Ferris and thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.
+factory_girl is Copyright © 2008-2013 Joe Ferris and thoughtbot. It is free software, and may be redistributed under the terms specified in the [LICENSE](https://github.com/thoughtbot/factory_girl/blob/master/LICENSE) file.

data/Rakefile

@@ -9,8 +9,8 @@ require 'cucumber/rake/task'
 Bundler::GemHelper.install_tasks
 
 desc 'Default: run the specs and features.'
-task :default => 'spec:unit' do
-  system("bundle exec rake -s appraisal spec:acceptance features;")
+task :default do
+  system("bundle exec rake -s appraisal spec:unit spec:acceptance features;")
 end
 
 namespace :spec do

data/factory_girl.gemspec

@@ -40,5 +40,6 @@ Gem::Specification.new do |s|
   end
 
   s.add_development_dependency("yard")
+  s.license = "MIT"
 end
 

data/gemfiles/3.1.gemfile

@@ -2,6 +2,6 @@
 
 source "http://rubygems.org"
 
-gem "activerecord", "~> 3.1.10"
+gem "activerecord", "~> 3.1.12"
 
 gemspec :path=>"../"

data/gemfiles/3.1.gemfile.lock

@@ -1,52 +1,54 @@
 PATH
-  remote: /Users/joshuaclayton/dev/gems/factory_girl
+  remote: ../
   specs:
-    factory_girl (4.2.0)
+    factory_girl (4.3.0)
       activesupport (>= 3.0.0)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    activemodel (3.1.10)
-      activesupport (= 3.1.10)
+    activemodel (3.1.12)
+      activesupport (= 3.1.12)
       builder (~> 3.0.0)
       i18n (~> 0.6)
-    activerecord (3.1.10)
-      activemodel (= 3.1.10)
-      activesupport (= 3.1.10)
+    activerecord (3.1.12)
+      activemodel (= 3.1.12)
+      activesupport (= 3.1.12)
       arel (~> 2.2.3)
       tzinfo (~> 0.3.29)
-    activesupport (3.1.10)
-      multi_json (>= 1.0, < 1.3)
-    appraisal (0.5.1)
+    activesupport (3.1.12)
+      multi_json (~> 1.0)
+    appraisal (0.5.2)
       bundler
       rake
     arel (2.2.3)
-    aruba (0.5.1)
-      childprocess (~> 0.3.6)
+    aruba (0.5.3)
+      childprocess (>= 0.3.6)
       cucumber (>= 1.1.1)
       rspec-expectations (>= 2.7.0)
-    bourne (1.3.0)
-      mocha (= 0.13.0)
+    bourne (1.4.0)
+      mocha (~> 0.13.2)
     builder (3.0.4)
-    childprocess (0.3.6)
-      ffi (~> 1.0, >= 1.0.6)
-    cucumber (1.2.1)
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    cucumber (1.2.5)
       builder (>= 2.1.2)
       diff-lcs (>= 1.1.3)
-      gherkin (~> 2.11.0)
-      json (>= 1.4.6)
+      gherkin (~> 2.11.7)
+      multi_json (~> 1.3)
     diff-lcs (1.1.3)
-    ffi (1.3.1)
-    gherkin (2.11.5)
-      json (>= 1.4.6)
-    i18n (0.6.1)
-    json (1.7.6)
+    ffi (1.9.0)
+    ffi (1.9.0-java)
+    gherkin (2.11.8)
+      multi_json (~> 1.3)
+    gherkin (2.11.8-java)
+      multi_json (~> 1.3)
+    i18n (0.6.4)
     metaclass (0.0.1)
-    mocha (0.13.0)
+    mocha (0.13.3)
       metaclass (~> 0.0.1)
-    multi_json (1.2.0)
-    rake (10.0.3)
+    multi_json (1.7.7)
+    rake (10.1.0)
     rspec (2.12.0)
       rspec-core (~> 2.12.0)
       rspec-expectations (~> 2.12.0)
@@ -54,21 +56,22 @@ GEM
     rspec-core (2.12.2)
     rspec-expectations (2.12.1)
       diff-lcs (~> 1.1.3)
-    rspec-mocks (2.12.1)
+    rspec-mocks (2.12.2)
     simplecov (0.7.1)
       multi_json (~> 1.0)
       simplecov-html (~> 0.7.1)
     simplecov-html (0.7.1)
-    sqlite3 (1.3.7)
-    timecop (0.5.9)
-    tzinfo (0.3.35)
-    yard (0.8.3)
+    sqlite3 (1.3.8)
+    timecop (0.6.1)
+    tzinfo (0.3.37)
+    yard (0.8.6.1)
 
 PLATFORMS
+  java
   ruby
 
 DEPENDENCIES
-  activerecord (~> 3.1.10)
+  activerecord (~> 3.1.12)
   appraisal (~> 0.5.1)
   aruba
   bourne