factory_girl_extensions 2.0.0 → 2.1.0

data/README.markdown

@@ -17,7 +17,7 @@ As of version 2.0, factory_girl_extensions now targets the new FactoryGirl 2.0 A
 ## Usage
 
 ```ruby
-require 'factory_girl_extensions'
+require 'factory_girl_extensions' # This includes custom methods in every Class.  See below to customize this.
 
 FactoryGirl.define do
   factory :user do
@@ -76,6 +76,27 @@ User.generate(:admin, :with_profile, :name => 'Custom name')
 # User.build and User.attributes also support these custom prefix/suffixes.
 ```
 
+### Extend custom classes with FactoryGirlExtensions
+
+When you `require "factory_girl_extensions"`, we include custom methods (build/generate/etc) into 
+every class by calling:
+
+```ruby
+require "factory_girl_extensions/core"
+
+Class.send :include, FactoryGirlExtensions
+```
+
+If you don't want all of your classes to be polluted with these methods (for example, you only want 
+to extend your ActiveRecord::Base classes with these methods), you can simply:
+
+```ruby
+# don't require factory_girl_extensions!  require factory_girl_extensions/core instead.
+require "factory_girl_extensions/core"
+
+ActiveRecord::Base.send :extend, FactoryGirlExtensions
+```
+
 ## Why User.gen instead of FactoryGirl(:user)?
 
 Personally, I really dislike the `FactoryGirl(:user)` syntax.  When you have a lot of 

data/lib/factory_girl_extensions.rb

@@ -1,3 +1,3 @@
 require "factory_girl_extensions/core"
 
-Object.send :extend, FactoryGirl::Syntax::ObjectMethods
+Class.send :include, FactoryGirlExtensions

data/lib/factory_girl_extensions/core.rb

@@ -1,5 +1,3 @@
-require "factory_girl_extensions/version"
-
 module FactoryGirl
   module Syntax
 
@@ -149,3 +147,10 @@ module FactoryGirl
     end
   end
 end
+
+# Alias FactoryGirl::Syntax::ObjectMethods (which is named to be conventional with the official FactoryGirl syntaxes) 
+# to FactoryGirlExtensions so it's easy for users to manually extend custom classes without having to remember the 
+# unintuitive name of the real module.  We'll deprecate FactoryGirlExtensions if we get this merged into FactoryGirl.
+FactoryGirlExtensions = FactoryGirl::Syntax::ObjectMethods
+
+require "factory_girl_extensions/version"

data/lib/factory_girl_extensions/version.rb

@@ -1,7 +1,7 @@
 module FactoryGirlExtensions
   begin
     old, $VERBOSE = $VERBOSE, nil
-    VERSION = "2.0.0"
+    VERSION = "2.1.0"
   ensure
     $VERBOSE = old
   end

data/samples/dog_sample.rb

@@ -0,0 +1,37 @@
+require "factory_girl"
+require "factory_girl_extensions"
+
+class Dog
+  attr_accessor :name, :breed, :is_saved
+
+  def save
+    self.is_saved = "Saved via #save"
+  end
+
+  def save!
+    self.is_saved = "Saved via #save!"
+  end
+end
+
+FactoryGirl.define do
+  factory :dog do
+    name  "Rover"
+    breed "Golden Retriever"
+  end
+end
+
+def print_and_eval_code(code)
+  puts ">> #{code}"
+  puts "=> #{eval(code).inspect}"
+rescue Exception => ex
+  puts "Exception raised: #{ex.inspect}"
+end
+
+print_and_eval_code "Dog.build"
+print_and_eval_code "Dog.build(:name => 'Spot')"
+print_and_eval_code "Dog.gen"
+print_and_eval_code "Dog.gen(:name => 'Spot')"
+print_and_eval_code "Dog.gen!"
+print_and_eval_code "Dog.gen!(:name => 'Spot')"
+print_and_eval_code "Dog.attrs"
+print_and_eval_code "'a string'.gen"

data/spec/factory_girl_extensions_spec.rb

@@ -12,7 +12,7 @@ require "rspec"
 
 # Example class
 class Dog
-  extend FactoryGirl::Syntax::ObjectMethods
+  extend FactoryGirlExtensions
 
   attr_accessor :name, :saved
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: factory_girl_extensions
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-24 00:00:00.000000000 Z
+date: 2012-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: factory_girl
-  requirement: &19502360 !ruby/object:Gem::Requirement
+  requirement: &8440440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '2.0'
   type: :runtime
   prerelease: false
-  version_requirements: *19502360
+  version_requirements: *8440440
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &19501200 !ruby/object:Gem::Requirement
+  requirement: &8439800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *19501200
+  version_requirements: *8439800
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &19499300 !ruby/object:Gem::Requirement
+  requirement: &8439160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +43,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *19499300
+  version_requirements: *8439160
 description: ! "Alternative FactoryGirl API allowing you to build/generate factories
   \nusing your class constants, eg. User.gen instead of Factory(:user).\n"
 email: remi@remitaylor.com
@@ -60,6 +60,7 @@ files:
 - lib/factory_girl_extensions.rb
 - lib/factory_girl_extensions/core.rb
 - lib/factory_girl_extensions/version.rb
+- samples/dog_sample.rb
 - spec/factory_girl_extensions_spec.rb
 homepage: http://github.com/remi/factory_girl_extensions
 licenses: []