dupe 0.4.4 → 0.4.5

data/README.rdoc

@@ -192,7 +192,7 @@ Now, every time we create a book, it will get assigned a random ISBN number:
   irb# b = Dupe.create :book
     ==> <#Duped::Book author=nil title="Untitled" id=2 isbn=606472>
 
-Another common use of this feature is for associations. Lets suppose we'd like to make sure that a book always has a genre, but a genre should be it's own resource. We can accomplish that by taking advantage of Dupe's "find_or_create" method:
+Another common use of this feature is for associations. Lets suppose we'd like to make sure that a book always has a genre, but a genre should be its own resource. We can accomplish that by taking advantage of Dupe's "find_or_create" method:
 
   irb# Dupe.define :book do |attrs|
    --#   attrs.title 'Untitled'
@@ -260,6 +260,26 @@ Now, let's create a book:
   irb# b.publish_date.class
     ==> Date
 
+
+=== Uniquify attributes
+
+If you'd just like to make sure that some attributes get a unique value (probably), then you can use the uniquify
+method:
+
+  irb# Dupe.define :book do |attrs|
+   --#   attrs.uniquify :title, :genre, :author
+   --# end
+
+Now, Dupe will do its best to assign unique values to the :title, :genre, and :author attributes on 
+any records it creates:
+
+  irb# b = Dupe.create :book
+    ==> <#Duped::Book author="book 1 author" title="book 1 title" genre="book 1 genre" id=1>
+
+  irb# b2 = Dupe.create :book, :title => 'Rooby'
+    ==> <#Duped::Book author="book 2 author" title="Rooby" genre="book 2 genre" id=2>
+
+
 === Callbacks
 
 Suppose we'd like to make sure that our books get a unique label. We can accomplish that with an after_create callback:

data/lib/dupe/dupe.rb

@@ -51,7 +51,7 @@ class Dupe
     #   irb# b = Dupe.create :book
     #     ==> <#Duped::Book author=nil title="Untitled" id=2 isbn=606472>
     # 
-    # Another common use of this feature is for associations. Lets suppose we'd like to make sure that a book always has a genre, but a genre should be it's own resource. We can accomplish that by taking advantage of Dupe's "find_or_create" method:
+    # Another common use of this feature is for associations. Lets suppose we'd like to make sure that a book always has a genre, but a genre should be its own resource. We can accomplish that by taking advantage of Dupe's "find_or_create" method:
     # 
     #   irb# Dupe.define :book do |attrs|
     #    --#   attrs.title 'Untitled'
@@ -118,7 +118,29 @@ class Dupe
     # 
     #   irb# b.publish_date.class
     #     ==> Date
+    #
+    #
+    #
+    # === Uniquify attributes
+    #
+    # 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|
+    #    --#   attrs.uniquify :title, :genre, :author
+    #    --# end
     # 
+    # Now, Dupe will do its best to assign unique values to the :title, :genre, and :author attributes on 
+    # any records it creates:
+    # 
+    #   irb# b = Dupe.create :book
+    #     ==> <#Duped::Book author="book 1 author" title="book 1 title" genre="book 1 genre" id=1>
+    # 
+    #   irb# b2 = Dupe.create :book, :title => 'Rooby'
+    #     ==> <#Duped::Book author="book 2 author" title="Rooby" genre="book 2 genre" id=2>
+    # 
+    #
+    #
     # === Callbacks
     # 
     # Suppose we'd like to make sure that our books get a unique label. We can accomplish that with an after_create callback:

data/lib/dupe/schema.rb

@@ -31,6 +31,22 @@ class Dupe
         
         @after_create_callbacks << block
       end
+
+      def uniquify(*args)
+        raise ArgumentError, "You must pass at least one attribute to uniquify." if args.empty?
+        raise ArgumentError, "You may only pass symbols to uniquify." unless all_members_of_class(args, Symbol)
+
+        args.each do |attribute|
+          after_create do |record|
+            record[attribute] = "#{record.__model__.name} #{record.id} #{attribute}" unless record[attribute]
+          end
+        end
+      end
+
+      private
+      def all_members_of_class(ary, klass)
+        ary.inject(true) {|bool, v| bool && v.kind_of?(klass)}
+      end
     end
   end
-end
+end

data/spec/lib_specs/dupe_spec.rb

@@ -213,6 +213,27 @@ describe Dupe do
       bs.last['test'].should == nil
     end
   end
+
+  describe "create resources with unique attributes" do
+    before do
+      Dupe.define :book do |book|
+        book.uniquify :title, :author, :genre
+      end
+    end
+
+    it "should uniquify the appropriate columns if they don't already have values" do
+      b = Dupe.create :book
+      b.title.should == "book 1 title"
+      b.author.should == "book 1 author"
+      b.genre.should == "book 1 genre"
+
+      b = Dupe.create :book, :title => 'Rooby Rocks', :isbn => 1
+      b.title.should == 'Rooby Rocks'
+      b.author.should == "book 2 author"
+      b.genre.should == "book 2 genre"
+      b.isbn.should == 1
+    end
+  end
   
   describe "find" do
     before do
@@ -340,4 +361,4 @@ describe Dupe do
     end
     
   end
-end
+end

data/spec/lib_specs/schema_spec.rb

@@ -87,4 +87,23 @@ describe Dupe::Model::Schema do
     end
     
   end
-end
+
+  describe "#uniquify" do
+    before do
+      @schema = Dupe::Model::Schema.new
+    end
+
+    it "should only accept a list of symbols" do
+      proc { @schema.uniquify }.should raise_error(ArgumentError, "You must pass at least one attribute to uniquify.")
+      proc { @schema.uniquify :hash => 'value' }.should raise_error(ArgumentError, "You may only pass symbols to uniquify.")
+      proc { @schema.uniquify :one, :two}.should_not raise_error
+    end
+
+    it "should create after_create_callbacks for each symbol passed to it" do
+      @schema.after_create_callbacks.should be_empty
+      @schema.uniquify :title, :label
+      @schema.after_create_callbacks.length.should == 2
+      @schema.after_create_callbacks.first.should be_kind_of(Proc)
+    end
+  end
+end

metadata

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