mongoid 2.4.9 → 3.0.0.rc

data/lib/mongoid/errors/unsaved_document.rb

@@ -1,20 +1,16 @@
 # encoding: utf-8
-module Mongoid #:nodoc
-  module Errors #:nodoc
+module Mongoid
+  module Errors
 
     # Raised when attempting to call create or create! through a
     # references_many when the parent document has not been saved. This
     # prevents the child from getting presisted and immediately being orphaned.
     class UnsavedDocument < MongoidError
-
-      attr_reader :base, :document
-
       def initialize(base, document)
-        @base, @document = base, document
         super(
-          translate(
+          compose_message(
             "unsaved_document",
-            { :base => base.class.name, :document => document.class.name }
+            { base: base.class.name, document: document.class.name }
           )
         )
       end

data/lib/mongoid/errors/unsupported_javascript.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # Raised when Javascript criteria selector is passed for embedded document.
+    class UnsupportedJavascript < MongoidError
+
+      # Create the new error caused by using Javascript in embedded document criteria selector.
+      #
+      # @example Create the error.
+      #   UnsupportedJavascriptSelector.new(Album, "this.name == '101'")
+      #
+      # @param [ Class ] klass The embedded document class.
+      # @param [ String ] javascript The javascript expression.
+      #
+      # @since 3.0.0
+      def initialize(klass, javascript)
+        super(
+          compose_message(
+            "unsupported_javascript",
+            { klass: klass, javascript: javascript }
+          )
+        )
+      end
+    end
+  end
+end

data/lib/mongoid/errors/unsupported_version.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
-module Mongoid #:nodoc
-  module Errors #:nodoc
+module Mongoid
+  module Errors
 
     # Raised when the database version is not supported by Mongoid.
     #
@@ -9,9 +9,9 @@ module Mongoid #:nodoc
     class UnsupportedVersion < MongoidError
       def initialize(version)
         super(
-          translate(
+          compose_message(
             "unsupported_version",
-            { :version => version, :mongo_version => Mongoid::MONGODB_VERSION }
+            { version: version, mongo_version: Mongoid::MONGODB_VERSION }
           )
         )
       end

data/lib/mongoid/errors/validations.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
-module Mongoid #:nodoc
-  module Errors #:nodoc
+module Mongoid
+  module Errors
 
     # Raised when a persistence method ending in ! fails validation. The message
     # will contain the full error messages from the +Document+ in question.
@@ -8,13 +8,14 @@ module Mongoid #:nodoc
     # @example Create the error.
     #   Validations.new(person.errors)
     class Validations < MongoidError
-      attr_reader :document
       def initialize(document)
-        @document = document
         super(
-          translate(
+          compose_message(
             "validations",
-            { :errors => document.errors.full_messages.join(", ") }
+            {
+              document: document.class,
+              errors: document.errors.full_messages.join(", ")
+            }
           )
         )
       end

data/lib/mongoid/errors/versioning_not_on_root.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # This error is raised when attempting to version an embedded document.
+    class VersioningNotOnRoot < MongoidError
+
+      # Create the new error.
+      #
+      # @example Create the new error.
+      #   VersioningNotOnRoot.new(Address)
+      #
+      # @param [ Class ] klass The embedded class.
+      #
+      # @since 3.0.0
+      def initialize(klass)
+        super(
+          compose_message("versioning_not_on_root", { klass: klass })
+        )
+      end
+    end
+  end
+end

data/lib/mongoid/errors.rb

@@ -1,19 +1,40 @@
 # encoding: utf-8
 require "mongoid/errors/mongoid_error"
+require "mongoid/errors/ambiguous_relationship"
 require "mongoid/errors/callback"
 require "mongoid/errors/document_not_found"
 require "mongoid/errors/eager_load"
 require "mongoid/errors/invalid_collection"
+require "mongoid/errors/invalid_config_option"
 require "mongoid/errors/invalid_database"
 require "mongoid/errors/invalid_field"
+require "mongoid/errors/invalid_field_option"
 require "mongoid/errors/invalid_find"
+require "mongoid/errors/invalid_index"
 require "mongoid/errors/invalid_options"
+require "mongoid/errors/invalid_scope"
+require "mongoid/errors/invalid_set_polymorphic_relation"
+require "mongoid/errors/invalid_storage_options"
 require "mongoid/errors/invalid_time"
-require "mongoid/errors/invalid_type"
+require "mongoid/errors/inverse_not_found"
 require "mongoid/errors/mixed_relations"
+require "mongoid/errors/mixed_session_configuration"
+require "mongoid/errors/nested_attributes_metadata_not_found"
+require "mongoid/errors/no_default_session"
 require "mongoid/errors/no_environment"
+require "mongoid/errors/no_map_reduce_output"
+require "mongoid/errors/no_parent"
+require "mongoid/errors/no_session_config"
+require "mongoid/errors/no_sessions_config"
+require "mongoid/errors/no_session_database"
+require "mongoid/errors/no_session_hosts"
+require "mongoid/errors/readonly_attribute"
 require "mongoid/errors/scope_overwrite"
 require "mongoid/errors/too_many_nested_attribute_records"
+require "mongoid/errors/unknown_attribute"
 require "mongoid/errors/unsaved_document"
+require "mongoid/errors/unsupported_javascript"
 require "mongoid/errors/unsupported_version"
 require "mongoid/errors/validations"
+require "mongoid/errors/versioning_not_on_root"
+require "mongoid/errors/delete_restriction"

data/lib/mongoid/extensions/array.rb

@@ -0,0 +1,127 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Array
+
+      # Evolve the array into an array of object ids.
+      #
+      # @example Evolve the array to object ids.
+      #   [ id ].__evolve_object_id__
+      #
+      # @return [ Array<Moped::BSON::ObjectId> ] The converted array.
+      #
+      # @since 3.0.0
+      def __evolve_object_id__
+        map!(&:__evolve_object_id__).compact!
+        self
+      end
+
+      # Converts the array for storing as a time.
+      #
+      # @example Convert the array to a time.
+      #   [ 2010, 1, 1 ].__mongoize_time__
+      #
+      # @return [ Time ] The time.
+      #
+      # @since 3.0.0
+      def __mongoize_time__
+        ::Time.configured.local(*self)
+      end
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   object.mongoize
+      #
+      # @return [ Array ] The object.
+      #
+      # @since 3.0.0
+      def mongoize
+        ::Array.mongoize(self)
+      end
+
+      # 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
+
+      # Is the object's size changable?
+      #
+      # @example Is the object resizable?
+      #   object.resizable?
+      #
+      # @return [ true ] true.
+      #
+      # @since 3.0.0
+      def resizable?
+        true
+      end
+
+      module ClassMethods
+
+        # Convert the provided object to a propery array of foreign keys.
+        #
+        # @example Mongoize the object.
+        #   Array.__mongoize_fk__(constraint, object)
+        #
+        # @param [ Constraint ] constraint The metadata constraint.
+        # @param [ Object ] object The object to convert.
+        #
+        # @return [ Array ] The array of ids.
+        #
+        # @since 3.0.0
+        def __mongoize_fk__(constraint, object)
+          if object.resizable?
+            object.blank? ? object : constraint.convert(object)
+          else
+            object.blank? ? [] : constraint.convert(Array(object))
+          end
+        end
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Array.mongoize([ 1, 2, 3 ])
+        #
+        # @param [ Object ] object The object to mongoize.
+        #
+        # @return [ Array ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          evolve(object)
+        end
+
+        # Is the object's size changable?
+        #
+        # @example Is the object resizable?
+        #   Array.resizable?
+        #
+        # @return [ true ] true.
+        #
+        # @since 3.0.0
+        def resizable?
+          true
+        end
+      end
+    end
+  end
+end
+
+::Array.__send__(:include, Mongoid::Extensions::Array)
+::Array.__send__(:extend, Mongoid::Extensions::Array::ClassMethods)

data/lib/mongoid/extensions/big_decimal.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module BigDecimal
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   object.mongoize
+      #
+      # @return [ Object ] The object.
+      #
+      # @since 3.0.0
+      def mongoize
+        to_s
+      end
+
+      module ClassMethods
+
+        # Convert the object from it's mongo friendly ruby type to this type.
+        #
+        # @example Demongoize the object.
+        #   Object.demongoize(object)
+        #
+        # @param [ Object ] object The object to demongoize.
+        #
+        # @return [ Object ] The object.
+        #
+        # @since 3.0.0
+        def demongoize(object)
+          if object
+            object.numeric? ? ::BigDecimal.new(object) : object
+          end
+        end
+      end
+    end
+  end
+end
+
+::BigDecimal.__send__(:include, Mongoid::Extensions::BigDecimal)
+::BigDecimal.__send__(:extend, Mongoid::Extensions::BigDecimal::ClassMethods)

data/lib/mongoid/extensions/boolean.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Boolean
+      module ClassMethods
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Boolean.mongoize("123.11")
+        #
+        # @return [ String ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          evolve(object)
+        end
+      end
+    end
+  end
+end
+
+::Boolean.__send__(:extend, Mongoid::Extensions::Boolean::ClassMethods)

data/lib/mongoid/extensions/date.rb

@@ -0,0 +1,70 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Date
+
+      # Convert the date into a time.
+      #
+      # @example Convert the date to a time.
+      #   date.__mongoize_time__
+      #
+      # @return [ Time ] The converted time.
+      #
+      # @since 3.0.0
+      def __mongoize_time__
+        ::Time.configured.local(year, month, day)
+      end
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   date.mongoize
+      #
+      # @return [ Time ] The object mongoized.
+      #
+      # @since 3.0.0
+      def mongoize
+        ::Date.mongoize(self)
+      end
+
+      module ClassMethods
+
+        # Convert the object from it's mongo friendly ruby type to this type.
+        #
+        # @example Demongoize the object.
+        #   Date.demongoize(object)
+        #
+        # @param [ Time ] object The time from Mongo.
+        #
+        # @return [ Date ] The object as a date.
+        #
+        # @since 3.0.0
+        def demongoize(object)
+          ::Date.new(object.year, object.month, object.day) if object
+        end
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Date.mongoize("2012-1-1")
+        #
+        # @param [ Object ] object The object to mongoize.
+        #
+        # @return [ Time ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          unless object.blank?
+            time = object.__mongoize_time__
+            ::Time.utc(time.year, time.month, time.day)
+          end
+        end
+      end
+    end
+  end
+end
+
+::Date.__send__(:include, Mongoid::Extensions::Date)
+::Date.__send__(:extend, Mongoid::Extensions::Date::ClassMethods)

data/lib/mongoid/extensions/date_time.rb

@@ -0,0 +1,68 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module DateTime
+
+      # Mongoize the date time into a time.
+      #
+      # @example Mongoize the date time.
+      #   date_time.__mongoize_time__
+      #
+      # @return [ Time ] The mongoized time.
+      #
+      # @since 3.0.0
+      def __mongoize_time__
+        return self if utc? && Mongoid.use_utc?
+        ::Time.configured.local(year, month, day, hour, min, sec)
+      end
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   date_time.mongoize
+      #
+      # @return [ Time ] The object mongoized.
+      #
+      # @since 3.0.0
+      def mongoize
+        ::DateTime.mongoize(self)
+      end
+
+      module ClassMethods
+
+        # Convert the object from it's mongo friendly ruby type to this type.
+        #
+        # @example Demongoize the object.
+        #   DateTime.demongoize(object)
+        #
+        # @param [ Time ] object The time from Mongo.
+        #
+        # @return [ DateTime ] The object as a date.
+        #
+        # @since 3.0.0
+        def demongoize(object)
+          ::Time.demongoize(object).try(:to_datetime)
+        end
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   DateTime.mongoize("2012-1-1")
+        #
+        # @param [ Object ] object The object to convert.
+        #
+        # @return [ Time ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          ::Time.mongoize(object)
+        end
+      end
+    end
+  end
+end
+
+::DateTime.__send__(:include, Mongoid::Extensions::DateTime)
+::DateTime.__send__(:extend, Mongoid::Extensions::DateTime::ClassMethods)

data/lib/mongoid/extensions/false_class.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module FalseClass
+
+      # 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)
+        if other == ::Boolean || other.class == ::Boolean
+          return true
+        end
+        super(other)
+      end
+    end
+  end
+end
+
+::FalseClass.__send__(:include, Mongoid::Extensions::FalseClass)

data/lib/mongoid/extensions/float.rb

@@ -0,0 +1,44 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Float
+
+      # Convert the float into a time.
+      #
+      # @example Convert the float into a time.
+      #   1335532685.117847.__mongoize_time__
+      #
+      # @return [ Time ] The float as a time.
+      #
+      # @since 3.0.0
+      def __mongoize_time__
+        ::Time.at(self)
+      end
+
+      module ClassMethods
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Float.mongoize("123.11")
+        #
+        # @param [ Object ] object The object to mongoize.
+        #
+        # @return [ String ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          unless object.blank?
+            __numeric__(object) rescue 0.0
+          else
+            nil
+          end
+        end
+      end
+    end
+  end
+end
+
+::Float.__send__(:include, Mongoid::Extensions::Float)
+::Float.__send__(:extend, Mongoid::Extensions::Float::ClassMethods)

data/lib/mongoid/extensions/hash.rb

@@ -0,0 +1,91 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Hash
+
+      # Evolves each value in the hash to an object id if it is convertable.
+      #
+      # @example Convert the hash values.
+      #   { field: id }.__evolve_object_id__
+      #
+      # @return [ Hash ] The converted hash.
+      #
+      # @since 3.0.0
+      def __evolve_object_id__
+        update_values(&:__evolve_object_id__)
+      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
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   object.mongoize
+      #
+      # @return [ Hash ] The object.
+      #
+      # @since 3.0.0
+      def mongoize
+        ::Hash.mongoize(self)
+      end
+
+      # Can the size of this object change?
+      #
+      # @example Is the hash resizable?
+      #   {}.resizable?
+      #
+      # @return [ true ] true.
+      #
+      # @since 3.0.0
+      def resizable?
+        true
+      end
+
+      module ClassMethods
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Hash.mongoize([ 1, 2, 3 ])
+        #
+        # @param [ Object ] object The object to mongoize.
+        #
+        # @return [ Hash ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          return if object.nil?
+          evolve(object).update_values { |value| value.mongoize }
+        end
+
+        # Can the size of this object change?
+        #
+        # @example Is the hash resizable?
+        #   {}.resizable?
+        #
+        # @return [ true ] true.
+        #
+        # @since 3.0.0
+        def resizable?
+          true
+        end
+      end
+    end
+  end
+end
+
+::Hash.__send__(:include, Mongoid::Extensions::Hash)
+::Hash.__send__(:extend, Mongoid::Extensions::Hash::ClassMethods)