mongoid 2.4.10 → 3.0.0

data/lib/mongoid/criterion/selector.rb

@@ -1,177 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Criterion #:nodoc:
-
-    # The selector is a hash-like object that has special behaviour for merging
-    # mongoid criteria selectors.
-    class Selector < Hash
-
-      attr_reader :aliased_fields, :fields, :klass
-
-      # Create the new selector.
-      #
-      # @example Create the selector.
-      #   Selector.new(Person)
-      #
-      # @param [ Class ] klass The class the selector is for.
-      #
-      # @since 1.0.0
-      def initialize(klass)
-        @aliased_fields, @fields, @klass =
-          klass.aliased_fields, klass.fields.except("_id", "_type"), klass
-      end
-
-      # Set the value for the supplied key, attempting to typecast the value.
-      #
-      # @example Set the value for the key.
-      #   selector["$ne"] = { :name => "Zorg" }
-      #
-      # @param [ String, Symbol ] key The hash key.
-      # @param [ Object ] value The value to set.
-      #
-      # @since 2.0.0
-      def []=(key, value)
-        key = "#{key}.#{::I18n.locale}" if klass.fields[key.to_s].try(:localized?)
-        super(key, try_to_typecast(key, value))
-      end
-
-      # Merge the selector with another hash.
-      #
-      # @example Merge the objects.
-      #   selector.merge!({ :key => "value" })
-      #
-      # @param [ Hash, Selector ] other The object to merge with.
-      #
-      # @return [ Selector ] The merged selector.
-      #
-      # @since 1.0.0
-      def merge!(other)
-        tap do |selector|
-          other.each_pair do |key, value|
-            selector[key] = value
-          end
-        end
-      end
-      alias :update :merge!
-
-      if RUBY_VERSION < '1.9'
-
-        # Generate pretty inspection for old ruby versions.
-        #
-        # @example Inspect the selector.
-        #   selector.inspect
-        #
-        # @return [ String ] The inspected selector.
-        def inspect
-          ret = self.keys.inject([]) do |ret, key|
-            ret << "#{key.inspect}=>#{self[key].inspect}"
-          end
-          "{#{ret.sort.join(', ')}}"
-        end
-      end
-
-      private
-
-      # If the key is defined as a field, then attempt to typecast it.
-      #
-      # @example Try to cast.
-      #   selector.try_to_typecast(:id, 1)
-      #
-      # @param [ String, Symbol ] key The field name.
-      # @param [ Object ] value The value.
-      #
-      # @return [ Object ] The typecasted value.
-      #
-      # @since 1.0.0
-      def try_to_typecast(key, value)
-        access = key.to_s
-        if field = fields[key.to_s] || fields[aliased_fields[key.to_s]]
-          typecast_value_for(field, value)
-        elsif proper_and_or_value?(key, value)
-          handle_and_or_value(value)
-        else
-          value
-        end
-      end
-
-      def proper_and_or_value?(key, value)
-        ["$and", "$or"].include?(key) &&
-          value.is_a?(Array) &&
-          value.all?{ |e| e.is_a?(Hash) }
-      end
-
-      def handle_and_or_value(values)
-        [].tap do |result|
-           result.push(*values.map do |value|
-            Hash[value.map do |_key, _value|
-              if klass.fields[_key.to_s].try(:localized?)
-                _key = "#{_key}.#{::I18n.locale}"
-              end
-              [_key, try_to_typecast(_key, _value)]
-            end]
-          end)
-        end
-      end
-
-      # Get the typecast value for the defined field.
-      #
-      # @example Get the typecast value.
-      #   selector.typecast_value_for(:name, "Corbin")
-      #
-      # @param [ Field ] field The defined field.
-      # @param [ Object ] value The value to cast.
-      #
-      # @return [ Object ] The cast value.
-      #
-      # @since 1.0.0
-      def typecast_value_for(field, value)
-        return field.selection(value) if field.type === value
-        case value
-        when Hash
-          value = value.dup
-          value.each_pair do |k, v|
-            value[k] = typecast_hash_value(field, k, v)
-          end
-        when Array
-          value.map { |v| typecast_value_for(field, v) }
-        when Regexp
-          value
-        when Range
-          {
-            "$gte" => typecast_value_for(field, value.first),
-            "$lte" => typecast_value_for(field, value.last)
-          }
-        else
-          if field.type == Array
-            Serialization.mongoize(value, value.class)
-          else
-            field.selection(value)
-          end
-        end
-      end
-
-      # Typecast the value for booleans and integers in hashes.
-      #
-      # @example Typecast the hash values.
-      #   selector.typecast_hash_value(field, "$exists", "true")
-      #
-      # @param [ Field ] field The defined field.
-      # @param [ String ] key The modifier key.
-      # @param [ Object ] value The value to cast.
-      #
-      # @return [ Object ] The cast value.
-      #
-      # @since 1.0.0
-      def typecast_hash_value(field, key, value)
-        case key
-        when "$exists"
-          Serialization.mongoize(value, Boolean)
-        when "$size"
-          Serialization.mongoize(value, Integer)
-        else
-          typecast_value_for(field, value)
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/cursor.rb

@@ -1,88 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc
-
-  # Mongoid wrapper of the Ruby Driver cursor.
-  class Cursor
-    include Mongoid::Collections::Retry
-    include Enumerable
-
-    # Operations on the Mongo::Cursor object that will not get overriden by the
-    # Mongoid::Cursor are defined here.
-    OPERATIONS = [
-      :close,
-      :closed?,
-      :count,
-      :explain,
-      :fields,
-      :full_collection_name,
-      :hint,
-      :limit,
-      :order,
-      :query_options_hash,
-      :query_opts,
-      :selector,
-      :skip,
-      :snapshot,
-      :sort,
-      :timeout
-    ]
-
-    attr_reader :collection, :cursor, :klass
-
-    # The operations above will all delegate to the proxied Mongo::Cursor.
-    OPERATIONS.each do |name|
-      class_eval <<-EOS, __FILE__, __LINE__
-        def #{name}(*args)
-          retry_on_connection_failure do
-            cursor.#{name}(*args)
-          end
-        end
-      EOS
-    end
-
-    # Iterate over each document in the cursor and yield to it.
-    #
-    # @example Iterate over the cursor.
-    #   cursor.each { |doc| p doc.title }
-    def each
-      retry_on_connection_failure do
-        while document = cursor.next_document
-          yield Factory.from_db(klass, document)
-        end
-      end
-    end
-
-    # Create the new +Mongoid::Cursor+.
-    #
-    # @example Instantiate the cursor.
-    #   Mongoid::Cursor.new(Person, cursor)
-    #
-    # @param [ Class ] klass The class associated with the cursor.
-    # @param [ Collection ] collection The Mongoid::Collection instance.
-    # @param [ Mongo::Cursor ] cursor The Mongo::Cursor to be proxied.
-    def initialize(klass, collection, cursor)
-      @klass, @collection, @cursor = klass, collection, cursor
-    end
-
-    # Return the next document in the cursor. Will instantiate a new Mongoid
-    # document with the attributes.
-    #
-    # @example Get the next document.
-    #   cursor.next_document
-    #
-    # @return [ Document ] The next document in the cursor.
-    def next_document
-      Mongoid::Factory.from_db(klass, cursor.next_document)
-    end
-
-    # Returns an array of all the documents in the cursor.
-    #
-    # @example Get the cursor as an array.
-    #   cursor.to_a
-    #
-    # @return [ Array<Document> ] An array of documents.
-    def to_a
-      cursor.to_a.collect { |attrs| Mongoid::Factory.from_db(klass, attrs) }
-    end
-  end
-end

data/lib/mongoid/default_scope.rb

@@ -1,36 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-
-  # This module handles functionality for creating default scopes.
-  module DefaultScope
-    extend ActiveSupport::Concern
-
-    included do
-      class_attribute :default_scoping
-    end
-
-    module ClassMethods #:nodoc:
-
-      # Creates a default_scope for the +Document+, similar to ActiveRecord's
-      # default_scope. +DefaultScopes+ are proxied +Criteria+ objects that are
-      # applied by default to all queries for the class.
-      #
-      # @example Create a default scope.
-      #
-      #   class Person
-      #     include Mongoid::Document
-      #     field :active, :type => Boolean
-      #     field :count, :type => Integer
-      #
-      #     default_scope :where => { :active => true }
-      #   end
-      #
-      # @param [ Hash ] conditions The conditions to create with.
-      #
-      # @since 2.0.0.rc.1
-      def default_scope(conditions = {})
-        self.default_scoping = Scope.new(conditions).conditions.as_conditions
-      end
-    end
-  end
-end

data/lib/mongoid/errors/invalid_type.rb

@@ -1,25 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc
-  module Errors #:nodoc
-
-    # Raised when trying to get or set a value for a defined field, where the
-    # type of the object does not match the defined field type.
-    #
-    # @example Create the error.
-    #   InvalidType.new(Array, "Not an Array")
-    class InvalidType < MongoidError
-      def initialize(klass, value)
-        super(
-          translate(
-            "invalid_type",
-            {
-              :klass => klass.name,
-              :other => value.class.name,
-              :value => value.inspect
-            }
-          )
-        )
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/array/deep_copy.rb

@@ -1,25 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Array #:nodoc:
-      module DeepCopy #:nodoc:
-
-        # Make a deep copy of the array.
-        #
-        # @example Make a deep copy.
-        #   [ 1, 2, 3 ]._deep_copy
-        #
-        # @return [ Array ] The deep copy.
-        #
-        # @since 2.4.0
-        def _deep_copy
-          [].tap do |copy|
-            each do |value|
-              copy.push(value._deep_copy)
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/array/deletion.rb

@@ -1,29 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Array #:nodoc:
-
-      # This module contains deletion helpers for arrays.
-      module Deletion
-
-        # Delete the first object in the array that is equal to the supplied
-        # object and return it. This is much faster than performing a standard
-        # delete for large arrays ince it attempt to delete multiple in the
-        # other.
-        #
-        # @example Delete the first object.
-        #   [ "1", "2", "1" ].delete_one("1")
-        #
-        # @param [ Object ] object The object to delete.
-        #
-        # @return [ Object ] The deleted object.
-        #
-        # @since 2.1.0
-        def delete_one(object)
-          position = index(object)
-          position ? delete_at(position) : nil
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/false_class/equality.rb

@@ -1,26 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module FalseClass #:nodoc:
-
-      # Adds equality hooks for false values.
-      module Equality
-
-        # Is the passed value a boolean?
-        #
-        # @example Is the value a boolean type?
-        #   false.is_a?(Boolean)
-        #
-        # @param [ Class ] other The class to check.
-        #
-        # @return [ true, false ] If the other is a boolean.
-        #
-        # @since 1.0.0
-        def is_a?(other)
-          return true if other.name == "Boolean"
-          super(other)
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/hash/criteria_helpers.rb

@@ -1,47 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Hash #:nodoc:
-
-      # Expands complex criterion into mongodb selectors.
-      module CriteriaHelpers
-
-        # Expand the complex criteria into a MongoDB compliant selector hash.
-        #
-        # @example Convert the criterion.
-        #   {}.expand_complex_criteria
-        #
-        # @return [ Hash ] The mongo selector.
-        #
-        # @since 1.0.0
-        def expand_complex_criteria
-          {}.tap do |hsh|
-            each_pair do |k, v|
-              if k.respond_to?(:key) && k.respond_to?(:to_mongo_query)
-                hsh[k.key] ||= {}
-                v = v.expand_complex_criteria if v.is_a?(::Hash)
-                hsh[k.key].merge!(k.to_mongo_query(v))
-              else
-                v.map!{|e| e.is_a?(::Hash) ? e.expand_complex_criteria : e } if v.is_a?(::Array)
-                hsh[k] = v
-              end
-            end
-          end
-        end
-
-        # Get the id attribute from this hash, whether it's prefixed with an
-        # underscore or is a symbol.
-        #
-        # @example Extract the id.
-        #   { :_id => 1 }.extract_id
-        #
-        # @return [ Object ] The value of the id.
-        #
-        # @since 2.3.2
-        def extract_id
-          self["id"] || self["_id"] || self[:id] || self[:_id]
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/hash/deep_copy.rb

@@ -1,25 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Hash #:nodoc:
-      module DeepCopy #:nodoc:
-
-        # Make a deep copy of the hash.
-        #
-        # @example Make a deep copy.
-        #   { :test => "value" }._deep_copy
-        #
-        # @return [ Hash ] The deep copy.
-        #
-        # @since 2.4.0
-        def _deep_copy
-          {}.tap do |copy|
-            each_pair do |key, value|
-              copy[key] = value._deep_copy
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/hash/scoping.rb

@@ -1,25 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Hash #:nodoc:
-
-      # Adds functionality for criteria scoping/merging.
-      module Scoping
-
-        # Get the hash scoped for criteria merges.
-        #
-        # @example Get the hash.
-        #   { :field => "value" }.scoped
-        #
-        # @param [ Array ] args The arguments (ignored).
-        #
-        # @return [ Hash ] The hash unmodified.
-        #
-        # @since 1.0.0
-        def as_conditions(*args)
-          self
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/integer/checks.rb

@@ -1,23 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Integer #:nodoc:
-
-      # This module has object checks in it.
-      module Checks #:nodoc:
-
-        # Is the object not to be converted to bson on criteria creation?
-        #
-        # @example Is the object unconvertable?
-        #   object.unconvertable_to_bson?
-        #
-        # @return [ true ] If the object is unconvertable.
-        #
-        # @since 2.2.1
-        def unconvertable_to_bson?
-          true
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/nil/collectionization.rb

@@ -1,23 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Nil #:nodoc:
-
-      # This module safeguards collection access on anonymous classes.
-      module Collectionization
-
-        # Get the name of a nil collection.
-        #
-        # @example Get the nil name.
-        #   nil.collectionize
-        #
-        # @return [ String ] A blank string.
-        #
-        # @since 1.0.0
-        def collectionize
-          to_s.collectionize
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/object/checks.rb

@@ -1,29 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Object #:nodoc:
-
-      # This module has object checks in it.
-      module Checks #:nodoc:
-
-        # Since Active Support's blank? check looks to see if the object
-        # responds to #empty? and will call it if it does, we need another way
-        # to check if the object is empty or nil in case the user has defined a
-        # field called "empty" on the document.
-        #
-        # @example Is the array vacant?
-        #   [].vacant?
-        #
-        # @example Is the object vacant?
-        #   nil.vacant?
-        #
-        # @return [ true, false ] True if empty or nil, false if not.
-        #
-        # @since 2.0.2
-        def _vacant?
-          is_a?(::Array) || is_a?(::String) ? empty? : !self
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/object/deep_copy.rb

@@ -1,21 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Object #:nodoc:
-      module DeepCopy #:nodoc:
-
-        # Make a deep copy of the object.
-        #
-        # @example Make a deep copy.
-        #   "testing"._deep_copy
-        #
-        # @return [ Object ] The deep copy.
-        #
-        # @since 2.4.0
-        def _deep_copy
-          duplicable? ? dup : self
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/object/reflections.rb

@@ -1,48 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Object #:nodoc:
-
-      # This module contains reflection convenience methods.
-      module Reflections
-        extend ActiveSupport::Concern
-
-        # Get the value for an instance variable or nil if it doesn't exist.
-        #
-        # @example Get the value for an instance var.
-        #   document.ivar("person")
-        #
-        # @param [ String ] name The name of the variable.
-        #
-        # @return [ Object, nil ] The value or nil.
-        #
-        # @since 2.0.0.rc.1
-        def ivar(name)
-          if instance_variable_defined?("@#{name}")
-            return instance_variable_get("@#{name}")
-          else
-            false
-          end
-        end
-
-        # Remove the instance variable for the provided name.
-        #
-        # @example Remove the instance variable
-        #   document.remove_ivar("person")
-        #
-        # @param [ String ] name The name of the variable.
-        #
-        # @return [ true, false ] If the variable was defined.
-        #
-        # @since 2.1.0
-        def remove_ivar(name)
-          if instance_variable_defined?("@#{name}")
-            return remove_instance_variable("@#{name}")
-          else
-            false
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/extensions/object/substitutable.rb

@@ -1,15 +0,0 @@
-# encoding: utf-8
-module Mongoid #:nodoc:
-  module Extensions #:nodoc:
-    module Object #:nodoc:
-
-      # This module is for defining base substitutable behaviour.
-      module Substitutable #:nodoc:
-
-        def substitutable
-          self
-        end
-      end
-    end
-  end
-end