mongo 2.4.1 → 2.14.0

data/lib/mongo/operation/commands/find.rb

@@ -1,27 +0,0 @@
-# Copyright (C) 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 Commands
-
-      # Encapsulates behaviour for executing a find command.
-      #
-      # @since 2.2.0
-      class Find < Command; end
-    end
-  end
-end
-
-require 'mongo/operation/commands/find/result'

data/lib/mongo/operation/commands/get_more/result.rb

@@ -1,62 +0,0 @@
-# Copyright (C) 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 Commands
-      class GetMore
-
-        # Defines custom behaviour of results for the get more command.
-        #
-        # @since 2.2.0
-        class Result < Operation::Result
-
-          # Get the cursor id.
-          #
-          # @example Get the cursor id.
-          #   result.cursor_id
-          #
-          # @return [ Integer ] The cursor id.
-          #
-          # @since 2.2.0
-          def cursor_id
-            cursor_document ? cursor_document[CURSOR_ID] : super
-          end
-
-          # Get the documents in the result.
-          #
-          # @example Get the documents.
-          #   result.documents
-          #
-          # @return [ Array<BSON::Document> ] The documents.
-          #
-          # @since 2.2.0
-          def documents
-            cursor_document[NEXT_BATCH]
-          end
-
-          private
-
-          def cursor_document
-            @cursor_document ||= reply.documents[0][CURSOR]
-          end
-
-          def first_document
-            @first_document ||= reply.documents[0]
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongo/operation/commands/get_more.rb

@@ -1,27 +0,0 @@
-# Copyright (C) 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 Commands
-
-      # Encapsulates behaviour for executing a getmore command.
-      #
-      # @since 2.2.0
-      class GetMore < Command; end
-    end
-  end
-end
-
-require 'mongo/operation/commands/get_more/result'

data/lib/mongo/operation/commands/indexes.rb

@@ -1,73 +0,0 @@
-# Copyright (C) 2014-2016 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 Commands
-
-      # A MongoDB get indexes operation.
-      #
-      # Initialize the get indexes operation.
-      #
-      # @example Instantiate the operation.
-      #   Read::Indexes.new(:db_name => 'test', :coll_name => 'test_coll')
-      #
-      # Initialization:
-      #   param [ Hash ] spec The specifications for the insert.
-      #
-      #   option spec :db_name [ String ] The name of the database.
-      #   option spec :coll_name [ String ] The name of the collection.
-      #
-      # @since 2.0.0
-      class Indexes
-        include Specifiable
-        include ReadPreference
-
-        # Execute the operation.
-        #
-        # @example Execute the operation.
-        #   operation.execute(server)
-        #
-        # @param [ Mongo::Server ] server The server to send this operation to.
-        #
-        # @return [ Result ] The indexes operation response.
-        #
-        # @since 2.0.0
-        def execute(server)
-          if server.features.list_indexes_enabled?
-            ListIndexes.new(spec).execute(server)
-          else
-            execute_message(server)
-          end
-        end
-
-        private
-
-        def execute_message(server)
-          server.with_connection do |connection|
-            Result.new(connection.dispatch([ message(server) ]))
-          end
-        end
-
-        def selector
-          { ns: namespace }
-        end
-
-        def query_coll
-          Index::COLLECTION
-        end
-      end
-    end
-  end
-end

data/lib/mongo/operation/commands/list_collections/result.rb

@@ -1,94 +0,0 @@
-# Copyright (C) 2014-2016 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 Commands
-      class ListCollections
-
-        # Defines custom behaviour of results when using the
-        # listCollections command.
-        #
-        # @since 2.0.0
-        class Result < Operation::Result
-
-          # Get the cursor id for the result.
-          #
-          # @example Get the cursor id.
-          #   result.cursor_id
-          #
-          # @note Even though the wire protocol has a cursor_id field for all
-          #   messages of type reply, it is always zero when using the
-          #   listCollections command and must be retrieved from the cursor
-          #   document itself.
-          #
-          # @return [ Integer ] The cursor id.
-          #
-          # @since 2.0.0
-          def cursor_id
-            cursor_document ? cursor_document[CURSOR_ID] : super
-          end
-
-          # Get the namespace for the cursor.
-          #
-          # @example Get the namespace.
-          #   result.namespace
-          #
-          # @return [ String ] The namespace.
-          #
-          # @since 2.0.0
-          def namespace
-            cursor_document ? cursor_document[NAMESPACE] : super
-          end
-
-          # Get the documents for the listCollections result. It is the 'firstBatch'
-          #   field in the 'cursor' field of the first document returned.
-          #
-          # @example Get the documents.
-          #   result.documents
-          #
-          # @return [ Array<BSON::Document> ] The documents.
-          #
-          # @since 2.0.0
-          def documents
-            cursor_document[FIRST_BATCH]
-          end
-
-          # Validate the result. In the case where an unauthorized client tries
-          # to run the command we need to generate the proper error.
-          #
-          # @example Validate the result.
-          #   result.validate!
-          #
-          # @return [ Result ] Self if successful.
-          #
-          # @since 2.0.0
-          def validate!
-            !successful? ? raise(Error::OperationFailure.new(parser.message)) : self
-          end
-
-          private
-
-          def cursor_document
-            @cursor_document ||= first_document[CURSOR]
-          end
-
-          def first_document
-            @first_document ||= reply.documents[0]
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongo/operation/commands/list_collections.rb

@@ -1,48 +0,0 @@
-# Copyright (C) 2014-2016 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 Commands
-
-      # A MongoDB listCollections command operation.
-      #
-      # @example Create the listCollections command operation.
-      #   Mongo::Operation::Read::ListCollections.new(db_name: 'test')
-      #
-      # @note A command is actually a query on the virtual '$cmd' collection.
-      #
-      # Initialization:
-      #   param [ Hash ] spec The specifications for the command.
-      #
-      #   option spec :db_name [ String ] The name of the database whose list of
-      #     collection names is requested.
-      #   option spec :options [ Hash ] Options for the command.
-      #
-      # @since 2.0.0
-      class ListCollections < Command
-
-        private
-
-        def selector
-          (spec[SELECTOR] || {}).merge(
-            listCollections: 1, filter: { name: { '$not' => /system\.|\$/ }}
-          )
-        end
-      end
-    end
-  end
-end
-
-require 'mongo/operation/commands/list_collections/result'

data/lib/mongo/operation/commands/list_indexes/result.rb

@@ -1,98 +0,0 @@
-# Copyright (C) 2014-2016 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 Commands
-      class ListIndexes
-
-        # Defines custom behaviour of results when using the
-        # listIndexes command.
-        #
-        # @since 2.0.0
-        class Result < Operation::Result
-
-          # Get the cursor id for the result.
-          #
-          # @example Get the cursor id.
-          #   result.cursor_id
-          #
-          # @note Even though the wire protocol has a cursor_id field for all
-          #   messages of type reply, it is always zero when using the
-          #   listIndexes command and must be retrieved from the cursor
-          #   document itself.
-          #
-          # @return [ Integer ] The cursor id.
-          #
-          # @since 2.0.0
-          def cursor_id
-            cursor_document ? cursor_document[CURSOR_ID] : super
-          end
-
-          # Get the namespace for the cursor.
-          #
-          # @example Get the namespace.
-          #   result.namespace
-          #
-          # @return [ String ] The namespace.
-          #
-          # @since 2.0.0
-          def namespace
-            cursor_document ? cursor_document[NAMESPACE] : super
-          end
-
-          # Get the documents for the listIndexes result. This is the 'firstBatch'
-          # field in the 'cursor' field of the first document returned.
-          #
-          # @example Get the documents.
-          #   result.documents
-          #
-          # @return [ Array<BSON::Document> ] The documents.
-          #
-          # @since 2.0.0
-          def documents
-            cursor_document[FIRST_BATCH]
-          end
-
-          # Validate the result. In the case where the database or collection
-          # does not exist on the server we will get an error, and it's better
-          # to raise a meaningful exception here than the ambiguous one when
-          # the error occurs.
-          #
-          # @example Validate the result.
-          #   result.validate!
-          #
-          # @raise [ NoNamespace ] If the ns doesn't exist.
-          #
-          # @return [ Result ] Self if successful.
-          #
-          # @since 2.0.0
-          def validate!
-            !successful? ? raise(Error::OperationFailure.new(parser.message)) : self
-          end
-
-          private
-
-          def cursor_document
-            @cursor_document ||= first_document[CURSOR]
-          end
-
-          def first_document
-            @first_document ||= reply.documents[0]
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongo/operation/commands/list_indexes.rb

@@ -1,48 +0,0 @@
-# Copyright (C) 2014-2016 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 Commands
-
-      # A MongoDB listIndexes command operation.
-      #
-      # @example Create the listIndexes command operation.
-      #   Mongo::Operation::Read::ListIndexes.new({ db_name: 'test', coll_name: 'example' })
-      #
-      # @note A command is actually a query on the virtual '$cmd' collection.
-      #
-      # Initialization:
-      #   param [ Hash ] spec The specifications for the command.
-      #
-      #   option spec :coll_name [ Hash ] The name of the collection whose index
-      #     info is requested.
-      #   option spec :db_name [ String ] The name of the database on which
-      #     the command should be executed.
-      #   option spec :options [ Hash ] Options for the command.
-      #
-      # @since 2.0.0
-      class ListIndexes < Command
-
-        private
-
-        def selector
-          (spec[SELECTOR] || {}).merge(listIndexes: coll_name)
-        end
-      end
-    end
-  end
-end
-
-require 'mongo/operation/commands/list_indexes/result'

data/lib/mongo/operation/commands/map_reduce/result.rb

@@ -1,119 +0,0 @@
-# Copyright (C) 2014-2016 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 Commands
-      class MapReduce
-
-        # Defines custom behaviour of results for a map reduce operation.
-        #
-        # @since 2.0.0
-        class Result < Operation::Result
-
-          # The counts field for the map/reduce.
-          #
-          # @since 2.0.0
-          COUNTS = 'counts'.freeze
-
-          # The field name for a result without a cursor.
-          #
-          # @since 2.0.0
-          RESULTS = 'results'.freeze
-
-          # The time the operation took constant.
-          #
-          # @since 2.0.0
-          TIME = 'timeMillis'.freeze
-
-          # Gets the map/reduce counts from the reply.
-          #
-          # @example Get the counts.
-          #   result.counts
-          #
-          # @return [ Hash ] A hash of the result counts.
-          #
-          # @since 2.0.0
-          def counts
-            reply.documents[0][COUNTS]
-          end
-
-          # Get the documents from the map/reduce.
-          #
-          # @example Get the documents.
-          #   result.documents
-          #
-          # @return [ Array<BSON::Document> ] The documents.
-          #
-          # @since 2.0.0
-          def documents
-            reply.documents[0][RESULTS] || reply.documents[0][RESULT]
-          end
-
-          # If the result was a command then determine if it was considered a
-          # success.
-          #
-          # @note If the write was unacknowledged, then this will always return
-          #   true.
-          #
-          # @example Was the command successful?
-          #   result.successful?
-          #
-          # @return [ true, false ] If the command was successful.
-          #
-          # @since 2.0.0
-          def successful?
-            !documents.nil?
-          end
-
-          # Get the execution time of the map/reduce.
-          #
-          # @example Get the execution time.
-          #   result.time
-          #
-          # @return [ Integer ] The executing time in milliseconds.
-          #
-          # @since 2.0.0
-          def time
-            reply.documents[0][TIME]
-          end
-
-          # Validate the result by checking for any errors.
-          #
-          # @note This only checks for errors with writes since authentication is
-          #   handled at the connection level and any authentication errors would
-          #   be raised there, before a Result is ever created.
-          #
-          # @example Validate the result.
-          #   result.validate!
-          #
-          # @raise [ Error::OperationFailure ] If an error is in the result.
-          #
-          # @return [ Result ] The result if verification passed.
-          #
-          # @since 2.0.0
-          def validate!
-            documents.nil? ? raise(Error::OperationFailure.new(parser.message)) : self
-          end
-
-          private
-
-          def first_document
-            @first_document ||= reply.documents[0]
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongo/operation/commands/map_reduce.rb

@@ -1,60 +0,0 @@
-# Copyright (C) 2014-2016 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 Commands
-
-      # A MongoDB map reduce operation.
-      #
-      # @note A map/reduce operation can behave like a read and
-      #   return a result set, or can behave like a write operation and
-      #   output results to a user-specified collection.
-      #
-      # @example Create the map/reduce operation.
-      #   MapReduce.new({
-      #     :selector => {
-      #       :mapreduce => 'test_coll',
-      #       :map => '',
-      #       :reduce => ''
-      #     },
-      #     :db_name  => 'test_db'
-      #   })
-      #
-      # Initialization:
-      #   param [ Hash ] spec The specifications for the operation.
-      #
-      #   option spec :selector [ Hash ] The map reduce selector.
-      #   option spec :db_name [ String ] The name of the database on which
-      #     the operation should be executed.
-      #   option spec :options [ Hash ] Options for the map reduce command.
-      #
-      # @since 2.0.0
-      class MapReduce < Command
-        include TakesWriteConcern
-
-        private
-
-        def message(server)
-          sel = update_selector_for_read_pref(selector, server)
-          sel = update_selector_for_write_concern(sel, server)
-          opts = update_options_for_slave_ok(options, server)
-          Protocol::Query.new(db_name, query_coll, sel, opts)
-        end
-      end
-    end
-  end
-end
-
-require 'mongo/operation/commands/map_reduce/result'