will-couchrest 0.33 → 0.33.1

data/lib/couchrest.rb

@@ -28,7 +28,7 @@ require 'couchrest/monkeypatches'
 
 # = CouchDB, close to the metal
 module CouchRest
-  VERSION    = '0.33' unless self.const_defined?("VERSION")
+  VERSION    = '0.33.1' unless self.const_defined?("VERSION")
   
   autoload :Server,       'couchrest/core/server'
   autoload :Database,     'couchrest/core/database'

data/lib/couchrest/mixins/document_queries.rb

@@ -59,6 +59,28 @@ module CouchRest
           end
         end
         
+        # Load several documents from the database by ids
+        # No exceptions will be raised if the document isn't found
+        #
+        # ==== Returns
+        # [Objects]:: if the document was found
+        # documents that are not found are nil
+        # or
+        # Nil:: if there was an error
+        # 
+        # === Parameters
+        # ids<Array> of <String, Integer>:: Document IDs
+        # db<Database>:: optional option to pass a custom database to use
+        def bulk_get(ids, db = database)
+          begin
+            rows = db.bulk_load(ids)['rows']
+            docs = rows.map{ |row| row['doc'] }
+          rescue
+            nil
+          else
+            docs.map{|doc| new(doc) if doc }
+          end
+        end
         # Load a document from the database by id
         # An exception will be raised if the document isn't found
         #

data/spec/couchrest/more/extended_doc_spec.rb

@@ -226,7 +226,36 @@ describe "ExtendedDocument" do
        lambda{foundart = Article.get!('matt aimonetti')}.should raise_error
     end
   end
-
+  
+  describe "bulk getting several models" do
+    before(:all) do
+      @art1 = Article.new(:title => 'All About Getting')
+      @art1.save
+      
+      @art2 = Article.new(:title => 'Even More About Getting')
+      @art2.save
+      
+      @art3 = Article.new(:title => 'Not Really About Getting')
+      @art3.save
+    end
+    
+    it "should load and instantiate all" do
+      foundarts = Article.bulk_get [@art1.id, @art2.id, @art3.id]
+      
+      foundarts[0].title.should == @art1.title
+      foundarts[1].title.should == @art2.title
+      foundarts[2].title.should == @art3.title
+    end
+    
+    it "should return nil if `get` is used and the document doesn't exist" do
+      foundarts = Article.bulk_get [@art1.id, "bad id", @art3.id]
+      
+      foundarts[0].title.should == @art1.title
+      foundarts[1].should be_nil
+      foundarts[2].title.should == @art3.title
+    end                     
+  end
+  
   describe "getting a model with a subobjects array" do
     before(:all) do
       course_doc = {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: will-couchrest
 version: !ruby/object:Gem::Version 
-  version: "0.33"
+  version: 0.33.1
 platform: ruby
 authors: 
 - J. Chris Anderson