mongoid 4.0.2 → 5.0.0.beta

data/lib/mongoid/{sessions → clients}/thread_options.rb

@@ -1,14 +1,17 @@
 # encoding: utf-8
 module Mongoid
-  module Sessions
+  module Clients
     module ThreadOptions
       extend ActiveSupport::Concern
 
       module ClassMethods
+        extend Gem::Deprecate
 
-        def session_name
-          Threaded.session_override || super
+        def client_name
+          Threaded.client_override || super
         end
+        alias :session_name :client_name
+        deprecate :session_name, :client_name, 2015, 12
 
         def database_name
           Threaded.database_override || super

data/lib/mongoid/clients/validators.rb

@@ -0,0 +1,2 @@
+# encoding: utf-8
+require "mongoid/clients/validators/storage"

data/lib/mongoid/{sessions → clients}/validators/storage.rb

@@ -1,13 +1,16 @@
 # encoding: utf-8
 module Mongoid
-  module Sessions
+  module Clients
     module Validators
 
       # Validates the options passed to :store_in.
       module Storage
         extend self
 
-        VALID_OPTIONS = [ :collection, :database, :session ]
+        # The valid options for storage.
+        #
+        # @since 3.0.0
+        VALID_OPTIONS = [ :collection, :database, :client ].freeze
 
         # Validate the options provided to :store_in.
         #

data/lib/mongoid/composable.rb

@@ -35,6 +35,7 @@ module Mongoid
     include ActiveModel::Serializers::Xml
     include Atomic
     include Changeable
+    include Clients
     include Attributes
     include Evolvable
     include Fields
@@ -47,7 +48,6 @@ module Mongoid
     include Scopable
     include Selectable
     include Serializable
-    include Sessions
     include Shardable
     include Stateful
     include Threaded::Lifecycle
@@ -73,7 +73,7 @@ module Mongoid
       Reloadable,
       Scopable,
       Serializable,
-      Sessions,
+      Clients,
       Shardable,
       Stateful,
       Threaded::Lifecycle,
@@ -97,7 +97,7 @@ module Mongoid
       # @since 2.1.8
       def prohibited_methods
         @prohibited_methods ||= MODULES.flat_map do |mod|
-          mod.instance_methods.map{ |m| m.to_sym }
+          mod.instance_methods.map(&:to_sym)
         end
       end
     end

data/lib/mongoid/config.rb

@@ -8,6 +8,7 @@ module Mongoid
   # This module defines all the configuration options for Mongoid, including the
   # database connections.
   module Config
+    extend Gem::Deprecate
     extend self
     extend Options
 
@@ -26,7 +27,7 @@ module Mongoid
     option :use_utc, default: false
 
     # Has Mongoid been configured? This is checking that at least a valid
-    # session config exists.
+    # client config exists.
     #
     # @example Is Mongoid configured?
     #   config.configured?
@@ -35,10 +36,10 @@ module Mongoid
     #
     # @since 3.0.9
     def configured?
-      sessions.has_key?(:default)
+      clients.key?(:default)
     end
 
-    # Connect to the provided database name on the default session.
+    # Connect to the provided database name on the default client.
     #
     # @note Use only in development or test environments for convenience.
     #
@@ -48,8 +49,8 @@ module Mongoid
     # @param [ String ] name The database name.
     #
     # @since 3.0.0
-    def connect_to(name, options = { read: :primary })
-      self.sessions = {
+    def connect_to(name, options = { read: { mode: :primary }})
+      self.clients = {
         default: {
           database: name,
           hosts: [ "localhost:27017" ],
@@ -82,8 +83,8 @@ module Mongoid
     def load!(path, environment = nil)
       settings = Environment.load_yaml(path, environment)
       if settings.present?
-        Sessions.disconnect
-        Sessions.clear
+        Clients.disconnect
+        Clients.clear
         load_configuration(settings)
       end
       settings
@@ -127,7 +128,7 @@ module Mongoid
     def load_configuration(settings)
       configuration = settings.with_indifferent_access
       self.options = configuration[:options]
-      self.sessions = configuration[:sessions]
+      self.clients = configuration[:clients]
     end
 
     # Override the database to use globally.
@@ -144,19 +145,21 @@ module Mongoid
       Threaded.database_override = name
     end
 
-    # Override the session to use globally.
+    # Override the client to use globally.
     #
-    # @example Override the session globally.
-    #   config.override_session(:optional)
+    # @example Override the client globally.
+    #   config.override_client(:optional)
     #
-    # @param [ String, Symbol ] name The name of the session.
+    # @param [ String, Symbol ] name The name of the client.
     #
     # @return [ String, Symbol ] The global override.
     #
     # @since 3.0.0
-    def override_session(name)
-      Threaded.session_override = name ? name.to_s : nil
+    def override_client(name)
+      Threaded.client_override = name ? name.to_s : nil
     end
+    alias :override_session :override_client
+    deprecate :override_session, :override_client, 2015, 12
 
     # Purge all data in all collections, including indexes.
     #
@@ -169,9 +172,7 @@ module Mongoid
     #
     # @since 2.0.2
     def purge!
-      Sessions.default.collections.each do |collection|
-        collection.drop
-      end and true
+      Clients.default.database.collections.each(&:drop) and true
     end
 
     # Truncate all data in all collections, but not the indexes.
@@ -185,8 +186,8 @@ module Mongoid
     #
     # @since 2.0.2
     def truncate!
-      Sessions.default.collections.each do |collection|
-        collection.find.remove_all
+      Clients.default.database.collections.each do |collection|
+        collection.find.delete_many
       end and true
     end
 
@@ -207,33 +208,19 @@ module Mongoid
       end
     end
 
-    # Get the session configuration or an empty hash.
-    #
-    # @example Get the sessions configuration.
-    #   config.sessions
-    #
-    # @return [ Hash ] The sessions configuration.
-    #
-    # @since 3.0.0
-    def sessions
-      @sessions ||= {}
-    end
-
-    # Set the session configuration options.
+    # Get the client configuration or an empty hash.
     #
-    # @example Set the session configuration options.
-    #   config.sessions = { default: { hosts: [ "localhost:27017" ] }}
+    # @example Get the clients configuration.
+    #   config.clients
     #
-    # @param [ Hash ] sessions The configuration options.
+    # @return [ Hash ] The clients configuration.
     #
     # @since 3.0.0
-    def sessions=(sessions)
-      raise Errors::NoSessionsConfig.new unless sessions
-      sess = sessions.with_indifferent_access
-      Validators::Session.validate(sess)
-      @sessions = sess
-      sess
+    def clients
+      @clients ||= {}
     end
+    alias :sessions :clients
+    deprecate :sessions, :clients, 2015, 12
 
     # Get the time zone to use.
     #
@@ -258,5 +245,16 @@ module Mongoid
     def running_with_passenger?
       @running_with_passenger ||= defined?(PhusionPassenger)
     end
+
+    private
+
+    def clients=(clients)
+      raise Errors::NoClientsConfig.new unless clients
+      c = clients.with_indifferent_access
+      Validators::Client.validate(c)
+      @clients = c
+    end
+    alias :sessions= :clients=
+    deprecate :sessions=, :clients=, 2015, 12
   end
 end

data/lib/mongoid/config/environment.rb

@@ -19,7 +19,7 @@ module Mongoid
       #
       # @since 2.3.0
       def env_name
-        return Rails.env if defined?(Rails)
+        return Rails.env if defined?(Rails) && Rails.respond_to?(:env)
         return Sinatra::Base.environment.to_s if defined?(Sinatra)
         ENV["RACK_ENV"] || ENV["MONGOID_ENV"] || raise(Errors::NoEnvironment.new)
       end

data/lib/mongoid/config/validators.rb

@@ -1,3 +1,3 @@
 # encoding: utf-8
 require "mongoid/config/validators/option"
-require "mongoid/config/validators/session"
+require "mongoid/config/validators/client"

data/lib/mongoid/config/validators/{session.rb → client.rb}

@@ -3,82 +3,85 @@ module Mongoid
   module Config
     module Validators
 
-      # Validator for session specific configuration.
-      module Session
+      # Validator for client specific configuration.
+      module Client
         extend self
 
-        STANDARD = [ :database, :hosts, :username, :password ]
+        # Standard configuration options.
+        #
+        # @since 3.0.0
+        STANDARD = [ :database, :hosts, :username, :password ].freeze
 
-        # Validate the session configuration.
+        # Validate the client configuration.
         #
-        # @example Validate the session config.
-        #   Session.validate({ default: { hosts: [ "localhost:27017" ] }})
+        # @example Validate the client config.
+        #   Client.validate({ default: { hosts: [ "localhost:27017" ] }})
         #
-        # @param [ Hash ] sessions The sessions config.
+        # @param [ Hash ] clients The clients config.
         #
         # @since 3.0.0
-        def validate(sessions)
-          unless sessions.has_key?(:default)
-            raise Errors::NoDefaultSession.new(sessions.keys)
+        def validate(clients)
+          unless clients.has_key?(:default)
+            raise Errors::NoDefaultClient.new(clients.keys)
           end
-          sessions.each_pair do |name, config|
-            validate_session_database(name, config)
-            validate_session_hosts(name, config)
-            validate_session_uri(name, config)
+          clients.each_pair do |name, config|
+            validate_client_database(name, config)
+            validate_client_hosts(name, config)
+            validate_client_uri(name, config)
           end
         end
 
         private
 
-        # Validate that the session config has database.
+        # Validate that the client config has database.
         #
         # @api private
         #
-        # @example Validate the session has database.
-        #   validator.validate_session_database(:default, {})
+        # @example Validate the client has database.
+        #   validator.validate_client_database(:default, {})
         #
         # @param [ String, Symbol ] name The config key.
         # @param [ Hash ] config The configuration.
         #
         # @since 3.0.0
-        def validate_session_database(name, config)
+        def validate_client_database(name, config)
           if no_database_or_uri?(config)
-            raise Errors::NoSessionDatabase.new(name, config)
+            raise Errors::NoClientDatabase.new(name, config)
           end
         end
 
-        # Validate that the session config has hosts.
+        # Validate that the client config has hosts.
         #
         # @api private
         #
-        # @example Validate the session has hosts.
-        #   validator.validate_session_hosts(:default, {})
+        # @example Validate the client has hosts.
+        #   validator.validate_client_hosts(:default, {})
         #
         # @param [ String, Symbol ] name The config key.
         # @param [ Hash ] config The configuration.
         #
         # @since 3.0.0
-        def validate_session_hosts(name, config)
+        def validate_client_hosts(name, config)
           if no_hosts_or_uri?(config)
-            raise Errors::NoSessionHosts.new(name, config)
+            raise Errors::NoClientHosts.new(name, config)
           end
         end
 
         # Validate that not both a uri and standard options are provided for a
-        # single session.
+        # single client.
         #
         # @api private
         #
         # @example Validate the uri and options.
-        #   validator.validate_session_uri(:default, {})
+        #   validator.validate_client_uri(:default, {})
         #
         # @param [ String, Symbol ] name The config key.
         # @param [ Hash ] config The configuration.
         #
         # @since 3.0.0
-        def validate_session_uri(name, config)
+        def validate_client_uri(name, config)
           if both_uri_and_standard?(config)
-            raise Errors::MixedSessionConfiguration.new(name, config)
+            raise Errors::MixedClientConfiguration.new(name, config)
           end
         end
 

data/lib/mongoid/contextual/aggregable/mongo.rb

@@ -23,7 +23,7 @@ module Mongoid
         #
         # @since 3.0.0
         def aggregates(field)
-          result = collection.aggregate(pipeline(field)).to_a
+          result = collection.find.aggregate(pipeline(field)).to_a
           if result.empty?
             { "count" => 0, "sum" => nil, "avg" => nil, "min" => nil, "max" => nil }
           else

data/lib/mongoid/contextual/atomic.rb

@@ -14,7 +14,7 @@ module Mongoid
       #
       # @since 3.0.0
       def add_to_set(adds)
-        query.update_all("$addToSet" => collect_operations(adds))
+        view.update_many("$addToSet" => collect_operations(adds))
       end
 
       # Perform an atomic $bit operation on the matching documents.
@@ -28,7 +28,7 @@ module Mongoid
       #
       # @since 3.0.0
       def bit(bits)
-        query.update_all("$bit" => collect_operations(bits))
+        view.update_many("$bit" => collect_operations(bits))
       end
 
       # Perform an atomic $inc operation on the matching documents.
@@ -42,7 +42,7 @@ module Mongoid
       #
       # @since 3.0.0
       def inc(incs)
-        query.update_all("$inc" => collect_operations(incs))
+        view.update_many("$inc" => collect_operations(incs))
       end
 
       # Perform an atomic $pop operation on the matching documents.
@@ -59,7 +59,7 @@ module Mongoid
       #
       # @since 3.0.0
       def pop(pops)
-        query.update_all("$pop" => collect_operations(pops))
+        view.update_many("$pop" => collect_operations(pops))
       end
 
       # Perform an atomic $pull operation on the matching documents.
@@ -75,7 +75,7 @@ module Mongoid
       #
       # @since 3.0.0
       def pull(pulls)
-        query.update_all("$pull" => collect_operations(pulls))
+        view.update_many("$pull" => collect_operations(pulls))
       end
 
       # Perform an atomic $pullAll operation on the matching documents.
@@ -89,7 +89,7 @@ module Mongoid
       #
       # @since 3.0.0
       def pull_all(pulls)
-        query.update_all("$pullAll" => collect_operations(pulls))
+        view.update_many("$pullAll" => collect_operations(pulls))
       end
 
       # Perform an atomic $push operation on the matching documents.
@@ -103,7 +103,7 @@ module Mongoid
       #
       # @since 3.0.0
       def push(pushes)
-        query.update_all("$push" => collect_operations(pushes))
+        view.update_many("$push" => collect_operations(pushes))
       end
 
       # Perform an atomic $pushAll operation on the matching documents.
@@ -117,7 +117,7 @@ module Mongoid
       #
       # @since 3.0.0
       def push_all(pushes)
-        query.update_all("$pushAll" => collect_operations(pushes))
+        view.update_many("$pushAll" => collect_operations(pushes))
       end
 
       # Perform an atomic $rename of fields on the matching documents.
@@ -135,7 +135,7 @@ module Mongoid
           ops[old_name] = new_name.to_s
           ops
         end
-        query.update_all("$rename" => collect_operations(operations))
+        view.update_many("$rename" => collect_operations(operations))
       end
 
       # Perform an atomic $set of fields on the matching documents.
@@ -149,7 +149,7 @@ module Mongoid
       #
       # @since 3.0.0
       def set(sets)
-        query.update_all("$set" => collect_operations(sets))
+        view.update_many("$set" => collect_operations(sets))
       end
 
       # Perform an atomic $unset of a field on the matching documents.
@@ -164,7 +164,7 @@ module Mongoid
       # @since 3.0.0
       def unset(*args)
         fields = args.__find_args__.collect { |f| [database_field_name(f), true] }
-        query.update_all("$unset" => Hash[fields])
+        view.update_many("$unset" => Hash[fields])
       end
 
       private