mongoid 4.0.2 → 5.0.0.beta

data/lib/mongoid/contextual/none.rb

@@ -51,6 +51,19 @@ module Mongoid
       # @since 4.0.0
       def exists?; false; end
 
+
+      # Allow pluck for null context.
+      #
+      # @example Allow pluck for null context.
+      #   context.pluck(:name)
+      #
+      # @param [ String, Symbol, Array ] field or fields to pluck.
+      #
+      # @return [ Array ] Emtpy Array
+      def pluck(*args)
+        []
+      end
+
       # Create the new null context.
       #
       # @example Create the new context.

data/lib/mongoid/copyable.rb

@@ -22,7 +22,12 @@ module Mongoid
       # _id and id field in the document would cause problems with Mongoid
       # elsewhere.
       attrs = clone_document.except("_id", "id")
-      self.class.new(attrs)
+      begin
+        self.class.new(attrs)
+      rescue Errors::UnknownAttribute
+        self.class.send(:include, Attributes::Dynamic)
+        self.class.new(attrs)
+      end
     end
     alias :dup :clone
 

data/lib/mongoid/criteria.rb

@@ -4,7 +4,6 @@ require "mongoid/criteria/inspectable"
 require "mongoid/criteria/marshalable"
 require "mongoid/criteria/modifiable"
 require "mongoid/criteria/scopable"
-require "mongoid/sessions/options"
 
 module Mongoid
 
@@ -23,7 +22,7 @@ module Mongoid
     include Marshalable
     include Modifiable
     include Scopable
-    include Sessions::Options
+    include Clients::Options
 
     # Static array used to check with method missing - we only need to ever
     # instantiate once.
@@ -293,7 +292,7 @@ module Mongoid
       options.merge!(criteria.options)
       self.documents = criteria.documents.dup unless criteria.documents.empty?
       self.scoping_options = criteria.scoping_options
-      self.inclusions = (inclusions + criteria.inclusions.dup).uniq
+      self.inclusions = (inclusions + criteria.inclusions).uniq
       self
     end
 
@@ -335,6 +334,9 @@ module Mongoid
     def only(*args)
       return clone if args.flatten.empty?
       args = args.flatten
+      if (args & Fields::IDS).empty?
+        args.unshift(:_id)
+      end
       if klass.hereditary?
         super(*args.push(:_type))
       else
@@ -342,6 +344,37 @@ module Mongoid
       end
     end
 
+    # Set the read preference for the criteria.
+    #
+    # @example Set the read preference.
+    #   criteria.read(mode: :primary_preferred)
+    #
+    # @param [ Hash ] value The mode preference.
+    #
+    # @return [ Criteria ] The cloned criteria.
+    #
+    # @since 5.0.0
+    def read(value = nil)
+      clone.tap do |criteria|
+        criteria.options.merge!(read: value)
+      end
+    end
+
+    # Overriden to exclude _id from the fields.
+    #
+    # @example Exclude fields returned from the database.
+    #   Band.without(:name)
+    #
+    # @param [ Array<Symbol> ] args The names of the fields.
+    #
+    # @return [ Criteria ] The cloned criteria.
+    #
+    # @since 4.0.3
+    def without(*args)
+      args -= Fields::IDS
+      super(*args)
+    end
+
     # Returns true if criteria responds to the given method.
     #
     # @example Does the criteria respond to the method?

data/lib/mongoid/document.rb

@@ -1,5 +1,4 @@
 # encoding: utf-8
-require "mongoid/positional"
 require "mongoid/evolvable"
 require "mongoid/extensions"
 require "mongoid/errors"
@@ -168,7 +167,7 @@ module Mongoid
       embedded_relations.each_pair do |name, meta|
         without_autobuild do
           relation, stored = send(name), meta.store_as
-          if attributes.has_key?(stored) || !relation.blank?
+          if attributes.key?(stored) || !relation.blank?
             if relation
               attributes[stored] = relation.as_document
             else
@@ -262,7 +261,7 @@ module Mongoid
     #
     # @since 2.4.0
     def model_key
-      @model_cache_key ||= "#{self.class.model_name.cache_key}"
+      @model_cache_key ||= self.class.model_name.cache_key
     end
 
     # Implement this for calls to flatten on array.
@@ -327,7 +326,7 @@ module Mongoid
       #
       # @since 1.0.0
       def _types
-        @_type ||= (descendants + [ self ]).uniq.map { |t| t.to_s }
+        @_type ||= (descendants + [ self ]).uniq.map(&:to_s)
       end
 
       # Set the i18n scope to overwrite ActiveModel.

data/lib/mongoid/errors.rb

@@ -22,17 +22,17 @@ 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"
+require "mongoid/errors/mixed_client_configuration"
 require "mongoid/errors/nested_attributes_metadata_not_found"
-require "mongoid/errors/no_default_session"
+require "mongoid/errors/no_default_client"
 require "mongoid/errors/no_environment"
 require "mongoid/errors/no_map_reduce_output"
 require "mongoid/errors/no_metadata"
 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/no_client_config"
+require "mongoid/errors/no_clients_config"
+require "mongoid/errors/no_client_database"
+require "mongoid/errors/no_client_hosts"
 require "mongoid/errors/readonly_attribute"
 require "mongoid/errors/readonly_document"
 require "mongoid/errors/scope_overwrite"

data/lib/mongoid/errors/{mixed_session_configuration.rb → mixed_client_configuration.rb}

@@ -2,23 +2,23 @@
 module Mongoid
   module Errors
 
-    # This error is raised when a session configuration contains both a uri and
+    # This error is raised when a client configuration contains both a uri and
     # other standard options.
-    class MixedSessionConfiguration < MongoidError
+    class MixedClientConfiguration < MongoidError
 
       # Initialize the error.
       #
       # @example Initialize the error.
-      #   MixedSessionConfiguration.new(:name, {})
+      #   MixedClientConfiguration.new(:name, {})
       #
-      # @param [ Symbol ] name The name of the session config.
+      # @param [ Symbol ] name The name of the client config.
       # @param [ Hash ] config The configuration options.
       #
       # @since 3.0.0
       def initialize(name, config)
         super(
           compose_message(
-            "mixed_session_configuration",
+            "mixed_client_configuration",
             { name: name, config: config }
           )
         )

data/lib/mongoid/errors/no_client_config.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # This error is raised when attempting to create a new client that does
+    # not have a named configuration.
+    class NoClientConfig < MongoidError
+
+      # Create the new error.
+      #
+      # @example Create the error.
+      #   NoClientConfig.new(:secondary)
+      #
+      # @param [ String, Symbol ] name The name of the client.
+      #
+      # @since 3.0.0
+      def initialize(name)
+        super(compose_message("no_client_config", { name: name }))
+      end
+    end
+  end
+end

data/lib/mongoid/errors/{no_session_database.rb → no_client_database.rb}

@@ -2,13 +2,13 @@
 module Mongoid
   module Errors
 
-    # This error is raised when a session is configured without a database.
-    class NoSessionDatabase < MongoidError
+    # This error is raised when a client is configured without a database.
+    class NoClientDatabase < MongoidError
 
       # Create the new error.
       #
       # @example Create the new error.
-      #   NoSessionDatabase.new(:default, {}})
+      #   NoClientDatabase.new(:default, {}})
       #
       # @param [ Symbol, String ] name The db config key.
       # @param [ Hash ] config The hash configuration options.
@@ -17,7 +17,7 @@ module Mongoid
       def initialize(name, config)
         super(
           compose_message(
-            "no_session_database",
+            "no_client_database",
             { name: name, config: config }
           )
         )

data/lib/mongoid/errors/{no_session_hosts.rb → no_client_hosts.rb}

@@ -2,13 +2,13 @@
 module Mongoid
   module Errors
 
-    # This error is raised when a session is configured without hosts.
-    class NoSessionHosts < MongoidError
+    # This error is raised when a client is configured without hosts.
+    class NoClientHosts < MongoidError
 
       # Create the new error.
       #
       # @example Create the new error.
-      #   NoSessionHosts.new(:default, {}})
+      #   NoClientHosts.new(:default, {}})
       #
       # @param [ Symbol, String ] name The db config key.
       # @param [ Hash ] config The hash configuration options.
@@ -17,7 +17,7 @@ module Mongoid
       def initialize(name, config)
         super(
           compose_message(
-            "no_session_hosts",
+            "no_client_hosts",
             { name: name, config: config }
           )
         )

data/lib/mongoid/errors/{no_sessions_config.rb → no_clients_config.rb}

@@ -2,18 +2,18 @@
 module Mongoid
   module Errors
 
-    # This error is raised when no sessions exists in the database
+    # This error is raised when no clients exists in the database
     # configuration.
-    class NoSessionsConfig < MongoidError
+    class NoClientsConfig < MongoidError
 
       # Create the new error.
       #
       # @example Create the error.
-      #   NoSessionsConfig.new
+      #   NoClientsConfig.new
       #
       # @since 3.0.0
       def initialize
-        super(compose_message("no_sessions_config", {}))
+        super(compose_message("no_clients_config", {}))
       end
     end
   end

data/lib/mongoid/errors/no_default_client.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+module Mongoid
+  module Errors
+
+    # This error is raised when a default client is not defined.
+    class NoDefaultClient < MongoidError
+
+      # Create the new error with the defined client names.
+      #
+      # @example Create the new error.
+      #   NoDefaultClient.new([ :secondary ])
+      #
+      # @param [ Array<Symbol> ] keys The defined clients.
+      #
+      # @since 3.0.0
+      def initialize(keys)
+        super(
+          compose_message("no_default_client", { keys: keys.join(", ") })
+        )
+      end
+    end
+  end
+end

data/lib/mongoid/extensions/hash.rb

@@ -24,7 +24,11 @@ module Mongoid
       #
       # @since 3.0.0
       def __mongoize_object_id__
-        update_values(&:__mongoize_object_id__)
+        if id = self['$oid']
+          BSON::ObjectId.from_string(id)
+        else
+          update_values(&:__mongoize_object_id__)
+        end
       end
 
       # Consolidate the key/values in the hash under an atomic $set.

data/lib/mongoid/extensions/object.rb

@@ -115,8 +115,9 @@ module Mongoid
       #
       # @since 2.0.0.rc.1
       def ivar(name)
-        if instance_variable_defined?("@_#{name}")
-          return instance_variable_get("@_#{name}")
+        var_name = "@_#{name}"
+        if instance_variable_defined?(var_name)
+          return instance_variable_get(var_name)
         else
           false
         end

data/lib/mongoid/extensions/set.rb

@@ -9,7 +9,7 @@ module Mongoid
       # @example Mongoize the object.
       #   set.mongoize
       #
-      # @return [ Hash ] The object mongoized.
+      # @return [ Array ] The object mongoized.
       #
       # @since 3.0.0
       def mongoize
@@ -21,9 +21,9 @@ module Mongoid
         # Convert the object from its mongo friendly ruby type to this type.
         #
         # @example Demongoize the object.
-        #   Set.demongoize({ "min" => 1, "max" => 5 })
+        #   Set.demongoize([1, 2, 3])
         #
-        # @param [ Hash ] object The object to demongoize.
+        # @param [ Array ] object The object to demongoize.
         #
         # @return [ Set ] The set.
         #
@@ -36,11 +36,11 @@ module Mongoid
         # type.
         #
         # @example Mongoize the object.
-        #   Set.mongoize(1..3)
+        #   Set.mongoize(Set.new([1,2,3]))
         #
         # @param [ Set ] object The object to mongoize.
         #
-        # @return [ Hash ] The object mongoized.
+        # @return [ Array ] The object mongoized.
         #
         # @since 3.0.0
         def mongoize(object)

data/lib/mongoid/factory.rb

@@ -5,6 +5,8 @@ module Mongoid
   module Factory
     extend self
 
+    TYPE = "_type".freeze
+
     # Builds a new +Document+ from the supplied attributes.
     #
     # @example Build the document.
@@ -16,7 +18,7 @@ module Mongoid
     #
     # @return [ Document ] The instantiated document.
     def build(klass, attributes = nil)
-      type = (attributes || {})["_type"]
+      type = (attributes || {})[TYPE]
       if type && klass._types.include?(type)
         type.constantize.new(attributes)
       else
@@ -37,7 +39,7 @@ module Mongoid
     #
     # @return [ Document ] The instantiated document.
     def from_db(klass, attributes = nil, selected_fields = nil)
-      type = (attributes || {})["_type"]
+      type = (attributes || {})[TYPE]
       if type.blank?
         klass.instantiate(attributes, selected_fields)
       else

data/lib/mongoid/fields.rb

@@ -32,6 +32,11 @@ module Mongoid
       time: Time
     }.with_indifferent_access
 
+    # Constant for all names of the id field in a document.
+    #
+    # @since 5.0.0
+    IDS = [ :_id, :id, '_id', 'id' ].freeze
+
     included do
       class_attribute :aliased_fields
       class_attribute :localized_fields
@@ -93,7 +98,7 @@ module Mongoid
     #
     # @since 2.4.0
     def apply_default(name)
-      unless attributes.has_key?(name)
+      unless attributes.key?(name)
         if field = fields[name]
           default = field.eval_default(self)
           unless default.nil? || field.lazy?
@@ -358,7 +363,7 @@ module Mongoid
         field_options = field.options
 
         Fields.options.each_pair do |option_name, handler|
-          if field_options.has_key?(option_name)
+          if field_options.key?(option_name)
             handler.call(self, field, field_options[option_name])
           end
         end

data/lib/mongoid/findable.rb

@@ -19,7 +19,9 @@ module Mongoid
       :each,
       :each_with_index,
       :extras,
-      :find_and_modify,
+      :find_one_and_delete,
+      :find_one_and_replace,
+      :find_one_and_update,
       :find_or_create_by,
       :find_or_create_by!,
       :find_or_initialize_by,
@@ -34,6 +36,7 @@ module Mongoid
       :min,
       :none,
       :pluck,
+      :read,
       :sum,
       :text_search,
       :update,