fabrication 0.3.1 → 0.4.0

data/README.markdown

@@ -56,6 +56,12 @@ So you already have a company fabricator, but you need one that specifically gen
 
 Setting the :from option will inherit the class and all the attributes from the named Fabricator. Even if you haven't defined a :company Fabricator yet, it will still work as long as it references an actual class name.
 
+You can also explicitly specify the class being fabricated with the :class_name parameter.
+
+    Fabricator(:llc, :class_name => :company) do
+      type "LLC"
+    end
+
 ### Fabricating ###
 
 Now that your Fabricators are defined, you can start generating some objects! To generate the LLC from the previous example, just do this:
@@ -70,6 +76,10 @@ If you need to do something more complex, you can also pass a block to Fabricate
       location!(:count => 2) { Faker::Address.city }
     end
 
+Sometimes you don't actually need to save an option when it is created but just build it. In that case, just call `Fabricate.build` and it will skip the saving step.
+
+    Fabricate.build(:company, :name => "Hashrocket")
+
 ### Contributing ###
 
 I (paulelliott) am actively maintaining this project. If you would like contribute, please fork the project, make your changes on a feature branch, and submit a pull request.
@@ -83,8 +93,6 @@ To run rake successfully:
 5. Run `rake` and the test suite should be all green!
 
 
-build without create...
-
 look into: Object.reflect_on_associations
 
 Fabricator(:atlanta_hub, :from => :hub) do

data/lib/fabrication.rb

@@ -17,7 +17,9 @@ module Fabrication
     def schematic(name, options, &block)
       raise DuplicateFabricatorError if fabricators.has_key?(name)
       parent = fabricators[options[:from]]
-      if parent
+      if options[:class_name]
+        class_name = options[:class_name]
+      elsif parent
         class_name = parent.class_name
       elsif options[:from]
         class_name = options[:from]
@@ -27,11 +29,11 @@ module Fabrication
       fabricators[name] = Fabricator.new(class_name, parent, &block)
     end
 
-    def generate(name, options, &block)
+    def generate(name, options, overrides, &block)
       find_definitions if @@fabricators.nil?
       raise UnknownFabricatorError unless Fabrication::Support.fabricatable?(name)
       schematic(name, {}) unless fabricators.has_key?(name)
-      fabricators[name].fabricate(options, &block)
+      fabricators[name].fabricate(options, overrides, &block)
     end
 
     def find_definitions
@@ -73,5 +75,13 @@ def Fabricator(name, options={}, &block)
 end
 
 def Fabricate(name, options={}, &block)
-  Fabrication.generate(name, options, &block)
+  Fabrication.generate(name, {:save => true}, options, &block)
+end
+
+class Fabricate
+
+  def self.build(name, options={}, &block)
+    Fabrication.generate(name, {:save => false}, options, &block)
+  end
+
 end

data/lib/fabrication/fabricator.rb

@@ -17,8 +17,8 @@ class Fabrication::Fabricator
     end.new(klass, schematic)
   end
 
-  def fabricate(options={}, &block)
-    generator.generate(options, &block)
+  def fabricate(options={}, overrides={}, &block)
+    generator.generate(options, overrides, &block)
   end
 
   private

data/lib/fabrication/generator/active_record.rb

@@ -41,8 +41,8 @@ class Fabrication::Generator::ActiveRecord < Fabrication::Generator::Base
 
   protected
 
-  def after_generation
-    instance.save
+  def after_generation(options)
+    instance.save if options[:save]
   end
 
 end

data/lib/fabrication/generator/base.rb

@@ -6,10 +6,10 @@ class Fabrication::Generator::Base
     self.after_create_block = block if block_given?
   end
 
-  def generate(options={}, &block)
+  def generate(options={:save => true}, overrides={}, &block)
     self.instance = klass.new
-    process_attributes(options, &block)
-    after_generation
+    process_attributes(overrides, &block)
+    after_generation(options)
     after_create_block.call(instance) if after_create_block
     instance
   end
@@ -25,7 +25,7 @@ class Fabrication::Generator::Base
 
   protected
 
-  def after_generation; end
+  def after_generation(options); end
 
   private
 

data/lib/fabrication/generator/mongoid.rb

@@ -1,7 +1,7 @@
 class Fabrication::Generator::Mongoid < Fabrication::Generator::Base
 
-  def after_generation
-    instance.save
+  def after_generation(options)
+    instance.save if options[:save]
   end
 
   def self.supports?(klass)

data/lib/fabrication/version.rb

@@ -1,3 +1,3 @@
 module Fabrication
-  VERSION = '0.3.1'
+  VERSION = '0.4.0'
 end

data/spec/fabrication_spec.rb

@@ -112,6 +112,22 @@ describe Fabrication do
 
   end
 
+  context 'with a specified class name' do
+
+    let(:someone) { Fabricate(:someone) }
+
+    before do
+      Fabricator(:someone, :class_name => :person) do
+        first_name "Paul"
+      end
+    end
+
+    it 'generates the person as someone' do
+      someone.first_name.should == "Paul"
+    end
+
+  end
+
   context 'with an active record object' do
 
     before(:all) do

data/spec/generator/active_record_spec.rb

@@ -20,7 +20,7 @@ describe Fabrication::Generator::ActiveRecord do
   context 'active record object' do
 
     let(:company) do
-      generator.generate({})
+      generator.generate
     end
 
     before(:all) do
@@ -68,4 +68,18 @@ describe Fabrication::Generator::ActiveRecord do
 
   end
 
+  context 'with the build option' do
+
+    let(:company) { Fabricate.build(:company, :name => "Epitaph") }
+
+    it 'creates the record' do
+      company.name.should == 'Epitaph'
+    end
+
+    it 'does not save it to the database' do
+      Company.count.should == 0
+    end
+
+  end
+
 end

data/spec/generator/base_spec.rb

@@ -14,7 +14,7 @@ describe Fabrication::Generator::Base do
   let(:generator) { Fabrication::Generator::Base.new(Person, schematic) }
 
   let(:person) do
-    generator.generate({:first_name => 'Body'})
+    generator.generate({:save => true}, {:first_name => 'Body'})
   end
 
   it 'passes the object to blocks' do

data/spec/generator/mongoid_spec.rb

@@ -18,14 +18,14 @@ describe Fabrication::Generator::Mongoid do
 
   context 'mongoid object' do
 
-    before { generator.generate(:name => 'Something') }
+    before { generator.generate({:save => true}, :name => 'Something') }
 
     it 'passes the object to blocks' do
-      generator.generate({}).handle.should == "name"
+      generator.generate.handle.should == "name"
     end
 
     it 'passes the object and count to blocks' do
-      generator.generate({}).books.map(&:title).should == ["Name 1","Name 2","Name 3"]
+      generator.generate.books.map(&:title).should == ["Name 1","Name 2","Name 3"]
     end
 
     it 'persists the author upon creation' do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: fabrication
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 15
   prerelease: false
   segments: 
   - 0
-  - 3
-  - 1
-  version: 0.3.1
+  - 4
+  - 0
+  version: 0.4.0
 platform: ruby
 authors: 
 - Paul Elliott
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-23 00:00:00 -04:00
+date: 2010-07-27 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency