factory_girl-seeds 1.0.0 → 1.0.1

data/README.md

@@ -2,30 +2,35 @@
 
 # FactoryGirl Seeds
 
-Make your test suite run time upto 2x faster and even more! factory_girl is a very usefull gem
-for creating records in your DB easily but also is very sloooow. This small repo helps fix that problem.
+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!
 
-## Installation
+This tiny gem helps fix that problem by reusing data preloaded before running test suite.
 
-Add this line to your application's Gemfile:
+![](seed.jpg)
 
-    group :test do
-      gem 'factory_girl-seeds', github: 'evrone/factory_girl-seeds'
-    end
+## Installation
 
-And then execute:
+Add this line to your application's Gemfile:
 
-    $ bundle
+```ruby
+group :test do
+  gem 'factory_girl-seeds'
+end
+```
 
 ## Usage
 
-Create records before test suite:
+### 1. Create records before test suite
 
 ```ruby
 FactoryGirl::SeedGenerator.create(:user, name: "John Appleseed")
 ```
 
-And then use in other factory definitions
+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.
 
 ```ruby
 FactoryGirl.define do
@@ -36,12 +41,28 @@ FactoryGirl.define do
 end
 ```
 
-or in specs
+### 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.
 
 ```ruby
-@user = seed(:user)
+it "should do something" do
+  user = FactoryGirl.seed(:user)
+
+  # your code here
+end
 ```
 
+Short DSL also available:
+
+```ruby
+user = seed(:user)
+```
+
+## How it works?
+
+```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
 
 1. Fork it

data/factory_girl-seeds.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |gem|
   gem.email         = ["technoforest@gmail.com"]
   gem.description   = %q{Preseed reusable data for factory girl}
   gem.summary       = %q{Make your test suite run time upto 2x faster and even more!}
-  gem.homepage      = ""
+  gem.homepage      = "https://github.com/evrone/factory_girl-seeds"
 
   gem.files         = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

data/lib/factory_girl-seeds/version.rb

@@ -1,5 +1,5 @@
 module FactoryGirl
   module Seeds
-    VERSION = "1.0.0"
+    VERSION = "1.0.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: factory_girl-seeds
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-13 00:00:00.000000000 Z
+date: 2013-07-02 00:00:00.000000000 Z
 dependencies: []
 description: Preseed reusable data for factory girl
 email:
@@ -27,7 +27,8 @@ files:
 - lib/factory_girl-seeds.rb
 - lib/factory_girl-seeds/seeds.rb
 - lib/factory_girl-seeds/version.rb
-homepage: ''
+- seed.jpg
+homepage: https://github.com/evrone/factory_girl-seeds
 licenses: []
 post_install_message: 
 rdoc_options: []
@@ -47,9 +48,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Make your test suite run time upto 2x faster and even more!
 test_files: []
-has_rdoc: