mongo 1.12.5 → 2.0.0.beta

data/lib/mongo/operation/write/create_index.rb

@@ -0,0 +1,84 @@
+
+# Copyright (C) 2014-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Mongo
+  module Operation
+    module Write
+
+      # A MongoDB ensure index operation.
+      #
+      # @note If a server with version >= 2.5.5 is being used, a write command
+      #   operation will be created and sent instead.
+      #
+      # @example Create the ensure index operation.
+      #   Write::EnsureIndex.new({
+      #     :index => { :name => 1, :age => -1 },
+      #     :db_name => 'test',
+      #     :coll_name => 'test_coll',
+      #     :index_name => 'name_1_age_-1'
+      #   })
+      #
+      # @param [ Hash ] spec The specifications for the insert.
+      #
+      # @option spec :index [ Hash ] The index spec to create.
+      # @option spec :db_name [ String ] The name of the database.
+      # @option spec :coll_name [ String ] The name of the collection.
+      # @option spec :index_name [ String ] The name of the index.
+      # @option spec :options [ Hash ] Options for the command, if it ends up being a
+      #   write command.
+      #
+      # @since 2.0.0
+      class EnsureIndex
+        include Executable
+        include Specifiable
+
+        # Execute the ensure index operation.
+        #
+        # @example Execute the operation.
+        #   operation.execute(context)
+        #
+        # @params [ Mongo::Server::Context ] The context for this operation.
+        #
+        # @return [ Result ] The result of the operation.
+        #
+        # @since 2.0.0
+        def execute(context)
+          if context.features.write_command_enabled?
+            execute_write_command(context)
+          else
+            execute_message(context)
+          end
+        end
+
+        private
+
+        def execute_write_command(context)
+          Result.new(Command::CreateIndex.new(spec).execute(context)).validate!
+        end
+
+        def execute_message(context)
+          context.with_connection do |connection|
+            Result.new(connection.dispatch([ message, gle ].compact)).validate!
+          end
+        end
+
+        def message
+          document = options.merge(ns: namespace, key: index, name: index_name)
+          Protocol::Insert.new(db_name, Index::COLLECTION, [ document ])
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/write/create_user.rb

@@ -0,0 +1,75 @@
+
+# Copyright (C) 2014-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Mongo
+  module Operation
+    module Write
+
+      # A MongoDB create user operation.
+      #
+      # @example Initialize the operation.
+      #   Write::CreateUser.new(:db_name => 'test', :user => user)
+      #
+      # @param [ Hash ] spec The specifications for the create.
+      #
+      # @option spec :user [ Auth::User ] The user to create.
+      # @option spec :db_name [ String ] The name of the database.
+      #
+      # @since 2.0.0
+      class CreateUser
+        include Executable
+        include Specifiable
+
+        # Execute the operation.
+        #
+        # @note Creating users behaves different on 2.7+, 2.6.x, and
+        #   2.4- so we need to break this out into separate operations.
+        #
+        # @example Execute the operation.
+        #   operation.execute(context)
+        #
+        # @param [ Mongo::Server::Context ] The context for this operation.
+        #
+        # @return [ Result ] The operation result.
+        #
+        # @since 2.0.0
+        def execute(context)
+          if context.features.write_command_enabled?
+            execute_write_command(context)
+          else
+            execute_message(context)
+          end
+        end
+
+        private
+
+        def execute_write_command(context)
+          Result.new(Command::CreateUser.new(spec).execute(context)).validate!
+        end
+
+        def execute_message(context)
+          context.with_connection do |connection|
+            Result.new(connection.dispatch([ message, gle ].compact)).validate!
+          end
+        end
+
+        def message
+          user_spec = { user: user.name }.merge(user.spec)
+          Protocol::Insert.new(db_name, Auth::User::COLLECTION, [ user_spec ])
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/write/delete.rb

@@ -0,0 +1,91 @@
+# Copyright (C) 2014-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Mongo
+  module Operation
+    module Write
+
+      # A MongoDB delete operation.
+      #
+      # @note If a server with version >= 2.5.5 is selected, a write command
+      #   operation will be created and sent instead.
+      #
+      # @example Create the delete operation.
+      #   Write::Delete.new({
+      #     :delete => { :q => { :foo => 1 }, :limit => 1 },
+      #     :db_name => 'test',
+      #     :coll_name => 'test_coll',
+      #     :write_concern => write_concern
+      #   })
+      #
+      # @param [ Hash ] spec The specifications for the delete.
+      #
+      # @option spec :delete [ Hash ] The delete document.
+      # @option spec :db_name [ String ] The name of the database on which
+      #   the delete should be executed.
+      # @option spec :coll_name [ String ] The name of the collection on which
+      #   the delete should be executed.
+      # @option spec :write_concern [ Mongo::WriteConcern ] The write concern
+      #   for this operation.
+      # @option spec :ordered [ true, false ] Whether the operations should be
+      #   executed in order.
+      # @option spec :options [Hash] Options for the command, if it ends up being a
+      #   write command.
+      #
+      # @since 2.0.0
+      class Delete
+        include Executable
+        include Specifiable
+
+        # Execute the delete operation.
+        #
+        # @example Execute the operation.
+        #   operation.execute(context)
+        #
+        # @params [ Mongo::Server::Context ] The context for this operation.
+        #
+        # @return [ Result ] The result.
+        #
+        # @since 2.0.0
+        def execute(context)
+          if context.features.write_command_enabled?
+            execute_write_command(context)
+          else
+            execute_message(context)
+          end
+        end
+
+        private
+
+        def execute_write_command(context)
+          s = spec.merge(:deletes => [ delete ])
+          s.delete(:delete)
+          Result.new(Command::Delete.new(s).execute(context)).validate!
+        end
+
+        def execute_message(context)
+          context.with_connection do |connection|
+            Result.new(connection.dispatch([ message, gle ].compact)).validate!
+          end
+        end
+
+        def message
+          selector = delete[:q]
+          opts     = ( delete[:limit] || 0 ) <= 0 ? {} : { :flags => [ :single_remove ] }
+          Protocol::Delete.new(db_name, coll_name, selector, opts)
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/write/drop_index.rb

@@ -0,0 +1,62 @@
+# Copyright (C) 2014-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Mongo
+  module Operation
+    module Write
+
+      # A MongoDB drop index operation.
+      #
+      # @example Create the drop index operation.
+      #   Write::DropIndex.new({
+      #     :db_name => 'test',
+      #     :coll_name => 'test_coll',
+      #     :index_name => 'name_1_age_-1'
+      #   })
+      #
+      # @param [ Hash ] spec The specifications for the drop.
+      #
+      # @option spec :index [ Hash ] The index spec to create.
+      # @option spec :db_name [ String ] The name of the database.
+      # @option spec :coll_name [ String ] The name of the collection.
+      # @option spec :index_name [ String ] The name of the index.
+      #
+      # @since 2.0.0
+      class DropIndex
+        include Executable
+        include Specifiable
+
+        # Execute the drop index operation.
+        #
+        # @example Execute the operation.
+        #   operation.execute(context)
+        #
+        # @params [ Mongo::Server::Context ] The context for this operation.
+        #
+        # @return [ Result ] The result of the operation.
+        #
+        # @since 2.0.0
+        def execute(context)
+          execute_write_command(context)
+        end
+
+        private
+
+        def execute_write_command(context)
+          Result.new(Command::DropIndex.new(spec).execute(context)).validate!
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/write/insert.rb

@@ -0,0 +1,88 @@
+# Copyright (C) 2014-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Mongo
+  module Operation
+    module Write
+
+      # A MongoDB insert operation.
+      #
+      # @note If a server with version >= 2.5.5 is being used, a write command
+      #   operation will be created and sent instead.
+      #
+      # @example Create the new insert operation.
+      #   Write::Insert.new({
+      #     :documents => [{ :foo => 1 }],
+      #     :db_name => 'test',
+      #     :coll_name => 'test_coll',
+      #     :write_concern => write_concern
+      #   })
+      #
+      # @param [ Hash ] spec The specifications for the insert.
+      #
+      # @option spec :documents [ Array ] The documents to insert.
+      # @option spec :db_name [ String ] The name of the database.
+      # @option spec :coll_name [ String ] The name of the collection.
+      # @option spec :write_concern [ Mongo::WriteConcern ] The write concern.
+      # @option spec :options [ Hash ] Options for the command, if it ends up being a
+      #   write command.
+      #
+      # @since 2.0.0
+      class Insert
+        include Executable
+        include Specifiable
+
+        # Execute the insert operation.
+        #
+        # @example Execute the operation.
+        #   operation.execute(context)
+        #
+        # @params [ Mongo::Server::Context ] The context for this operation.
+        #
+        # @return [ Result ] The operation result.
+        #
+        # @since 2.0.0
+        def execute(context)
+          if context.features.write_command_enabled?
+            execute_write_command(context)
+          else
+            execute_message(context)
+          end
+        end
+
+        private
+
+        def execute_write_command(context)
+          Result.new(Command::Insert.new(spec).execute(context)).validate!
+        end
+
+        def execute_message(context)
+          context.with_connection do |connection|
+            Result.new(connection.dispatch([ message, gle ].compact)).validate!
+          end
+        end
+
+        def initialize_copy(original)
+          @spec = original.spec.dup
+          @spec[:documents] = original.spec[:documents].dup
+        end
+
+        def message
+          opts = !!options[:continue_on_error] ? { :flags => [:continue_on_error] } : {}
+          Protocol::Insert.new(db_name, coll_name, documents, opts)
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/write/remove_user.rb

@@ -0,0 +1,70 @@
+# Copyright (C) 2014-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Mongo
+  module Operation
+    module Write
+
+      # A MongoDB remove user operation.
+      #
+      # @example Create the remove user operation.
+      #   Write::RemoveUser.new(:db_name => 'test', :name => name)
+      #
+      # @param [ Hash ] spec The specifications for the remove.
+      #
+      # @option spec :name [ String ] The user name.
+      # @option spec :db_name [ String ] The name of the database.
+      #
+      # @since 2.0.0
+      class RemoveUser
+        include Executable
+        include Specifiable
+
+        # Execute the remove user operation.
+        #
+        # @example Execute the operation.
+        #   operation.execute(context)
+        #
+        # @params [ Mongo::Server::Context ] The context for this operation.
+        #
+        # @return [ Result ] The operation result.
+        #
+        # @since 2.0.0
+        def execute(context)
+          if context.features.write_command_enabled?
+            execute_write_command(context)
+          else
+            execute_message(context)
+          end
+        end
+
+        private
+
+        def execute_write_command(context)
+          Result.new(Command::RemoveUser.new(spec).execute(context)).validate!
+        end
+
+        def execute_message(context)
+          context.with_connection do |connection|
+            Result.new(connection.dispatch([ message, gle ].compact)).validate!
+          end
+        end
+
+        def message
+          Protocol::Delete.new(db_name, Auth::User::COLLECTION, { user: user_name })
+        end
+      end
+    end
+  end
+end