dupe 0.4.5 → 0.4.6

data/README.rdoc

@@ -4,11 +4,10 @@ There are lots of great tools out there to ease the burden of prototyping Active
 
 But what about prototyping ActiveResource records? That's where Dupe steps in.  
 
-
 == Motivation 
 
-Dupe is ideally suited for cuking the client side of a service-oriented (ActiveResource) application.
-
+If you're going to create a service-oriented rails app with ActiveResource, why not cuke the front end first? 
+Let the behavior of the front-end drive the services you build on the backend. That's exactly what Dupe makes possible. 
 
 == Installation
 
@@ -18,7 +17,7 @@ If you want to install this for use in something other than a rails project, sim
 
 If you're going to use this in a rails project, add this to your cucumber.rb environment (config/environments/cucumber.rb)
   
-  config.gem 'dupe', :lib => 'dupe', :version => '>=0.4.0'
+  config.gem 'dupe'
   
 Then run this rake task to install the gem: 
 
@@ -124,17 +123,15 @@ Notice that by using the plural form of the model name, we ensure that we receiv
 
 ==Finding or Creating Resources
 
-You might have seen this one coming: 
+You might have seen this one coming. 
+
+Let's assume no genres currently exist. If we call the "find_or_create" method, it will create a new :genre.  
 
-  irb# Dupe.find :genre
-  Dupe::Database::TableDoesNotExistError: The table ':genre' does not exist.
-  	from /Library/Ruby/Gems/1.8/gems/dupe-0.4.0/lib/dupe/database.rb:30:in `select'
-  	from /Library/Ruby/Gems/1.8/gems/dupe-0.4.0/lib/dupe/dupe.rb:295:in `find'
-  	from (irb):40
-  	
   irb# Dupe.find_or_create :genre
     ==> <#Duped::Genre id=1>
 
+If we call it again, it will find the :genre we already created:
+
   irb# Dupe.find_or_create :genre
     ==> <#Duped::Genre id=1>
     
@@ -263,7 +260,7 @@ Now, let's create a book:
 
 === Uniquify attributes
 
-If you'd just like to make sure that some attributes get a unique value (probably), then you can use the uniquify
+If you'd just like to make sure that some attributes get a unique value, then you can use the uniquify
 method:
 
   irb# Dupe.define :book do |attrs|
@@ -280,6 +277,29 @@ any records it creates:
     ==> <#Duped::Book author="book 2 author" title="Rooby" genre="book 2 genre" id=2>
 
 
+=== Sequences
+
+The "uniquify" method is great if don't care too much about the format of the values it creates. But what if you'd like to ensure 
+that the value of an attribute conforms to a specific format? 
+
+  irb# Dupe.sequence :email do |n|
+   --#   "email-#{n}@somewhere.com"
+   --# end
+  
+  irb# Dupe.define :user do |user|
+   --#   user.uniquify :name 
+   --#   user.email do 
+   --#     Dupe.next :email
+   --#   end
+   --# end
+  
+  irb# Dupe.create :user
+    ==> <#Duped::User name="user 1 name" id=1 email="email-1@somewhere.com">
+  
+  irb# Dupe.create :user
+    ==> <#Duped::User name="user 2 name" id=2 email="email-2@somewhere.com">
+
+
 === Callbacks
 
 Suppose we'd like to make sure that our books get a unique label. We can accomplish that with an after_create callback:
@@ -302,6 +322,9 @@ Suppose we'd like to make sure that our books get a unique label. We can accompl
     ==> <#Duped::Book author=nil label="rooby-on-rails--1" title="Rooby on Rails" publish_date=nil id=1 isbn=842518>
 
 
+
+
+
 = ActiveResource
 
 So how does Dupe actually help us to spec/test ActiveResource-based applications? It uses a simple, yet sophisticated "intercept-mocking" technique, whereby failed network requests sent by ActiveResource fallback to the "Duped" network. Consider the following:

data/lib/dupe/dupe.rb

@@ -5,6 +5,7 @@ class Dupe
   class << self
     
     attr_reader :models #:nodoc:
+    attr_reader :sequences #:nodoc:
     attr_reader :database #:nodoc:
     
     # set this to "true" if you Dupe to spit out mocked requests
@@ -385,6 +386,15 @@ class Dupe
         results
       end
     end
+
+    def sequence(name, &block)
+      sequences[name.to_sym] = Sequence.new 1, block
+    end
+
+    def next(name)
+      raise ArgumentError, "Unknown sequence \":#{name}\"" unless sequences.has_key?(name)
+      sequences[name].next
+    end
         
     def models #:nodoc:
       @models ||= {}
@@ -397,14 +407,23 @@ class Dupe
     def database #:nodoc:
       @database ||= Dupe::Database.new
     end
+
+    def sequences #:nodoc:
+      @sequences ||= {}
+    end
     
-    # clears out all model definitions and database records / tables.
+    # clears out all model definitions, sequences, and database records / tables.
     def reset
       reset_models
       reset_database
       reset_network
+      reset_sequences
     end
     
+    def reset_sequences
+      @sequences = {}
+    end
+
     def reset_models
       @models = {}
     end

data/lib/dupe/sequence.rb

@@ -1,12 +1,20 @@
 class Sequence #:nodoc:
   attr_reader :current_value 
   
-  def initialize(starting_at=1)
+  def initialize(starting_at=1, sequencer=nil)
     @current_value = starting_at
+    if sequencer && sequencer.arity != 1
+      raise ArgumentError, "Your block must accept a single parameter"
+    end
+    @transformer = sequencer
   end
   
   def next
     @current_value += 1
-    @current_value - 1
+    if @transformer
+      @transformer.call(@current_value - 1)
+    else
+      @current_value - 1
+    end
   end
-end
+end

data/spec/lib_specs/dupe_spec.rb

@@ -5,14 +5,67 @@ describe Dupe do
     Dupe.reset
   end
   
+  describe "#sequences" do 
+    it "should be empty on initialization" do
+      Dupe.sequences.should == {}
+    end
+  end
+
+  describe "#sequence" do 
+    it "should require a sequence name and a block" do
+      proc {Dupe.sequence}.should raise_error(ArgumentError)
+      proc {Dupe.sequence :name}.should_not raise_error
+      proc {Dupe.sequence(:name) {}}.should raise_error(ArgumentError, "Your block must accept a single parameter")
+      proc {Dupe.sequence(:name) {|n| n}}.should_not raise_error
+    end
+
+    it "should store the sequence in a sequences hash" do
+      Dupe.sequences.should be_empty
+
+      Dupe.sequence :email do |n|
+        "email-#{n}@address.com"
+      end
+
+      Dupe.sequences.should_not be_empty
+      Dupe.sequences.keys.include?(:email).should == true
+      Dupe.sequences[:email].should be_kind_of(Sequence)
+    end
+  end
+
+  describe "#next" do 
+    it "should require a sequence name" do 
+      Dupe.sequence :email do |n|
+        "email-#{n}@address.com"
+      end
+
+      proc {Dupe.next}.should raise_error(ArgumentError)
+      proc {Dupe.next :title}.should raise_error(ArgumentError, 'Unknown sequence ":title"')
+      Dupe.next(:email).should == "email-1@address.com"
+      Dupe.next(:email).should == "email-2@address.com"
+    end
+  end
+  
   describe "reset" do
     it "should call reset_models, reset_database, and reset_network" do
       Dupe.should_receive(:reset_models).once
       Dupe.should_receive(:reset_database).once
       Dupe.should_receive(:reset_network).once
+      Dupe.should_receive(:reset_sequences).once
       Dupe.reset
     end
   end
+
+  describe "reset_sequences" do
+    it "should reset the sequences to an empty hash" do
+      Dupe.sequences.should == {}
+      Dupe.sequence :email do |n|
+        n
+      end
+      Dupe.sequences.should_not be_empty
+      Dupe.reset_sequences
+      Dupe.sequences.should == {}
+    end
+  end
   
   describe "reset_models" do
     it "should reset @models to an empty hash" do

data/spec/lib_specs/sequence_spec.rb

@@ -6,6 +6,14 @@ describe Sequence do
       Sequence.new.current_value.should == 1
       Sequence.new(500).current_value.should == 500
     end
+
+    it "should accept a block that takes a single parameter" do
+      proc {Sequence.new 1, proc {}}.should raise_error(ArgumentError, "Your block must accept a single parameter")
+      proc {Sequence.new 1, proc {|n| n}}.should_not raise_error
+      proc {Sequence.new 1, proc {|n,m| n}}.should raise_error(ArgumentError, "Your block must accept a single parameter")
+      s = Sequence.new 1, proc {|n| "email-#{n}@address.com"}
+      s.current_value.should == 1
+    end
   end
   
   describe "next" do
@@ -21,6 +29,11 @@ describe Sequence do
       s.current_value.should == 501
       s.next.should == 501
       s.current_value.should == 502
+
+      s = Sequence.new 1, proc {|n| "email-#{n}@address.com"}
+      s.next.should == "email-1@address.com"
+      s.next.should == "email-2@address.com"
+      s.current_value.should == 3
     end
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: dupe
 version: !ruby/object:Gem::Version 
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors: 
 - Matt Parker
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-25 00:00:00 -05:00
+date: 2010-01-31 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency