Modified relations/targets/eumerable and relations/referenced/many ea…

…ch methods to return an Enumerator when no block is given

lib/mongoid/relations/referenced/many.rb

@@ -165,7 +165,11 @@ def destroy_all(conditions = nil)
         #
         # @since 2.1.0
         def each
-          target.each { |doc| yield(doc) if block_given? }
+          if block_given?
+            target.each { |doc| yield(doc) }
+          else
+            to_enum
+          end
         end
 
         # Determine if any documents in this relation exist in the database.

lib/mongoid/relations/targets/enumerable.rb

@@ -139,15 +139,25 @@ def delete_if(&block)
         # the cursor while loading the documents and then iterates over the
         # _added docs.
         #
+        # If no block is passed then it returns an enumerator containing all
+        # docs.
+        #
         # @example Iterate over the enumerable.
         #   enumerable.each do |doc|
         #     puts doc
         #   end
         #
+        # @example return an enumerator containing all the docs 
+        #
+        #   a = enumerable.each
+        #  
         # @return [ true ] That the enumerable is now _loaded.
         #
         # @since 2.1.0
         def each
+          unless block_given?
+            return to_enum
+          end
           if _loaded?
             _loaded.each_pair do |id, doc|
               yield(doc)

spec/mongoid/relations/targets/enumerable_spec.rb

@@ -622,6 +622,22 @@
         end
       end
     end
+
+    context "when no block is passed" do
+
+      let(:criteria) do
+        Post.where(person_id: person.id)
+      end
+
+      let!(:enumerable) do
+        described_class.new(criteria)
+      end
+
+      it "returns an enumerator" do
+        enumerable.each.class.include?(Enumerable).should be_true
+      end
+
+    end
   end
 
   describe "#entries" do