factory_girl-cache 0.0.1

data/README.md

@@ -0,0 +1,102 @@
+FactoryGirl Cache
+=====
+
+Instead of:
+
+    FactoryGirl.create(:post)
+    FactoryGirl.create_list(:post, 2)
+    FactoryGirl.build(:post)
+    FactoryGirl.build_list(:post, 2)
+    FactoryGirl.build_stubbed(:post)
+
+You can use these to ensure that create, create_list, build, build_list, and build_stubbed return the same result instance(s) everytime after the first call (before the cache is cleared):
+
+    FactoryGirlCache.create(:post)
+    FactoryGirlCache.create_list(:post, 2)
+    FactoryGirlCache.build(:post)
+    FactoryGirlCache.build_list(:post, 2)
+    FactoryGirlCache.build_stubbed(:post)
+
+To clear the cache:
+
+    FactoryGirlCache.clear
+
+This may seem completely odd, e.g. creating something would imply really creating a new instance, as would building. And you'll get the same id back. Why would you want to do that?
+
+By caching factory-created/built/stubbed instances and lists, you may be able to at least temporarily avoid issues with circular references and reduce time spent on nested model creation avoiding the dreaded:
+
+    SystemStackError:
+      stack level too deep
+
+This gem should not affect FactoryGirl itself. It just provides an alternate way to use FactoryGirl that makes it behave a bit differently.
+
+Please understand what you are doing by using this. This is not just some way to make FactoryGirl faster.
+
+### Installation
+
+Add to gemfile:
+
+    gem 'factory_girl-cache'
+
+Then:
+
+    bundle install
+
+### Usage
+
+#### Be Sure to Clear Cache After Every Use
+
+In your tests, be sure that the cache is cleared after anything that uses it is done, otherwise it probably will eventually pollute other tests if you are not careful!
+
+With Rails tests:
+
+    def teardown
+      FactoryGirlCache.clear
+      # ...
+    end
+
+With RSpec:
+
+    after(:each) do
+      FactoryGirlCache.clear
+      # ...
+    end
+
+You can also clear cache during your tests, if it makes sense.
+
+#### Use That Cache
+
+If you have a post factory, then the first time you do:
+
+    FactoryGirlCache.create(:post)
+
+It will call:
+
+    FactoryGirl.create(:post)
+
+The second time you call it, it will just return the same instance it did before (not dup'd or anything and the id or primary key will be the same):
+
+    FactoryGirlCache.create(:post)
+
+If you use a different method, that has a different cache, so:
+
+    FactoryGirlCache.create_list(:post, 2)
+
+Will create two more posts. But if you call it again that will return those same two posts:
+
+    FactoryGirlCache.create_list(:post, 2)
+
+More examples:
+
+    FactoryGirlCache.create(:post)
+    FactoryGirlCache.create_list(:post, 2)
+    FactoryGirlCache.build(:post)
+    FactoryGirlCache.build_list(:post, 2)
+    FactoryGirlCache.build_stubbed(:post)
+
+### License
+
+Copyright (c) 2012 Gary S. Weaver, released under the [MIT license][lic].
+
+[factory_girl]: https://github.com/thoughtbot/factory_girl
+[lic]: http://github.com/garysweaver/factory_girl-cache/blob/master/LICENSE

data/Rakefile

@@ -0,0 +1,3 @@
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new('spec')
+task :default => :spec

data/lib/factory_girl-cache/cache.rb

@@ -0,0 +1,48 @@
+require 'factory_girl'
+
+class FactoryGirlCache
+
+  @@create_cache = {}
+  @@create_list_cache = {}
+  @@build_cache = {}
+  @@build_list_cache = {}
+  @@build_stubbed_cache = {}
+
+  def self.build(class_sym, assc_sym = nil)
+    assc_sym ||= class_sym
+    @@build_cache[[class_sym, assc_sym]] ||= FactoryGirl.build(class_sym)
+  end
+
+  def self.build_list(class_sym, assc_sym = nil, number = nil)
+    number ||= assc_sym
+    assc_sym ||= class_sym
+    number = 0 unless number.is_a? Integer
+    @@build_list_cache[[class_sym, assc_sym, number]] ||= FactoryGirl.build_list(class_sym, number)
+  end
+
+  def self.build_stubbed(class_sym, assc_sym = nil)
+    assc_sym ||= class_sym
+    @@build_stubbed_cache[[class_sym, assc_sym]] ||= FactoryGirl.build_stubbed(class_sym)
+  end
+
+  def self.create(class_sym, assc_sym = nil)
+    assc_sym ||= class_sym
+    @@create_cache[[class_sym, assc_sym]] ||= FactoryGirl.create(class_sym)
+  end
+
+  def self.create_list(class_sym, assc_sym = nil, number = nil)
+    number ||= assc_sym
+    assc_sym ||= class_sym
+    number = 0 unless number.is_a? Integer
+    @@create_list_cache[[class_sym, assc_sym, number]] ||= FactoryGirl.create_list(class_sym, number)
+  end
+
+  def self.clear()
+    @@create_cache = {}
+    @@create_list_cache = {}
+    @@build_cache = {}
+    @@build_list_cache = {}
+    @@build_stubbed_cache = {}
+  end
+  
+end

data/lib/factory_girl-cache/version.rb

@@ -0,0 +1,3 @@
+module RestfulJson
+  VERSION = '0.0.1'
+end

data/lib/factory_girl-cache.rb

@@ -0,0 +1,2 @@
+require 'factory_girl-cache/version'
+require 'factory_girl-cache/cache'

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: factory_girl-cache
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Gary S. Weaver
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+description: Use FactoryGirlCache to call or retrieve cached results from FactoryGirl
+  factories.
+email:
+- garysweaver@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/factory_girl-cache/cache.rb
+- lib/factory_girl-cache/version.rb
+- lib/factory_girl-cache.rb
+- Rakefile
+- README.md
+homepage: https://github.com/garysweaver/factory_girl-cache
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Caches FactoryGirl factory results.
+test_files: []