fabrication 0.4.0 → 0.5.0

data/README.markdown

@@ -80,6 +80,29 @@ Sometimes you don't actually need to save an option when it is created but just
 
     Fabricate.build(:company, :name => "Hashrocket")
 
+### Sequences ###
+
+Sometimes you need a sequence of numbers while you're generating data. Fabrication provides you with an easy and flexible means for keeping track of sequences.
+
+This will create a sequence named ":number" that will start at 0. Every time you call it, it will increment by one.
+
+    Fabricate.sequence(:number)
+
+If you need to override the starting number, you can do it with a second parameter. It will always return the seed number on the first call and it will be ignored with subsequent calls.
+
+    Fabricate.sequence(:number, 99)
+
+If you are generating something like an email address, you can pass it a block and the block response will be returned.
+
+    Fabricate.sequence(:name) { |i| "Name #{i}" }
+
+And in a semi-real use case, it would look something like this:
+
+    Fabricate(:person) do
+      ssn { Fabricate.sequence :ssn, 111111111 }
+      email { Fabricate.sequence :email { |i| "user#{i}@example.com" } }
+    end
+
 ### 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.
@@ -104,3 +127,5 @@ Fabricator(:atlanta_hub, :from => :hub) do
   end
 end
 
+
+build option cascades down to associations

data/lib/fabrication.rb

@@ -36,6 +36,14 @@ module Fabrication
       fabricators[name].fabricate(options, overrides, &block)
     end
 
+    def sequence(name, start=0)
+      idx = sequences[name] ||= start
+
+      (block_given? ? yield(idx) : idx).tap do
+        sequences[name] += 1
+      end
+    end
+
     def find_definitions
       fabricator_file_paths = [
         File.join('test', 'fabricators'),
@@ -56,12 +64,17 @@ module Fabrication
 
     def clear_definitions
       fabricators.clear
+      sequences.clear
     end
 
     def fabricators
       @@fabricators ||= {}
     end
 
+    def sequences
+      @@sequences ||= {}
+    end
+
     private
 
     @@fabricators = nil
@@ -84,4 +97,8 @@ class Fabricate
     Fabrication.generate(name, {:save => false}, options, &block)
   end
 
+  def self.sequence(name, start=0, &block)
+    Fabrication.sequence(name, start, &block)
+  end
+
 end

data/lib/fabrication/version.rb

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

data/spec/sequence_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+describe "Fabricate.sequence" do
+
+  context 'with only a name' do
+
+    it 'starts with 0' do
+      Fabricate.sequence(:incr).should == 0
+    end
+
+    it 'increments by one with each call' do
+      Fabricate.sequence(:incr).should == 1
+      Fabricate.sequence(:incr).should == 2
+      Fabricate.sequence(:incr).should == 3
+      Fabricate.sequence(:incr).should == 4
+    end
+
+    it 'increments counters separately' do
+      Fabricate.sequence(:number).should == 0
+      Fabricate.sequence(:number).should == 1
+      Fabricate.sequence(:number).should == 2
+      Fabricate.sequence(:number).should == 3
+    end
+
+  end
+
+  context 'with a name and starting number' do
+
+    it 'starts with the number provided' do
+      Fabricate.sequence(:incr, 69).should == 69
+    end
+
+    it 'increments by one with each call' do
+      Fabricate.sequence(:incr).should == 70
+      Fabricate.sequence(:incr, 69).should == 71
+      Fabricate.sequence(:incr).should == 72
+      Fabricate.sequence(:incr).should == 73
+    end
+
+  end
+
+  context 'with a block' do
+
+    it 'yields the number to the block and returns the value' do
+      Fabricate.sequence(:email) do |i|
+        "user#{i}@example.com"
+      end.should == "user0@example.com"
+    end
+
+    it 'increments by one with each call' do
+      Fabricate.sequence(:email) do |i|
+        "user#{i}@example.com"
+      end.should == "user1@example.com"
+
+      Fabricate.sequence(:email) do |i|
+        "user#{i}@example.com"
+      end.should == "user2@example.com"
+    end
+
+  end
+
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: fabrication
 version: !ruby/object:Gem::Version 
-  hash: 15
+  hash: 11
   prerelease: false
   segments: 
   - 0
-  - 4
+  - 5
   - 0
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors: 
 - Paul Elliott
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-27 00:00:00 -04:00
+date: 2010-07-29 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -139,6 +139,7 @@ files:
 - spec/generator/base_spec.rb
 - spec/generator/mongoid_spec.rb
 - spec/schematic_spec.rb
+- spec/sequence_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb
 - spec/support/active_record.rb