mongo 1.12.5 → 2.0.0.beta

data/lib/mongo/{utils/thread_local_variable_manager.rb → error/empty_batch.rb}

@@ -1,4 +1,4 @@
-# Copyright (C) 2009-2013 MongoDB, Inc.
+# 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.
@@ -12,14 +12,28 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-#:nodoc:
 module Mongo
-  module ThreadLocalVariableManager
-    def thread_local
-      Thread.current[:mongo_thread_locals] ||= Hash.new do |hash, key|
-        hash[key] = Hash.new unless hash.key? key
-        hash[key]
+  class Error
+
+    # Exception raised for bulk operations that are empty.
+    #
+    # @since 2.0.0
+    class EmptyBatch < Error
+
+      # The error message.
+      #
+      # @since 2.0.0
+      MESSAGE = 'No operations to execute'.freeze
+
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Error::EmptyBatch.new
+      #
+      # @since 2.0.0
+      def initialize
+        super(MESSAGE)
       end
     end
   end
-end
+end

data/{test/functional/db_connection_test.rb → lib/mongo/error/invalid_bulk_operation.rb}

@@ -1,4 +1,4 @@
-# Copyright (C) 2009-2013 MongoDB, Inc.
+# 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.
@@ -12,14 +12,25 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'test_helper'
+module Mongo
+  class Error
 
-class DBConnectionTest < Test::Unit::TestCase
+    # Exception raised if an non-existent operation type is used.
+    #
+    # @since 2.0.0
+    class InvalidBulkOperation < Error
 
-  def test_no_exceptions
-    db = standard_connection.db(TEST_DB)
-    coll = db.collection('test')
-    coll.remove
-    db.get_last_error
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Error::InvalidBulkOperation.new(name)
+      #
+      # @param [ String ] name The attempted operation name.
+      #
+      # @since 2.0.0
+      def initialize(name)
+        super("Invalid operation type: #{name}.")
+      end
+    end
   end
 end

data/lib/mongo/error/invalid_collection_name.rb

@@ -0,0 +1,39 @@
+# 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
+  class Error
+
+    # Exception that is raised when trying to create a collection with no name.
+    #
+    # @since 2.0.0
+    class InvalidCollectionName < Error
+
+      # The message is constant.
+      #
+      # @since 2.0.0
+      MESSAGE = 'nil is an invalid collection name. Please provide a string or symbol.'.freeze
+
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Collection::InvalidName.new
+      #
+      # @since 2.0.0
+      def initialize
+        super(MESSAGE)
+      end
+    end
+  end
+end

data/lib/mongo/error/invalid_database_name.rb

@@ -0,0 +1,39 @@
+# 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
+  class Error
+
+    # Exception that is raised when trying to create a database with no name.
+    #
+    # @since 2.0.0
+    class InvalidDatabaseName < Error
+
+      # The message is constant.
+      #
+      # @since 2.0.0
+      MESSAGE = 'nil is an invalid database name. Please provide a string or symbol.'.freeze
+
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Error::InvalidDatabaseName.new
+      #
+      # @since 2.0.0
+      def initialize
+        super(MESSAGE)
+      end
+    end
+  end
+end

data/{test/replica_set/ssl_test.rb → lib/mongo/error/invalid_document.rb}

@@ -1,4 +1,4 @@
-# Copyright (C) 2009-2013 MongoDB, Inc.
+# 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.
@@ -12,21 +12,28 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'test_helper'
-require 'shared/ssl_shared'
+module Mongo
+  class Error
 
-class ReplicaSetSSLTest < Test::Unit::TestCase
-  include Mongo
-  include SSLTests
+    # Exception raised if the object is not a valid document.
+    #
+    # @since 2.0.0
+    class InvalidDocument < Error
 
-  SEEDS     = ['server:3000','server:3001','server:3002']
-  BAD_SEEDS = ['localhost:3000','localhost:3001','localhost:3002']
+      # The error message.
+      #
+      # @since 2.0.0
+      MESSAGE = 'Invalid document provided'.freeze
 
-  def setup
-    @client_class     = MongoReplicaSetClient
-    @uri_info         = SEEDS.join(',')
-    @connect_info     = SEEDS
-    @bad_connect_info = BAD_SEEDS
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Error::InvalidDocument.new
+      #
+      # @since 2.0.0
+      def initialize
+        super(MESSAGE)
+      end
+    end
   end
-
 end

data/lib/mongo/error/invalid_file.rb

@@ -0,0 +1,38 @@
+# 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
+  class Error
+
+    # Raised if the file md5 and server md5 do not match when acknowledging
+    # GridFS writes.
+    #
+    # @since 2.0.0
+    class InvalidFile < Error
+
+      # Create the nex exception.
+      #
+      # @example Create the mew exception.
+      #   Mongo::Error::InvalidFile.new(file_md5, server_md5)
+      #
+      # @param [ String ] client_md5 The client side file md5.
+      # @param [ String ] server_md5 The server side file md5.
+      #
+      # @since 2.0.0
+      def initialize(client_md5, server_md5)
+        super("File MD5 on client side is #{client_md5} but the server reported #{server_md5}.")
+      end
+    end
+  end
+end

data/lib/mongo/error/invalid_nonce.rb

@@ -0,0 +1,46 @@
+# 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
+  class Error
+
+    # This exception is raised when the server nonce returned does not
+    # match the client nonce sent to it.
+    #
+    # @since 2.0.0
+    class InvalidNonce < Error
+
+      # @return [ String ] nonce The client nonce.
+      attr_reader :nonce
+
+      # @return [ String ] rnonce The server nonce.
+      attr_reader :rnonce
+
+      # Instantiate the new exception.
+      #
+      # @example Create the exception.
+      #   InvalidNonce.new(nonce, rnonce)
+      #
+      # @param [ String ] nonce The client nonce.
+      # @param [ String ] rnonce The server nonce.
+      #
+      # @since 2.0.0
+      def initialize(nonce, rnonce)
+        @nonce = nonce
+        @rnonce = rnonce
+        super("Expected server rnonce '#{rnonce}' to start with client nonce '#{nonce}'.")
+      end
+    end
+  end
+end

data/lib/mongo/error/invalid_replacement_document.rb

@@ -0,0 +1,39 @@
+# 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
+  class Error
+
+    # Exception raised if the object is not a valid replacement document.
+    #
+    # @since 2.0.0
+    class InvalidReplacementDocument < Error
+
+      # The error message.
+      #
+      # @since 2.0.0
+      MESSAGE = 'Invalid replacement document provided'.freeze
+
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Error::InvalidReplacementDoc.new
+      #
+      # @since 2.0.0
+      def initialize
+        super(MESSAGE)
+      end
+    end
+  end
+end

data/lib/mongo/error/invalid_signature.rb

@@ -0,0 +1,47 @@
+# 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
+  class Error
+
+    # This exception is raised when the server verifier does not match the
+    # expected signature on the client.
+    #
+    # @since 2.0.0
+    class InvalidSignature < Error
+
+      # @return [ String ] verifier The server verifier string.
+      attr_reader :verifier
+
+      # @return [ String ] server_signature The expected server signature.
+      attr_reader :server_signature
+
+      # Create the new exception.
+      #
+      # @example Create the new exception.
+      #   InvalidSignature.new(verifier, server_signature)
+      #
+      # @param [ String ] verifier The verifier returned from the server.
+      # @param [ String ] server_signature The expected value from the
+      #   server.
+      #
+      # @since 2.0.0
+      def initialize(verifier, server_signature)
+        @verifier = verifier
+        @server_signature = server_signature
+        super("Expected server verifier '#{verifier}' to match '#{server_signature}'.")
+      end
+    end
+  end
+end

data/{test/functional/ssl_test.rb → lib/mongo/error/invalid_update_document.rb}

@@ -1,4 +1,4 @@
-# Copyright (C) 2009-2013 MongoDB, Inc.
+# 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.
@@ -12,18 +12,28 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'test_helper'
-require 'shared/ssl_shared'
+module Mongo
+  class Error
 
-class SSLTest < Test::Unit::TestCase
-  include Mongo
-  include SSLTests
+    # Exception raised if the object is not a valid update document.
+    #
+    # @since 2.0.0
+    class InvalidUpdateDocument < Error
 
-  def setup
-    @client_class     = MongoClient
-    @uri_info         = 'server'
-    @connect_info     = ['server', 27017]
-    @bad_connect_info = ['localhost', 27017]
-  end
+      # The error message.
+      #
+      # @since 2.0.0
+      MESSAGE = 'Invalid update document provided'.freeze
 
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Error::InvalidUpdateDocument.new
+      #
+      # @since 2.0.0
+      def initialize
+        super(MESSAGE)
+      end
+    end
+  end
 end

data/lib/mongo/error/max_bson_size.rb

@@ -0,0 +1,40 @@
+# 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
+  class Error
+
+    # Exception that is raised when trying to serialize a document that
+    # exceeds max BSON object size.
+    #
+    # @since 2.0.0
+    class MaxBSONSize < Error
+
+      # The message is constant.
+      #
+      # @since 2.0.0
+      MESSAGE = "Document exceeds allowed max BSON size.".freeze
+
+      # Instantiate the new exception.
+      #
+      # @example Instantiate the exception.
+      #   Mongo::Error::MaxBSONSize.new(max)
+      #
+      # @since 2.0.0
+      def initialize(max_size = nil)
+        super(max_size ?  MESSAGE + " The max is #{max_size}." : MESSAGE)
+      end
+    end
+  end
+end