mongoid 3.1.6 → 4.0.0

data/lib/mongoid/{criterion → criteria}/modifiable.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 module Mongoid
-  module Criterion
+  class Criteria
     module Modifiable
 
       # Build a document given the selector and return it.
@@ -68,6 +68,22 @@ module Mongoid
         find_or(:create, attrs, &block)
       end
 
+      # Find the first +Document+ given the conditions, or creates a new document
+      # with the conditions that were supplied. If validation fails an
+      # exception will be raised.
+      #
+      # @example Find or create the document.
+      #   Person.find_or_create_by!(:attribute => "value")
+      #
+      # @param [ Hash ] attrs The attributes to check.
+      #
+      # @raise [ Errors::Validations ] on validation error.
+      #
+      # @return [ Document ] A matching or newly created document.
+      def find_or_create_by!(attrs = {}, &block)
+        find_or(:create!, attrs, &block)
+      end
+
       # Find the first +Document+ given the conditions, or initializes a new document
       # with the conditions that were supplied.
       #
@@ -144,13 +160,17 @@ module Mongoid
       #
       # @since 3.0.0
       def create_document(method, attrs = nil, &block)
-        klass.__send__(method,
-          selector.reduce(attrs || {}) do |hash, (key, value)|
-            unless key.to_s =~ /\$/ || value.is_a?(Hash)
-              hash[key] = value
-            end
-            hash
-          end, &block)
+        attributes = selector.reduce(attrs || {}) do |hash, (key, value)|
+          unless key.to_s =~ /\$/ || value.is_a?(Hash)
+            hash[key] = value
+          end
+          hash
+        end
+        if embedded?
+          attributes[:_parent] = parent_document
+          attributes[:__metadata] = metadata
+        end
+        klass.__send__(method, attributes, &block)
       end
 
       # Find the first object or create/initialize it.

data/lib/mongoid/criteria/permission.rb

@@ -0,0 +1,70 @@
+# encoding: utf-8
+module Mongoid
+  class Criteria
+    module Permission
+
+      [:all,
+       :all_in,
+       :and,
+       :all_of,
+       :between,
+       :elem_match,
+       :exists,
+       :gt,
+       :gte,
+       :in,
+       :any_in,
+       :lt,
+       :lte,
+       :max_distance,
+       :mod,
+       :ne,
+       :excludes,
+       :near,
+       :near_sphere,
+       :nin,
+       :not_in,
+       :nor,
+       :negating?,
+       :not,
+       :or,
+       :any_of,
+       :with_size,
+       :with_type,
+       :where,
+       :within_box,
+       :within_circle,
+       :within_polygon,
+       :within_spherical_circle
+      ].each do |method|
+        define_method(method) do |*criteria|
+          raise Errors::CriteriaNotPermitted.new(klass, method, criteria) unless should_permit?(criteria)
+          super(*criteria)
+        end
+      end
+
+      private
+
+      # Ensure that the criteria are permitted.
+      #
+      # @example Ignoring ActionController::Parameters
+      #   should_permit?({_id: ActionController::Parameters.new("$size" => 1)})
+      #
+      # @api private
+      #
+      # @param [ Object ] criteria
+      # @return [ Boolean ] if should permit
+      def should_permit?(criteria)
+        if criteria.respond_to?(:permitted?)
+          return criteria.permitted?
+        elsif criteria.respond_to?(:each)
+          criteria.each do |criterion|
+            return false unless should_permit?(criterion)
+          end
+        end
+
+        true
+      end
+    end
+  end
+end

data/lib/mongoid/{criterion/scoping.rb → criteria/scopable.rb}

@@ -1,7 +1,7 @@
 # encoding: utf-8
 module Mongoid
-  module Criterion
-    module Scoping
+  class Criteria
+    module Scopable
 
       # Applies the default scope to the criteria.
       #

data/lib/mongoid/criteria.rb

@@ -1,9 +1,10 @@
 # encoding: utf-8
-require "mongoid/criterion/inspection"
-require "mongoid/criterion/findable"
-require "mongoid/criterion/marshalable"
-require "mongoid/criterion/modifiable"
-require "mongoid/criterion/scoping"
+require "mongoid/criteria/findable"
+require "mongoid/criteria/inspectable"
+require "mongoid/criteria/marshalable"
+require "mongoid/criteria/modifiable"
+require "mongoid/criteria/scopable"
+require "mongoid/sessions/options"
 
 module Mongoid
 
@@ -17,11 +18,12 @@ module Mongoid
     include Enumerable
     include Contextual
     include Origin::Queryable
-    include Criterion::Inspection
-    include Criterion::Findable
-    include Criterion::Marshalable
-    include Criterion::Modifiable
-    include Criterion::Scoping
+    include Findable
+    include Inspectable
+    include Marshalable
+    include Modifiable
+    include Scopable
+    include Sessions::Options
 
     # Static array used to check with method missing - we only need to ever
     # instantiate once.
@@ -29,7 +31,7 @@ module Mongoid
     # @since 4.0.0
     CHECK = []
 
-    attr_accessor :embedded, :klass
+    attr_accessor :embedded, :klass, :parent_document, :metadata
 
     # Returns true if the supplied +Enumerable+ or +Criteria+ is equal to the results
     # of this +Criteria+ or the criteria itself.
@@ -197,9 +199,6 @@ module Mongoid
     # into the identity map who's ids match based on the extra query for the
     # ids.
     #
-    # @note This will only work if Mongoid's identity map is enabled. To do
-    #   so set identity_map_enabled: true in your mongoid.yml
-    #
     # @note This will work for embedded relations that reference another
     #   collection via belongs_to as well.
     #
@@ -298,6 +297,31 @@ module Mongoid
       self
     end
 
+    # Returns a criteria that will always contain zero results and never hits
+    # the database.
+    #
+    # @example Return a none criteria.
+    #   criteria.none
+    #
+    # @return [ Criteria ] The none criteria.
+    #
+    # @since 4.0.0
+    def none
+      @none = true and self
+    end
+
+    # Is the criteria an empty but chainable criteria?
+    #
+    # @example Is the criteria a none criteria?
+    #   criteria.empty_and_chainable?
+    #
+    # @return [ true, false ] If the criteria is a none.
+    #
+    # @since 4.0.0
+    def empty_and_chainable?
+      !!@none
+    end
+
     # Overriden to include _type in the fields.
     #
     # @example Limit the fields returned from the database.
@@ -396,25 +420,6 @@ module Mongoid
       super
     end
 
-    # Tell the next persistance operation to query from a specific collection,
-    # database or session.
-    #
-    # @example Send the criteria to another collection.
-    #   Band.where(name: "Depeche Mode").with(collection: "artists")
-    #
-    # @param [ Hash ] options The storage options.
-    #
-    # @option options [ String, Symbol ] :collection The collection name.
-    # @option options [ String, Symbol ] :database The database name.
-    # @option options [ String, Symbol ] :session The session name.
-    #
-    # @return [ Criteria ] The criteria.
-    #
-    # @since 3.0.0
-    def with(options)
-      Threaded.set_persistence_options(klass, options)
-      self
-    end
 
     # Get a version of this criteria without the options.
     #
@@ -445,7 +450,7 @@ module Mongoid
     #
     # @since 3.1.0
     def for_js(javascript, scope = {})
-      js_query(Moped::BSON::Code.new(javascript, scope))
+      js_query(BSON::CodeWithScope.new(javascript, scope))
     end
 
     private

data/lib/mongoid/document.rb

@@ -1,13 +1,30 @@
 # encoding: utf-8
+require "mongoid/positional"
+require "mongoid/evolvable"
+require "mongoid/extensions"
+require "mongoid/errors"
+require "mongoid/threaded"
+require "mongoid/relations"
+require "mongoid/atomic"
+require "mongoid/attributes"
+require "mongoid/contextual"
+require "mongoid/copyable"
+require "mongoid/equality"
+require "mongoid/criteria"
+require "mongoid/factory"
+require "mongoid/fields"
+require "mongoid/timestamps"
+require "mongoid/composable"
+
 module Mongoid
 
   # This is the base module for all domain objects that need to be persisted to
   # the database as documents.
   module Document
     extend ActiveSupport::Concern
-    include Mongoid::Components
+    include Composable
 
-    attr_accessor :criteria_instance_id
+    attr_accessor :__selected_fields
     attr_reader :new_record
 
     included do
@@ -56,7 +73,7 @@ module Mongoid
 
     # A Document's is identified absolutely by its class and database id:
     #
-    # Person.first.identity #=> [Person, Moped::BSON::ObjectId('4f775130a04745933a000003')]
+    # Person.first.identity #=> [Person, BSON::ObjectId('4f775130a04745933a000003')]
     #
     # @example Get the identity
     #   document.identity
@@ -73,25 +90,24 @@ module Mongoid
     # an empty +Hash+.
     #
     # If a primary key is defined, the document's id will be set to that key,
-    # otherwise it will be set to a fresh +Moped::BSON::ObjectId+ string.
+    # otherwise it will be set to a fresh +BSON::ObjectId+ string.
     #
     # @example Create a new document.
     #   Person.new(:title => "Sir")
     #
     # @param [ Hash ] attrs The attributes to set up the document with.
-    # @param [ Hash ] options A mass-assignment protection options. Supports
-    #   :as and :without_protection
     #
     # @return [ Document ] A new document.
     #
     # @since 1.0.0
-    def initialize(attrs = nil, options = nil)
+    def initialize(attrs = nil)
       _building do
         @new_record = true
         @attributes ||= {}
-        options ||= {}
+        with(self.class.persistence_options)
         apply_pre_processed_defaults
-        process_attributes(attrs, options[:as] || :default, !options[:without_protection]) do
+        apply_default_scoping
+        process_attributes(attrs) do
           yield(self) if block_given?
         end
         apply_post_processed_defaults
@@ -182,10 +198,11 @@ module Mongoid
         raise ArgumentError, "A class which includes Mongoid::Document is expected"
       end
 
-      became = klass.new(clone_document, without_protection: true)
+      became = klass.new(clone_document)
       became.id = id
       became.instance_variable_set(:@changed_attributes, changed_attributes)
-      became.instance_variable_set(:@errors, errors)
+      became.instance_variable_set(:@errors, ActiveModel::Errors.new(became))
+      became.errors.instance_variable_set(:@messages, errors.instance_variable_get(:@messages))
       became.instance_variable_set(:@new_record, new_record?)
       became.instance_variable_set(:@destroyed, destroyed?)
       became.changed_attributes["_type"] = self.class.to_s
@@ -201,7 +218,6 @@ module Mongoid
         end
       end
 
-      IdentityMap.set(became) unless became.new_record?
       became
     end
 
@@ -284,19 +300,18 @@ module Mongoid
       #   Person.instantiate(:title => "Sir", :age => 30)
       #
       # @param [ Hash ] attrs The hash of attributes to instantiate with.
-      # @param [ Integer ] criteria_instance_id The criteria id that
-      #   instantiated the document.
+      # @param [ Integer ] selected_fields The selected fields from the
+      #   criteria.
       #
       # @return [ Document ] A new document.
       #
       # @since 1.0.0
-      def instantiate(attrs = nil, criteria_instance_id = nil)
+      def instantiate(attrs = nil, selected_fields = nil)
         attributes = attrs || {}
         doc = allocate
-        doc.criteria_instance_id = criteria_instance_id
+        doc.__selected_fields = selected_fields
         doc.instance_variable_set(:@attributes, attributes)
         doc.apply_defaults
-        IdentityMap.set(doc) unless _loading_revision?
         yield(doc) if block_given?
         doc.run_callbacks(:find) unless doc._find_callbacks.empty?
         doc.run_callbacks(:initialize) unless doc._initialize_callbacks.empty?

data/lib/mongoid/errors/document_not_destroyed.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # Raised when attempting to destroy a document that had destory callbacks
+    # return false.
+    #
+    # @since 4.0.0
+    class DocumentNotDestroyed < MongoidError
+
+      # Instnatiate the exception.
+      #
+      # @example Create the error.
+      #   DocumentNotDestroyed.new(Band)
+      #
+      # @param [ Object ] id The document id.
+      # @param [ Class ] klass The document class.
+      #
+      # @since 4.0.0
+      def initialize(id, klass)
+        super(compose_message("document_not_destroyed", { id: id.inspect, klass: klass }))
+      end
+    end
+  end
+end

data/lib/mongoid/errors/document_not_found.rb

@@ -22,8 +22,9 @@ module Mongoid
       # @param [ Array ] unmatched The unmatched ids, if appropriate
       def initialize(klass, params, unmatched = nil)
         if !unmatched && !params.is_a?(Hash)
-          raise ArgumentError, 'please also supply the unmatched ids'
+          unmatched = Array(params)
         end
+
         @klass, @params = klass, params
         super(
           compose_message(

data/lib/mongoid/errors/invalid_storage_options.rb

@@ -8,7 +8,7 @@ module Mongoid
       # Create the new error.
       #
       # @example Create the new error.
-      #   InvalidStorageOptions.new(:collection_name)
+      #   InvalidStorageOptions.new(Person, invalid_option: 'name')
       #
       # @param [ Class ] klass The model class.
       # @param [ Hash, String, Symbol ] options The provided options.

data/lib/mongoid/errors/invalid_storage_parent.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # Raised when calling store_in in a sub-class of Mongoid::Document
+    class InvalidStorageParent < MongoidError
+
+      # Create the new error.
+      #
+      # @example Create the new error.
+      #    InvalidStorageParent.new(Person)
+      #
+      # @param [ Class ] klass The model class.
+      #
+      # @since 4.0.0
+      def initialize(klass)
+        super(
+          compose_message(
+            "invalid_storage_parent",
+            { klass: klass }
+          )
+        )
+      end
+    end
+  end
+end

data/lib/mongoid/errors/invalid_value.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # This error is raised when trying to set an attribute with an invalid value.
+    # For example when try to set an Array value to a Hash attribute.
+    #
+    class InvalidValue < MongoidError
+      def initialize(field_class, value_class)
+        super(
+          compose_message("invalid_value", { value_class: value_class, field_class: field_class  })
+        )
+      end
+    end
+  end
+end

data/lib/mongoid/errors/mongoid_error.rb

@@ -40,7 +40,7 @@ module Mongoid
       #
       # @return [ String ] A localized error message string.
       def translate(key, options)
-        ::I18n.translate("#{BASE_KEY}.#{key}", { locale: :en }.merge(options))
+        ::I18n.translate("#{BASE_KEY}.#{key}", options)
       end
 
       # Create the problem.

data/lib/mongoid/errors/readonly_document.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # Raised when attempting to persist a document that was loaded from the
+    # database with partial fields.
+    #
+    # @since 4.0.0
+    class ReadonlyDocument < MongoidError
+
+      # Instnatiate the exception.
+      #
+      # @example Create the error.
+      #   ReadonlyDocument.new(Band)
+      #
+      # @param [ Class ] klass The document class.
+      #
+      # @since 4.0.0
+      def initialize(klass)
+        super(compose_message("readonly_document", { klass: klass }))
+      end
+    end
+  end
+end

data/lib/mongoid/errors.rb

@@ -2,6 +2,7 @@
 require "mongoid/errors/mongoid_error"
 require "mongoid/errors/ambiguous_relationship"
 require "mongoid/errors/callback"
+require "mongoid/errors/document_not_destroyed"
 require "mongoid/errors/document_not_found"
 require "mongoid/errors/eager_load"
 require "mongoid/errors/invalid_collection"
@@ -16,7 +17,9 @@ require "mongoid/errors/invalid_path"
 require "mongoid/errors/invalid_scope"
 require "mongoid/errors/invalid_set_polymorphic_relation"
 require "mongoid/errors/invalid_storage_options"
+require "mongoid/errors/invalid_storage_parent"
 require "mongoid/errors/invalid_time"
+require "mongoid/errors/invalid_value"
 require "mongoid/errors/inverse_not_found"
 require "mongoid/errors/mixed_relations"
 require "mongoid/errors/mixed_session_configuration"
@@ -31,11 +34,11 @@ 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/readonly_document"
 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/validations"
-require "mongoid/errors/versioning_not_on_root"
 require "mongoid/errors/delete_restriction"

data/lib/mongoid/extensions/array.rb

@@ -8,7 +8,7 @@ module Mongoid
       # @example Evolve the array to object ids.
       #   [ id ].__evolve_object_id__
       #
-      # @return [ Array<Moped::BSON::ObjectId> ] The converted array.
+      # @return [ Array<BSON::ObjectId> ] The converted array.
       #
       # @since 3.0.0
       def __evolve_object_id__
@@ -33,7 +33,7 @@ module Mongoid
       # @example Evolve the array to object ids.
       #   [ id ].__mongoize_object_id__
       #
-      # @return [ Array<Moped::BSON::ObjectId> ] The converted array.
+      # @return [ Array<BSON::ObjectId> ] The converted array.
       #
       # @since 3.0.0
       def __mongoize_object_id__
@@ -177,4 +177,4 @@ module Mongoid
 end
 
 ::Array.__send__(:include, Mongoid::Extensions::Array)
-::Array.__send__(:extend, Mongoid::Extensions::Array::ClassMethods)
+::Array.extend(Mongoid::Extensions::Array::ClassMethods)

data/lib/mongoid/extensions/big_decimal.rb

@@ -66,4 +66,4 @@ module Mongoid
 end
 
 ::BigDecimal.__send__(:include, Mongoid::Extensions::BigDecimal)
-::BigDecimal.__send__(:extend, Mongoid::Extensions::BigDecimal::ClassMethods)
+::BigDecimal.extend(Mongoid::Extensions::BigDecimal::ClassMethods)

data/lib/mongoid/extensions/boolean.rb

@@ -1,24 +1,22 @@
 # encoding: utf-8
 module Mongoid
-  module Extensions
-    module Boolean
-      module ClassMethods
+  class Boolean
 
-        # 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
+    class << self
+
+      # 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)
+        ::Boolean.evolve(object)
       end
+      alias :evolve :mongoize
     end
   end
 end
-
-::Boolean.__send__(:extend, Mongoid::Extensions::Boolean::ClassMethods)

data/lib/mongoid/extensions/date.rb

@@ -74,4 +74,4 @@ module Mongoid
 end
 
 ::Date.__send__(:include, Mongoid::Extensions::Date)
-::Date.__send__(:extend, Mongoid::Extensions::Date::ClassMethods)
+::Date.extend(Mongoid::Extensions::Date::ClassMethods)

data/lib/mongoid/extensions/date_time.rb

@@ -12,9 +12,9 @@ module Mongoid
       #
       # @since 3.0.0
       def __mongoize_time__
-        return self if utc? && Mongoid.use_utc?
+        return to_time if utc? && Mongoid.use_utc?
         if Mongoid.use_activesupport_time_zone?
-          in_time_zone(::Time.zone)
+          in_time_zone(::Time.zone).to_time
         else
           time = to_time
           time.respond_to?(:getlocal) ? time.getlocal : time
@@ -70,4 +70,4 @@ module Mongoid
 end
 
 ::DateTime.__send__(:include, Mongoid::Extensions::DateTime)
-::DateTime.__send__(:extend, Mongoid::Extensions::DateTime::ClassMethods)
+::DateTime.extend(Mongoid::Extensions::DateTime::ClassMethods)

data/lib/mongoid/extensions/float.rb

@@ -47,10 +47,11 @@ module Mongoid
             nil
           end
         end
+        alias :demongoize :mongoize
       end
     end
   end
 end
 
 ::Float.__send__(:include, Mongoid::Extensions::Float)
-::Float.__send__(:extend, Mongoid::Extensions::Float::ClassMethods)
+::Float.extend(Mongoid::Extensions::Float::ClassMethods)

data/lib/mongoid/extensions/hash.rb

@@ -40,7 +40,7 @@ module Mongoid
         each_pair do |key, value|
           if key =~ /\$/
             value.each_pair do |_key, _value|
-              value[_key] = mongoize_for(key, klass, _key, _value)
+              value[_key] = (key == "$rename") ? _value.to_s : mongoize_for(key, klass, _key, _value)
             end
             (consolidated[key] ||= {}).merge!(value)
           else
@@ -170,7 +170,7 @@ module Mongoid
         field = klass.fields[key.to_s]
         if field
           val = field.mongoize(value)
-          if Mongoid::Persistence::LIST_OPERATIONS.include?(operator) && field.resizable?
+          if Mongoid::Persistable::LIST_OPERATIONS.include?(operator) && field.resizable?
             val = val.first if !value.is_a?(Array)
           end
           val
@@ -214,4 +214,4 @@ module Mongoid
 end
 
 ::Hash.__send__(:include, Mongoid::Extensions::Hash)
-::Hash.__send__(:extend, Mongoid::Extensions::Hash::ClassMethods)
+::Hash.extend(Mongoid::Extensions::Hash::ClassMethods)

data/lib/mongoid/extensions/integer.rb

@@ -64,4 +64,4 @@ module Mongoid
 end
 
 ::Integer.__send__(:include, Mongoid::Extensions::Integer)
-::Integer.__send__(:extend, Mongoid::Extensions::Integer::ClassMethods)
+::Integer.extend(Mongoid::Extensions::Integer::ClassMethods)