mongo_doc 0.4.0 → 0.4.1

data/README.textile

@@ -1,8 +1,8 @@
 h1. MongoDoc
 
-Version: Turbulence (0.4.0) 2010/03/12
+Version: Turbulence (0.4.1) 2010/03/17
 
-h2. What's New in Turbulence (0.4.0)
+h2. What's New in Turbulence (0.4.1)
 
 API changes (@key@ and @has_*@ still supported, will be deprectated soon)
 
@@ -14,6 +14,10 @@ API changes (@key@ and @has_*@ still supported, will be deprectated soon)
 ** @embed_many@ was @has_many@
 ** @embed_hash@ was @has_hash@
 
+Indexing suppport
+
+* @MongoDoc::Document.index@
+
 h2. Notes
 
 * 2010-03-12 Thanks to weather in ATL, cleaned up attr_accessor and switched to embed association macros

data/Rakefile

@@ -89,7 +89,7 @@ namespace :mongoid do
     src_dir = Pathname.new('../durran-mongoid/lib/mongoid')
     dest_dir = Pathname.new('lib/mongoid')
     dest_dir.mkpath
-    %w(criteria.rb contexts/paging.rb criterion extensions/symbol/inflections.rb extensions/hash/criteria_helpers.rb matchers).each do |f|
+    %w(criteria.rb contexts/paging.rb contexts/enumerable.rb criterion extensions/symbol/inflections.rb extensions/hash/criteria_helpers.rb matchers).each do |f|
       src = src_dir + f
       if src.directory?
         FileUtils.cp_r(src, dest_dir)

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.4.1

data/features/indexes.feature

@@ -0,0 +1,28 @@
+Feature: Indexes
+
+  Background:
+    Given an empty Contact document collection
+    And a Contact document named 'hashrocket' :
+      | Name       | Type    |
+      | Hashrocket | company |
+    And 'hashrocket' has interests, an array of:
+      | Interest      |
+      | ruby          |
+      | rails         |
+      | employment    |
+      | contract work |
+      | restaurants   |
+      | hotels        |
+      | flights       |
+      | car rentals   |
+    And 'hashrocket' has many addresses :
+      | Street                 | City               | State | Zip Code |
+      | 320 First Street North | Jacksonville Beach | FL    | 32250    |
+      | 1 Lake Michigan Street | Chicago            | IL    | 60611    |
+      | 1 Main Street          | Santiago           | Chile |          |
+    And I save the document 'hashrocket'
+
+  Scenario: Simple index
+    When I create an index named name on the Contact collection
+    Then there is an index on name on the Contact collection
+

data/features/step_definitions/index_steps.rb

@@ -0,0 +1,10 @@
+When /^I create an index named (.*) on the (.*) collection$/ do |index_name, doc|
+  klass = doc.constantize
+  klass.index(index_name)
+end
+
+Then /^there is an index on (.*) on the (.*) collection$/ do |index_name, doc|
+  klass = doc.constantize
+  klass.collection.index_information.should include("#{index_name}_1")
+end
+

data/lib/mongo_doc/contexts/ids.rb

@@ -1,4 +1,4 @@
-module MongoDoc
+module Mongoid
   module Contexts
     module Ids
       # Return documents based on an id search. Will handle if a single id has

data/lib/mongo_doc/contexts/mongo.rb

@@ -2,7 +2,7 @@ module MongoDoc
   module Contexts
     class Mongo
       include Mongoid::Contexts::Paging
-      include MongoDoc::Contexts::Ids
+      include Mongoid::Contexts::Ids
 
       attr_reader :criteria, :cache
 
@@ -26,6 +26,25 @@ module MongoDoc
         collection.group(options[:fields], selector, { :count => 0 }, AGGREGATE_REDUCE, true)
       end
 
+      # Get the average value for the supplied field.
+      #
+      # This will take the internally built selector and options
+      # and pass them on to the Ruby driver's +group()+ method on the collection. The
+      # collection itself will be retrieved from the class provided, and once the
+      # query has returned it will provided a grouping of keys with averages.
+      #
+      # Example:
+      #
+      # <tt>context.avg(:age)</tt>
+      #
+      # Returns:
+      #
+      # A numeric value that is the average.
+      def avg(field)
+        total = sum(field)
+        total ? (total / count) : nil
+      end
+
       # Get the count of matching documents in the database for the context.
       #
       # Example:
@@ -39,6 +58,16 @@ module MongoDoc
         @count ||= collection.find(selector, options).count
       end
 
+      # Gets an array of distinct values for the supplied field across the
+      # entire collection or the susbset given the criteria.
+      #
+      # Example:
+      #
+      # <tt>context.distinct(:title)</tt>
+      def distinct(field)
+        collection.distinct(field, selector)
+      end
+
       # Determine if the context is empty or blank given the criteria. Will
       # perform a quick find_one asking only for the id.
       #

data/lib/mongo_doc/contexts.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 require "mongoid/contexts/paging"
 require "mongo_doc/contexts/ids"
-require "mongo_doc/contexts/enumerable"
+require "mongoid/contexts/enumerable"
 require "mongo_doc/contexts/mongo"
 
 module Mongoid
@@ -19,7 +19,7 @@ module Mongoid
     # <tt>Contexts.context_for(criteria)</tt>
     def self.context_for(criteria)
       if criteria.klass.respond_to?(:_append)
-        return MongoDoc::Contexts::Enumerable.new(criteria)
+        return Mongoid::Contexts::Enumerable.new(criteria)
       elsif criteria.klass.respond_to?(:collection)
         return MongoDoc::Contexts::Mongo.new(criteria)
       else

data/lib/mongo_doc/document.rb

@@ -4,6 +4,7 @@ require 'mongo_doc/attributes'
 require 'mongo_doc/associations'
 require 'mongo_doc/criteria'
 require 'mongo_doc/finders'
+require 'mongo_doc/index'
 require 'mongo_doc/scope'
 require 'mongo_doc/validations/macros'
 
@@ -21,6 +22,7 @@ module MongoDoc
         extend ClassMethods
         extend Criteria
         extend Finders
+        extend Index
         extend Scope
         include ::Validatable
         extend Validations::Macros

data/lib/mongo_doc/index.rb

@@ -0,0 +1,27 @@
+module MongoDoc
+  module Index
+
+    # Create an index on a collection. For a unique index, pass the unique
+    # option +:unique => true+. For compound indexes, pass pairs of fields and
+    # directions (+:asc+, +:desc+) as a hash.
+    #
+    # <tt>Person.index(:last_name)</tt>
+    # <tt>Person.index(:ssn, :unique => true)</tt>
+    # <tt>Person.index(:first_name => :asc, :last_name => :asc)</tt>
+    # <tt>Person.index(:first_name => :asc, :last_name => :asc, :unique => true)</tt>
+    def index(*args)
+      options_and_fields = args.extract_options!
+      unique = options_and_fields.delete(:unique) || false
+      if args.any?
+        collection.create_index(args.first, unique)
+      else
+        collection.create_index(to_mongo_direction(options_and_fields), unique)
+      end
+    end
+
+    protected
+    def to_mongo_direction(fields_hash)
+      fields_hash.to_a.map {|field| [field.first, field.last == :desc ? Mongo::DESCENDING : Mongo::ASCENDING]}
+    end
+  end
+end

data/lib/mongo_doc.rb

@@ -4,7 +4,7 @@ require 'validatable'
 require 'will_paginate/collection'
 
 module MongoDoc
-  VERSION = '0.4.0'
+  VERSION = '0.4.1'
 end
 
 require 'mongo_doc/connection'

data/lib/{mongo_doc → mongoid}/contexts/enumerable.rb

@@ -1,13 +1,11 @@
 # encoding: utf-8
-module MongoDoc #:nodoc:
+module Mongoid #:nodoc:
   module Contexts #:nodoc:
     class Enumerable
-      include Mongoid::Contexts::Paging
-      include MongoDoc::Contexts::Ids
-
+      include Ids, Paging
       attr_reader :criteria
 
-      delegate :first, :last, :to => :execute
+      delegate :blank?, :empty?, :first, :last, :to => :execute
       delegate :documents, :options, :selector, :to => :criteria
 
       # Return aggregation counts of the grouped documents. This will count by
@@ -22,19 +20,33 @@ module MongoDoc #:nodoc:
         counts
       end
 
+      # Get the average value for the supplied field.
+      #
+      # Example:
+      #
+      # <tt>context.avg(:age)</tt>
+      #
+      # Returns:
+      #
+      # A numeric value that is the average.
+      def avg(field)
+        total = sum(field)
+        total ? (total.to_f / count) : nil
+      end
+
       # Gets the number of documents in the array. Delegates to size.
       def count
         @count ||= documents.size
       end
 
-      # Groups the documents by the first field supplied in the field options.
+      # Gets an array of distinct values for the supplied field across the
+      # entire array or the susbset given the criteria.
       #
-      # Returns:
+      # Example:
       #
-      # A +Hash+ with field values as keys, arrays of documents as values.
-      def group
-        field = options[:fields].first
-        documents.group_by { |doc| doc.send(field) }
+      # <tt>context.distinct(:title)</tt>
+      def distinct(field)
+        execute.collect { |doc| doc.send(field) }.uniq
       end
 
       # Enumerable implementation of execute. Returns matching documents for
@@ -47,13 +59,23 @@ module MongoDoc #:nodoc:
         limit(documents.select { |document| document.matches?(selector) })
       end
 
+      # Groups the documents by the first field supplied in the field options.
+      #
+      # Returns:
+      #
+      # A +Hash+ with field values as keys, arrays of documents as values.
+      def group
+        field = options[:fields].first
+        documents.group_by { |doc| doc.send(field) }
+      end
+
       # Create the new enumerable context. This will need the selector and
       # options from a +Criteria+ and a documents array that is the underlying
       # array of embedded documents from a has many association.
       #
       # Example:
       #
-      # <tt>MongoDoc::Contexts::Enumerable.new(criteria)</tt>
+      # <tt>Mongoid::Contexts::Enumerable.new(criteria)</tt>
       def initialize(criteria)
         @criteria = criteria
       end
@@ -119,10 +141,11 @@ module MongoDoc #:nodoc:
         skip, limit = options[:skip], options[:limit]
         if skip && limit
           return documents.slice(skip, limit)
+        elsif limit
+          return documents.first(limit)
         end
         documents
       end
     end
   end
 end
-

data/lib/mongoid/criteria.rb

@@ -26,13 +26,14 @@ module Mongoid #:nodoc:
     include Enumerable
 
     attr_reader :collection, :ids, :klass, :options, :selector
-
     attr_accessor :documents
 
     delegate \
       :aggregate,
+      :avg,
       :blank?,
       :count,
+      :distinct,
       :empty?,
       :execute,
       :first,

data/mongo_doc.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{mongo_doc}
-  s.version = "0.4.0"
+  s.version = "0.4.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Les Hill"]
-  s.date = %q{2010-03-13}
+  s.date = %q{2010-03-17}
   s.description = %q{ODM for MongoDB}
   s.email = %q{leshill@gmail.com}
   s.extra_rdoc_files = [
@@ -30,6 +30,7 @@ Gem::Specification.new do |s|
      "examples/simple_object.rb",
      "features/collections.feature",
      "features/finders.feature",
+     "features/indexes.feature",
      "features/mongodb.yml",
      "features/mongodoc_base.feature",
      "features/new_record.feature",
@@ -41,6 +42,7 @@ Gem::Specification.new do |s|
      "features/step_definitions/document_steps.rb",
      "features/step_definitions/documents.rb",
      "features/step_definitions/finder_steps.rb",
+     "features/step_definitions/index_steps.rb",
      "features/step_definitions/json_steps.rb",
      "features/step_definitions/object_steps.rb",
      "features/step_definitions/objects.rb",
@@ -64,7 +66,6 @@ Gem::Specification.new do |s|
      "lib/mongo_doc/collection.rb",
      "lib/mongo_doc/connection.rb",
      "lib/mongo_doc/contexts.rb",
-     "lib/mongo_doc/contexts/enumerable.rb",
      "lib/mongo_doc/contexts/ids.rb",
      "lib/mongo_doc/contexts/mongo.rb",
      "lib/mongo_doc/criteria.rb",
@@ -87,11 +88,13 @@ Gem::Specification.new do |s|
      "lib/mongo_doc/ext/symbol.rb",
      "lib/mongo_doc/ext/time.rb",
      "lib/mongo_doc/finders.rb",
+     "lib/mongo_doc/index.rb",
      "lib/mongo_doc/matchers.rb",
      "lib/mongo_doc/query.rb",
      "lib/mongo_doc/scope.rb",
      "lib/mongo_doc/validations/macros.rb",
      "lib/mongo_doc/validations/validates_embedded.rb",
+     "lib/mongoid/contexts/enumerable.rb",
      "lib/mongoid/contexts/paging.rb",
      "lib/mongoid/criteria.rb",
      "lib/mongoid/criterion/complex.rb",
@@ -127,7 +130,6 @@ Gem::Specification.new do |s|
      "spec/bson_spec.rb",
      "spec/collection_spec.rb",
      "spec/connection_spec.rb",
-     "spec/contexts/enumerable_spec.rb",
      "spec/contexts/ids_spec.rb",
      "spec/contexts/mongo_spec.rb",
      "spec/contexts_spec.rb",
@@ -139,6 +141,7 @@ Gem::Specification.new do |s|
      "spec/ext_spec.rb",
      "spec/finders_spec.rb",
      "spec/hash_matchers.rb",
+     "spec/index_spec.rb",
      "spec/matchers_spec.rb",
      "spec/mongodb.yml",
      "spec/mongodb_pairs.yml",
@@ -164,7 +167,6 @@ Gem::Specification.new do |s|
      "spec/bson_spec.rb",
      "spec/collection_spec.rb",
      "spec/connection_spec.rb",
-     "spec/contexts/enumerable_spec.rb",
      "spec/contexts/ids_spec.rb",
      "spec/contexts/mongo_spec.rb",
      "spec/contexts_spec.rb",
@@ -176,6 +178,7 @@ Gem::Specification.new do |s|
      "spec/ext_spec.rb",
      "spec/finders_spec.rb",
      "spec/hash_matchers.rb",
+     "spec/index_spec.rb",
      "spec/matchers_spec.rb",
      "spec/new_record_spec.rb",
      "spec/query_spec.rb",

data/spec/contexts/mongo_spec.rb

@@ -39,6 +39,19 @@ describe "MongoDoc::Contexts::Mongo" do
       end
     end
 
+    context "#avg" do
+      it "is the sum/count" do
+        context.should_receive(:count).and_return(1)
+        context.should_receive(:sum).with(:field_name).and_return(1)
+        context.avg(:field_name)
+      end
+
+      it "returns nil if there is no sum" do
+        context.stub(:sum).and_return(nil)
+        context.avg(:field_name).should be_nil
+      end
+    end
+
     context "#count" do
       it "uses find and count" do
         result = stub('result')
@@ -48,6 +61,13 @@ describe "MongoDoc::Contexts::Mongo" do
       end
     end
 
+    context "#distinct" do
+      it "uses distinct" do
+        collection.should_receive(:distinct).with(:field_name, {})
+        context.distinct(:field_name)
+      end
+    end
+
     context "#execute" do
       it "uses find" do
         collection.should_receive(:find)

data/spec/contexts_spec.rb

@@ -24,7 +24,7 @@ describe MongoDoc::Contexts do
       let(:klass) { ContextTest.new.children }
 
       it "creates an Enumerable context" do
-        MongoDoc::Contexts::Enumerable.should_receive(:new).with(criteria)
+        Mongoid::Contexts::Enumerable.should_receive(:new).with(criteria)
         Mongoid::Contexts.context_for(criteria)
       end
     end

data/spec/index_spec.rb

@@ -0,0 +1,70 @@
+require "spec_helper.rb"
+
+describe MongoDoc::Index do
+  class Address
+    include MongoDoc::Document
+
+    attr_accessor :state
+  end
+
+  class IndexTest
+    include MongoDoc::Document
+
+    attr_accessor :ssn
+    attr_accessor :first_name
+    attr_accessor :last_name
+    attr_accessor :birthdate, :type => Date
+    attr_accessor :notes
+
+    embed :addresses
+
+    # This is the API we are testing, commented out to avoid firing before
+    # specs are run
+    #
+    # index :birthdate
+    # index :ssn, :unique => true
+    # index :first_name => :asc, :last_name => :asc
+    # index :last_name => :asc, :first_name => :asc, :unique => true
+    # index "addresses.state"
+  end
+
+  let(:collection) { stub('collection') }
+
+  before do
+    IndexTest.stub(:collection).and_return(collection)
+  end
+
+  context "Simple index" do
+
+    it "creates an index for the field" do
+      collection.should_receive(:create_index).with(:birthdate, false)
+      IndexTest.index(:birthdate)
+    end
+
+    it "creates a unique index for the field" do
+      collection.should_receive(:create_index).with(:birthdate, true)
+      IndexTest.index(:birthdate, :unique => true)
+    end
+
+  end
+
+  context "Compound index" do
+
+    it "creates a compound index" do
+      collection.should_receive(:create_index).with([[:first_name, Mongo::ASCENDING], [:last_name, Mongo::ASCENDING]], false)
+      IndexTest.index(:first_name => :asc, :last_name => :asc)
+    end
+
+    it "creates a unique compound index" do
+      collection.should_receive(:create_index).with([[:first_name, Mongo::ASCENDING], [:last_name, Mongo::ASCENDING]], true)
+      IndexTest.index(:first_name => :asc, :last_name => :asc, :unique => true)
+    end
+  end
+
+  context "Nested index" do
+    it "creates an index for the field" do
+      collection.should_receive(:create_index).with("addresses.state", false)
+      IndexTest.index("addresses.state")
+    end
+  end
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 4
-  - 0
-  version: 0.4.0
+  - 1
+  version: 0.4.1
 platform: ruby
 authors: 
 - Les Hill
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-13 00:00:00 -05:00
+date: 2010-03-17 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -136,6 +136,7 @@ files:
 - examples/simple_object.rb
 - features/collections.feature
 - features/finders.feature
+- features/indexes.feature
 - features/mongodb.yml
 - features/mongodoc_base.feature
 - features/new_record.feature
@@ -147,6 +148,7 @@ files:
 - features/step_definitions/document_steps.rb
 - features/step_definitions/documents.rb
 - features/step_definitions/finder_steps.rb
+- features/step_definitions/index_steps.rb
 - features/step_definitions/json_steps.rb
 - features/step_definitions/object_steps.rb
 - features/step_definitions/objects.rb
@@ -170,7 +172,6 @@ files:
 - lib/mongo_doc/collection.rb
 - lib/mongo_doc/connection.rb
 - lib/mongo_doc/contexts.rb
-- lib/mongo_doc/contexts/enumerable.rb
 - lib/mongo_doc/contexts/ids.rb
 - lib/mongo_doc/contexts/mongo.rb
 - lib/mongo_doc/criteria.rb
@@ -193,11 +194,13 @@ files:
 - lib/mongo_doc/ext/symbol.rb
 - lib/mongo_doc/ext/time.rb
 - lib/mongo_doc/finders.rb
+- lib/mongo_doc/index.rb
 - lib/mongo_doc/matchers.rb
 - lib/mongo_doc/query.rb
 - lib/mongo_doc/scope.rb
 - lib/mongo_doc/validations/macros.rb
 - lib/mongo_doc/validations/validates_embedded.rb
+- lib/mongoid/contexts/enumerable.rb
 - lib/mongoid/contexts/paging.rb
 - lib/mongoid/criteria.rb
 - lib/mongoid/criterion/complex.rb
@@ -233,7 +236,6 @@ files:
 - spec/bson_spec.rb
 - spec/collection_spec.rb
 - spec/connection_spec.rb
-- spec/contexts/enumerable_spec.rb
 - spec/contexts/ids_spec.rb
 - spec/contexts/mongo_spec.rb
 - spec/contexts_spec.rb
@@ -245,6 +247,7 @@ files:
 - spec/ext_spec.rb
 - spec/finders_spec.rb
 - spec/hash_matchers.rb
+- spec/index_spec.rb
 - spec/matchers_spec.rb
 - spec/mongodb.yml
 - spec/mongodb_pairs.yml
@@ -294,7 +297,6 @@ test_files:
 - spec/bson_spec.rb
 - spec/collection_spec.rb
 - spec/connection_spec.rb
-- spec/contexts/enumerable_spec.rb
 - spec/contexts/ids_spec.rb
 - spec/contexts/mongo_spec.rb
 - spec/contexts_spec.rb
@@ -306,6 +308,7 @@ test_files:
 - spec/ext_spec.rb
 - spec/finders_spec.rb
 - spec/hash_matchers.rb
+- spec/index_spec.rb
 - spec/matchers_spec.rb
 - spec/new_record_spec.rb
 - spec/query_spec.rb

data/spec/contexts/enumerable_spec.rb

@@ -1,274 +0,0 @@
-require "spec_helper"
-
-describe MongoDoc::Contexts::Enumerable do
-
-  class Address
-    include MongoDoc::Document
-    include MongoDoc::Matchers
-
-    attr_accessor :number
-    attr_accessor :street
-  end
-
-  before do
-    @london = Address.new(:number => 1, :street => "Bond Street")
-    @shanghai = Address.new(:number => 10, :street => "Nan Jing Dong Lu")
-    @melbourne = Address.new(:number => 20, :street => "Bourke Street")
-    @new_york = Address.new(:number => 20, :street => "Broadway")
-    @docs = [ @london, @shanghai, @melbourne, @new_york ]
-    @criteria = Mongoid::Criteria.new(Address)
-    @criteria.documents = @docs
-    @criteria.where(:street => "Bourke Street").only(:number)
-    @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-  end
-
-  describe "#aggregate" do
-
-    before do
-      @counts = @context.aggregate
-    end
-
-    it "groups by the fields provided in the options" do
-      @counts.size.should == 3
-    end
-
-    it "stores the counts in proper groups" do
-      @counts[1].should == 1
-      @counts[10].should == 1
-      @counts[20].should == 2
-    end
-  end
-
-  describe "#count" do
-
-    it "returns the size of the enumerable" do
-      @context.count.should == 4
-    end
-
-  end
-
-  describe "#execute" do
-
-    before do
-      @criteria = Mongoid::Criteria.new(Address)
-      @criteria.documents = @docs
-    end
-
-    it "returns the matching documents from the array" do
-      @context.execute.should == [ @melbourne ]
-    end
-
-    context "when selector is empty" do
-
-      before do
-        @criteria.only(:number)
-        @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-      end
-
-      it "returns all the documents" do
-        @context.execute.should == @docs
-      end
-    end
-
-    context "when skip and limit are in the options" do
-
-      before do
-        @criteria.skip(2).limit(2)
-        @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-      end
-
-      it "properly narrows down the matching results" do
-        @context.execute.should == [ @melbourne, @new_york ]
-      end
-    end
-
-  end
-
-  describe "#first" do
-
-    context "when a selector is present" do
-
-      it "returns the first that matches the selector" do
-        @context.first.should == @melbourne
-      end
-    end
-
-  end
-
-  describe "#group" do
-
-    before do
-      @group = @context.group
-    end
-
-    it "groups by the fields provided in the options" do
-      @group.size.should == 3
-    end
-
-    it "stores the documents in proper groups" do
-      @group[1].should == [ @london ]
-      @group[10].should == [ @shanghai ]
-      @group[20].should == [ @melbourne, @new_york ]
-    end
-
-  end
-
-  describe "#initialize" do
-
-    let(:selector) { { :field => "value"  } }
-    let(:options) { { :skip => 20 } }
-    let(:documents) { [stub] }
-
-    before do
-      @criteria = Mongoid::Criteria.new(Address)
-      @criteria.documents = documents
-      @criteria.where(selector).skip(20)
-      @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-    end
-
-    it "sets the selector" do
-      @context.selector.should == selector
-    end
-
-    it "sets the options" do
-      @context.options.should == options
-    end
-
-    it "sets the documents" do
-      @context.documents.should == documents
-    end
-
-  end
-
-  describe "#iterator" do
-
-    before do
-      @criteria.where(:street => "Bourke Street")
-      @criteria.documents = @docs
-      @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-    end
-
-    it "executes the criteria" do
-      acc = []
-      @context.iterate do |doc|
-        acc << doc
-      end
-      acc.should == [@melbourne]
-    end
-
-  end
-
-  describe "#last" do
-
-    it "returns the last matching in the enumerable" do
-      @context.last.should == @melbourne
-    end
-
-  end
-
-  describe "#max" do
-
-    it "returns the max value for the supplied field" do
-      @context.max(:number).should == 20
-    end
-
-  end
-
-  describe "#min" do
-
-    it "returns the min value for the supplied field" do
-      @context.min(:number).should == 1
-    end
-
-  end
-
-  describe "#one" do
-
-    it "returns the first matching in the enumerable" do
-      @context.one.should == @melbourne
-    end
-
-  end
-
-  describe "#page" do
-
-    context "when the page option exists" do
-
-      before do
-        @criteria = Mongoid::Criteria.new(Address).extras({ :page => 5 })
-        @criteria.documents = []
-        @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-      end
-
-      it "returns the page option" do
-        @context.page.should == 5
-      end
-
-    end
-
-    context "when the page option does not exist" do
-
-      before do
-        @criteria = Mongoid::Criteria.new(Address)
-        @criteria.documents = []
-        @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-      end
-
-      it "returns 1" do
-        @context.page.should == 1
-      end
-
-    end
-
-  end
-
-  describe "#paginate" do
-
-    before do
-      @criteria = Mongoid::Criteria.new(Address).skip(2).limit(2)
-      @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-      @results = @context.paginate
-    end
-
-    it "executes and paginates the results" do
-      @results.current_page.should == 2
-      @results.per_page.should == 2
-    end
-
-  end
-
-  describe "#per_page" do
-
-    context "when a limit option exists" do
-
-      it "returns 20" do
-        @context.per_page.should == 20
-      end
-
-    end
-
-    context "when a limit option does not exist" do
-
-      before do
-        @criteria = Mongoid::Criteria.new(Address).limit(50)
-        @criteria.documents = []
-        @context = MongoDoc::Contexts::Enumerable.new(@criteria)
-      end
-
-      it "returns the limit" do
-        @context.per_page.should == 50
-      end
-
-    end
-
-  end
-
-  describe "#sum" do
-
-    it "returns the sum of all the field values" do
-      @context.sum(:number).should == 51
-    end
-
-  end
-
-end