mongoid-pre 2.0.0.beta1 → 2.0.0.pre

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mongoid-pre
 version: !ruby/object:Gem::Version 
-  version: 2.0.0.beta1
+  version: 2.0.0.pre
 platform: ruby
 authors: 
 - Durran Jordan
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-27 00:00:00 +01:00
+date: 2010-02-13 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,7 +41,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.19.1
+        version: 0.18.2
     version: 
 - !ruby/object:Gem::Dependency 
   name: rspec
@@ -51,7 +51,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.3.0
+        version: 1.2.9
     version: 
 - !ruby/object:Gem::Dependency 
   name: mocha
@@ -74,6 +74,7 @@ extra_rdoc_files:
 files: 
 - .gitignore
 - .watchr
+- HISTORY
 - MIT_LICENSE
 - README.rdoc
 - Rakefile
@@ -81,13 +82,12 @@ files:
 - caliper.yml
 - lib/mongoid.rb
 - lib/mongoid/associations.rb
+- lib/mongoid/associations/belongs_to.rb
 - lib/mongoid/associations/belongs_to_related.rb
-- lib/mongoid/associations/embedded_in.rb
-- lib/mongoid/associations/embeds_many.rb
-- lib/mongoid/associations/embeds_one.rb
+- lib/mongoid/associations/has_many.rb
 - lib/mongoid/associations/has_many_related.rb
+- lib/mongoid/associations/has_one.rb
 - lib/mongoid/associations/has_one_related.rb
-- lib/mongoid/associations/meta_data.rb
 - lib/mongoid/associations/options.rb
 - lib/mongoid/associations/proxy.rb
 - lib/mongoid/attributes.rb
@@ -110,7 +110,6 @@ files:
 - lib/mongoid/config.rb
 - lib/mongoid/contexts.rb
 - lib/mongoid/contexts/enumerable.rb
-- lib/mongoid/contexts/ids.rb
 - lib/mongoid/contexts/mongo.rb
 - lib/mongoid/contexts/paging.rb
 - lib/mongoid/criteria.rb
@@ -119,8 +118,6 @@ files:
 - lib/mongoid/criterion/inclusion.rb
 - lib/mongoid/criterion/optional.rb
 - lib/mongoid/cursor.rb
-- lib/mongoid/deprecation.rb
-- lib/mongoid/dirty.rb
 - lib/mongoid/document.rb
 - lib/mongoid/errors.rb
 - lib/mongoid/extensions.rb
@@ -129,8 +126,6 @@ files:
 - lib/mongoid/extensions/array/assimilation.rb
 - lib/mongoid/extensions/array/conversions.rb
 - lib/mongoid/extensions/array/parentization.rb
-- lib/mongoid/extensions/big_decimal/conversions.rb
-- lib/mongoid/extensions/binary/conversions.rb
 - lib/mongoid/extensions/boolean/conversions.rb
 - lib/mongoid/extensions/date/conversions.rb
 - lib/mongoid/extensions/datetime/conversions.rb
@@ -143,21 +138,17 @@ files:
 - lib/mongoid/extensions/integer/conversions.rb
 - lib/mongoid/extensions/nil/assimilation.rb
 - lib/mongoid/extensions/object/conversions.rb
-- lib/mongoid/extensions/objectid/conversions.rb
 - lib/mongoid/extensions/proc/scoping.rb
 - lib/mongoid/extensions/string/conversions.rb
 - lib/mongoid/extensions/string/inflections.rb
 - lib/mongoid/extensions/symbol/inflections.rb
 - lib/mongoid/extensions/time/conversions.rb
-- lib/mongoid/extras.rb
 - lib/mongoid/factory.rb
 - lib/mongoid/field.rb
 - lib/mongoid/fields.rb
 - lib/mongoid/finders.rb
 - lib/mongoid/identity.rb
 - lib/mongoid/indexes.rb
-- lib/mongoid/javascript.rb
-- lib/mongoid/javascript/functions.yml
 - lib/mongoid/matchers.rb
 - lib/mongoid/matchers/all.rb
 - lib/mongoid/matchers/default.rb
@@ -172,14 +163,7 @@ files:
 - lib/mongoid/matchers/size.rb
 - lib/mongoid/memoization.rb
 - lib/mongoid/named_scope.rb
-- lib/mongoid/observable.rb
-- lib/mongoid/paths.rb
-- lib/mongoid/persistence.rb
-- lib/mongoid/persistence/command.rb
-- lib/mongoid/persistence/insert.rb
-- lib/mongoid/persistence/update.rb
 - lib/mongoid/scope.rb
-- lib/mongoid/state.rb
 - lib/mongoid/timestamps.rb
 - lib/mongoid/validations.rb
 - lib/mongoid/validations/associated.rb
@@ -193,16 +177,13 @@ files:
 - spec/integration/mongoid/commands_spec.rb
 - spec/integration/mongoid/contexts/enumerable_spec.rb
 - spec/integration/mongoid/criteria_spec.rb
-- spec/integration/mongoid/dirty_spec.rb
 - spec/integration/mongoid/document_spec.rb
 - spec/integration/mongoid/extensions_spec.rb
 - spec/integration/mongoid/finders_spec.rb
 - spec/integration/mongoid/inheritance_spec.rb
 - spec/integration/mongoid/named_scope_spec.rb
-- spec/integration/mongoid/persistence/update_spec.rb
 - spec/models/address.rb
 - spec/models/animal.rb
-- spec/models/callbacks.rb
 - spec/models/comment.rb
 - spec/models/country_code.rb
 - spec/models/employer.rb
@@ -223,12 +204,11 @@ files:
 - spec/spec.opts
 - spec/spec_helper.rb
 - spec/unit/mongoid/associations/belongs_to_related_spec.rb
-- spec/unit/mongoid/associations/embedded_in_spec.rb
-- spec/unit/mongoid/associations/embeds_many_spec.rb
-- spec/unit/mongoid/associations/embeds_one_spec.rb
+- spec/unit/mongoid/associations/belongs_to_spec.rb
 - spec/unit/mongoid/associations/has_many_related_spec.rb
+- spec/unit/mongoid/associations/has_many_spec.rb
 - spec/unit/mongoid/associations/has_one_related_spec.rb
-- spec/unit/mongoid/associations/meta_data_spec.rb
+- spec/unit/mongoid/associations/has_one_spec.rb
 - spec/unit/mongoid/associations/options_spec.rb
 - spec/unit/mongoid/associations_spec.rb
 - spec/unit/mongoid/attributes_spec.rb
@@ -248,23 +228,18 @@ files:
 - spec/unit/mongoid/config_spec.rb
 - spec/unit/mongoid/contexts/enumerable_spec.rb
 - spec/unit/mongoid/contexts/mongo_spec.rb
-- spec/unit/mongoid/contexts_spec.rb
 - spec/unit/mongoid/criteria_spec.rb
 - spec/unit/mongoid/criterion/complex_spec.rb
 - spec/unit/mongoid/criterion/exclusion_spec.rb
 - spec/unit/mongoid/criterion/inclusion_spec.rb
 - spec/unit/mongoid/criterion/optional_spec.rb
 - spec/unit/mongoid/cursor_spec.rb
-- spec/unit/mongoid/deprecation_spec.rb
-- spec/unit/mongoid/dirty_spec.rb
 - spec/unit/mongoid/document_spec.rb
 - spec/unit/mongoid/errors_spec.rb
 - spec/unit/mongoid/extensions/array/accessors_spec.rb
 - spec/unit/mongoid/extensions/array/assimilation_spec.rb
 - spec/unit/mongoid/extensions/array/conversions_spec.rb
 - spec/unit/mongoid/extensions/array/parentization_spec.rb
-- spec/unit/mongoid/extensions/big_decimal/conversions_spec.rb
-- spec/unit/mongoid/extensions/binary/conversions_spec.rb
 - spec/unit/mongoid/extensions/boolean/conversions_spec.rb
 - spec/unit/mongoid/extensions/date/conversions_spec.rb
 - spec/unit/mongoid/extensions/datetime/conversions_spec.rb
@@ -282,14 +257,12 @@ files:
 - spec/unit/mongoid/extensions/string/inflections_spec.rb
 - spec/unit/mongoid/extensions/symbol/inflections_spec.rb
 - spec/unit/mongoid/extensions/time/conversions_spec.rb
-- spec/unit/mongoid/extras_spec.rb
 - spec/unit/mongoid/factory_spec.rb
 - spec/unit/mongoid/field_spec.rb
 - spec/unit/mongoid/fields_spec.rb
 - spec/unit/mongoid/finders_spec.rb
 - spec/unit/mongoid/identity_spec.rb
 - spec/unit/mongoid/indexes_spec.rb
-- spec/unit/mongoid/javascript_spec.rb
 - spec/unit/mongoid/matchers/all_spec.rb
 - spec/unit/mongoid/matchers/default_spec.rb
 - spec/unit/mongoid/matchers/exists_spec.rb
@@ -304,13 +277,7 @@ files:
 - spec/unit/mongoid/matchers_spec.rb
 - spec/unit/mongoid/memoization_spec.rb
 - spec/unit/mongoid/named_scope_spec.rb
-- spec/unit/mongoid/observable_spec.rb
-- spec/unit/mongoid/paths_spec.rb
-- spec/unit/mongoid/persistence/insert_spec.rb
-- spec/unit/mongoid/persistence/update_spec.rb
-- spec/unit/mongoid/persistence_spec.rb
 - spec/unit/mongoid/scope_spec.rb
-- spec/unit/mongoid/state_spec.rb
 - spec/unit/mongoid/timestamps_spec.rb
 - spec/unit/mongoid/validations/associated_spec.rb
 - spec/unit/mongoid/validations/uniqueness_spec.rb
@@ -351,16 +318,13 @@ test_files:
 - spec/integration/mongoid/commands_spec.rb
 - spec/integration/mongoid/contexts/enumerable_spec.rb
 - spec/integration/mongoid/criteria_spec.rb
-- spec/integration/mongoid/dirty_spec.rb
 - spec/integration/mongoid/document_spec.rb
 - spec/integration/mongoid/extensions_spec.rb
 - spec/integration/mongoid/finders_spec.rb
 - spec/integration/mongoid/inheritance_spec.rb
 - spec/integration/mongoid/named_scope_spec.rb
-- spec/integration/mongoid/persistence/update_spec.rb
 - spec/models/address.rb
 - spec/models/animal.rb
-- spec/models/callbacks.rb
 - spec/models/comment.rb
 - spec/models/country_code.rb
 - spec/models/employer.rb
@@ -380,12 +344,11 @@ test_files:
 - spec/models/vet_visit.rb
 - spec/spec_helper.rb
 - spec/unit/mongoid/associations/belongs_to_related_spec.rb
-- spec/unit/mongoid/associations/embedded_in_spec.rb
-- spec/unit/mongoid/associations/embeds_many_spec.rb
-- spec/unit/mongoid/associations/embeds_one_spec.rb
+- spec/unit/mongoid/associations/belongs_to_spec.rb
 - spec/unit/mongoid/associations/has_many_related_spec.rb
+- spec/unit/mongoid/associations/has_many_spec.rb
 - spec/unit/mongoid/associations/has_one_related_spec.rb
-- spec/unit/mongoid/associations/meta_data_spec.rb
+- spec/unit/mongoid/associations/has_one_spec.rb
 - spec/unit/mongoid/associations/options_spec.rb
 - spec/unit/mongoid/associations_spec.rb
 - spec/unit/mongoid/attributes_spec.rb
@@ -405,23 +368,18 @@ test_files:
 - spec/unit/mongoid/config_spec.rb
 - spec/unit/mongoid/contexts/enumerable_spec.rb
 - spec/unit/mongoid/contexts/mongo_spec.rb
-- spec/unit/mongoid/contexts_spec.rb
 - spec/unit/mongoid/criteria_spec.rb
 - spec/unit/mongoid/criterion/complex_spec.rb
 - spec/unit/mongoid/criterion/exclusion_spec.rb
 - spec/unit/mongoid/criterion/inclusion_spec.rb
 - spec/unit/mongoid/criterion/optional_spec.rb
 - spec/unit/mongoid/cursor_spec.rb
-- spec/unit/mongoid/deprecation_spec.rb
-- spec/unit/mongoid/dirty_spec.rb
 - spec/unit/mongoid/document_spec.rb
 - spec/unit/mongoid/errors_spec.rb
 - spec/unit/mongoid/extensions/array/accessors_spec.rb
 - spec/unit/mongoid/extensions/array/assimilation_spec.rb
 - spec/unit/mongoid/extensions/array/conversions_spec.rb
 - spec/unit/mongoid/extensions/array/parentization_spec.rb
-- spec/unit/mongoid/extensions/big_decimal/conversions_spec.rb
-- spec/unit/mongoid/extensions/binary/conversions_spec.rb
 - spec/unit/mongoid/extensions/boolean/conversions_spec.rb
 - spec/unit/mongoid/extensions/date/conversions_spec.rb
 - spec/unit/mongoid/extensions/datetime/conversions_spec.rb
@@ -439,14 +397,12 @@ test_files:
 - spec/unit/mongoid/extensions/string/inflections_spec.rb
 - spec/unit/mongoid/extensions/symbol/inflections_spec.rb
 - spec/unit/mongoid/extensions/time/conversions_spec.rb
-- spec/unit/mongoid/extras_spec.rb
 - spec/unit/mongoid/factory_spec.rb
 - spec/unit/mongoid/field_spec.rb
 - spec/unit/mongoid/fields_spec.rb
 - spec/unit/mongoid/finders_spec.rb
 - spec/unit/mongoid/identity_spec.rb
 - spec/unit/mongoid/indexes_spec.rb
-- spec/unit/mongoid/javascript_spec.rb
 - spec/unit/mongoid/matchers/all_spec.rb
 - spec/unit/mongoid/matchers/default_spec.rb
 - spec/unit/mongoid/matchers/exists_spec.rb
@@ -461,13 +417,7 @@ test_files:
 - spec/unit/mongoid/matchers_spec.rb
 - spec/unit/mongoid/memoization_spec.rb
 - spec/unit/mongoid/named_scope_spec.rb
-- spec/unit/mongoid/observable_spec.rb
-- spec/unit/mongoid/paths_spec.rb
-- spec/unit/mongoid/persistence/insert_spec.rb
-- spec/unit/mongoid/persistence/update_spec.rb
-- spec/unit/mongoid/persistence_spec.rb
 - spec/unit/mongoid/scope_spec.rb
-- spec/unit/mongoid/state_spec.rb
 - spec/unit/mongoid/timestamps_spec.rb
 - spec/unit/mongoid/validations/associated_spec.rb
 - spec/unit/mongoid/validations/uniqueness_spec.rb

data/lib/mongoid/associations/meta_data.rb

@@ -1,28 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Associations #:nodoc:
-    class MetaData #:nodoc:
-
-      attr_reader :association, :options
-
-      delegate :macro, :to => :association
-
-      # Delegate all methods on +Options+ to the options instance.
-      Associations::Options.public_instance_methods(false).each do |name|
-        define_method(name) { |*args| @options.send(name) }
-      end
-
-      # Create the new associations MetaData object, which holds the type of
-      # the association and its options, with convenience methods for getting
-      # that information.
-      #
-      # Options:
-      #
-      # association: The association type as a class instance.
-      # options: The association options
-      def initialize(association, options)
-        @association, @options = association, options
-      end
-    end
-  end
-end

data/lib/mongoid/contexts/ids.rb

@@ -1,25 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Contexts #:nodoc:
-    module Ids
-      # Return documents based on an id search. Will handle if a single id has
-      # been passed or mulitple ids.
-      #
-      # Example:
-      #
-      #   context.id_criteria([1, 2, 3])
-      #
-      # Returns:
-      #
-      # The single or multiple documents.
-      def id_criteria(params)
-        criteria.id(params)
-        result = params.is_a?(Array) ? criteria.entries : one
-        if Mongoid.raise_not_found_error
-          raise Errors::DocumentNotFound.new(klass, params) if result.blank?
-        end
-        return result
-      end
-    end
-  end
-end

data/lib/mongoid/deprecation.rb

@@ -1,22 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  class Deprecation #:nodoc
-    include Singleton
-
-    # Alert of a deprecation. This will delegate to the logger and call warn on
-    # it.
-    #
-    # Example:
-    #
-    # <tt>deprecation.alert("Method no longer used")</tt>
-    def alert(message)
-      @logger.warn("Deprecation: #{message}")
-    end
-
-    protected
-    # Instantiate a new logger to stdout or a rails logger if available.
-    def initialize
-      @logger = defined?(Rails) ? Rails.logger : Logger.new($stdout)
-    end
-  end
-end

data/lib/mongoid/dirty.rb

@@ -1,203 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Dirty #:nodoc:
-    extend ActiveSupport::Concern
-    module InstanceMethods #:nodoc:
-      # Gets the changes for a specific field.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.attribute_change("title") # [ "Sir", "Madam" ]
-      #
-      # Returns:
-      #
-      # An +Array+ containing the old and new values.
-      def attribute_change(name)
-        @modifications[name]
-      end
-
-      # Determines if a specific field has chaged.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.attribute_changed?("title") # true
-      #
-      # Returns:
-      #
-      # +true+ if changed, +false+ if not.
-      def attribute_changed?(name)
-        @modifications.include?(name)
-      end
-
-      # Gets the old value for a specific field.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.attribute_was("title") # "Sir"
-      #
-      # Returns:
-      #
-      # The old field value.
-      def attribute_was(name)
-        change = @modifications[name]
-        change ? change[0] : nil
-      end
-
-      # Gets the names of all the fields that have changed in the document.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.changed # returns [ "title" ]
-      #
-      # Returns:
-      #
-      # An +Array+ of changed field names.
-      def changed
-        @modifications.keys
-      end
-
-      # Alerts to whether the document has been modified or not.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.changed? # returns true
-      #
-      # Returns:
-      #
-      # +true+ if changed, +false+ if not.
-      def changed?
-        !@modifications.empty?
-      end
-
-      # Gets all the modifications that have happened to the object as a +Hash+
-      # with the keys being the names of the fields, and the values being an
-      # +Array+ with the old value and new value.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.changes # returns { "title" => [ "Sir", "Madam" ] }
-      #
-      # Returns:
-      #
-      # A +Hash+ of changes.
-      def changes
-        @modifications
-      end
-
-      # Call this method after save, so the changes can be properly switched.
-      #
-      # Example:
-      #
-      # <tt>person.move_changes</tt>
-      def move_changes
-        @previous_modifications = @modifications.dup
-        @modifications = {}
-      end
-
-      # Gets all the new values for each of the changed fields, to be passed to
-      # a MongoDB $set modifier.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.setters # returns { "title" => "Madam" }
-      #
-      # Returns:
-      #
-      # A +Hash+ of new values.
-      def setters
-        @modifications.inject({}) do |sets, (field, changes)|
-          key = embedded ? "#{position}.#{field}" : field
-          sets[key] = changes[1]; sets
-        end
-      end
-
-      # Gets all the modifications that have happened to the object before the
-      # object was saved.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.save!
-      #   person.previous_changes # returns { "title" => [ "Sir", "Madam" ] }
-      #
-      # Returns:
-      #
-      # A +Hash+ of changes before save.
-      def previous_changes
-        @previous_modifications
-      end
-
-      # Resets a changed field back to its old value.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.reset_attribute!("title")
-      #   person.title # "Sir"
-      #
-      # Returns:
-      #
-      # The old field value.
-      def reset_attribute!(name)
-        value = attribute_was(name)
-        if value
-          @attributes[name] = value
-          @modifications.delete(name)
-        end
-      end
-
-      # Sets up the modifications hash. This occurs just after the document is
-      # instantiated.
-      #
-      # Example:
-      #
-      # <tt>document.setup_notifications</tt>
-      def setup_modifications
-        @modifications ||= {}
-        @previous_modifications ||= {}
-      end
-
-      protected
-      # Audit the change of a field's value.
-      def modify(name, old_value, new_value)
-        @attributes[name] = new_value
-        @modifications[name] = [ old_value, new_value ] if @modifications
-      end
-    end
-    module ClassMethods #:nodoc:
-      # Add the dynamic dirty methods. These are custom methods defined on a
-      # field by field basis that wrap the dirty attribute methods.
-      #
-      # Example:
-      #
-      #   person = Person.new(:title => "Sir")
-      #   person.title = "Madam"
-      #   person.title_change # [ "Sir", "Madam" ]
-      #   person.title_changed? # true
-      #   person.title_was # "Sir"
-      #   person.reset_title!
-      def add_dirty_methods(name)
-        define_method("#{name}_change") { attribute_change(name) }
-        define_method("#{name}_changed?") { attribute_changed?(name) }
-        define_method("#{name}_was") { attribute_was(name) }
-        define_method("reset_#{name}!") { reset_attribute!(name) }
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/big_decimal/conversions.rb

@@ -1,19 +0,0 @@
-# encoding: utf-8
-require "bigdecimal"
-
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module BigDecimal #:nodoc:
-      module Conversions #:nodoc:
-        # Get the string as a +BigDecimal+
-        def get(value)
-          ::BigDecimal.new(value)
-        end
-        # Set the value in the hash as a string.
-        def set(value)
-          value.to_s
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/binary/conversions.rb

@@ -1,17 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Binary #:nodoc:
-      module Conversions #:nodoc:
-        # Get the value from the db hash.
-        def get(value)
-          value
-        end
-        # Set the value in the db hash.
-        def set(value)
-          value
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/objectid/conversions.rb

@@ -1,15 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module ObjectID #:nodoc:
-      module Conversions #:nodoc:
-        def set(value)
-          value
-        end
-        def get(value)
-          value
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extras.rb

@@ -1,61 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extras #:nodoc:
-    extend ActiveSupport::Concern
-    included do
-      class_inheritable_accessor :cached, :enslaved
-      self.cached = false
-      self.enslaved = false
-      delegate :cached?, :enslaved?, :to => "self.class"
-    end
-
-    module ClassMethods #:nodoc
-      # Sets caching on for this class. This class level configuration will
-      # default all queries to cache the results of the first iteration over
-      # the cursor into an internal array. This should only be used for queries
-      # that return a small number of results or have small documents, as after
-      # the first iteration the entire results will be stored in memory.
-      #
-      # Example:
-      #
-      #   class Person
-      #     include Mongoid::Document
-      #     cache
-      #   end
-      def cache
-        self.cached = true
-      end
-
-      # Determines if the class is cached or not.
-      #
-      # Returns:
-      #
-      # True if cached, false if not.
-      def cached?
-        !!self.cached
-      end
-
-      # Set whether or not this documents read operations should delegate to
-      # the slave database by default.
-      #
-      # Example:
-      #
-      #   class Person
-      #     include Mongoid::Document
-      #     enslave
-      #   end
-      def enslave
-        self.enslaved = true
-      end
-
-      # Determines if the class is enslaved or not.
-      #
-      # Returns:
-      #
-      # True if enslaved, false if not.
-      def enslaved?
-        !!self.enslaved
-      end
-    end
-  end
-end