mongo 2.12.4 → 2.13.0.beta1

data/lib/mongo/error/invalid_server_preference.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -30,6 +30,11 @@ module Mongo
       # @since 2.4.0
       NO_MAX_STALENESS_SUPPORT = 'max_staleness cannot be set for this read preference.'.freeze
 
+      # Error message when hedge is specified for a read preference that does not support it.
+      #
+      # @api private
+      NO_HEDGE_SUPPORT = 'The hedge option cannot be set for this read preference'.freeze
+
       # Error message for when the max staleness is not at least twice the heartbeat frequency.
       #
       # @since 2.4.0

data/lib/mongo/error/invalid_session.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_signature.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_transaction_operation.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_txt_record.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_update_document.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_uri.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_write_concern.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/lint_error.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2018-2019 MongoDB, Inc.
+# Copyright (C) 2018-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/max_bson_size.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/max_message_size.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/mismatched_domain.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_file_chunk.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_password.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2019 MongoDB, Inc.
+# Copyright (C) 2019-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_resume_token.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_scram_server_signature.rb

@@ -0,0 +1,27 @@
+# Copyright (C) 2020 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 returned +{done: true}+ in a
+    # SCRAM conversation but did not provide a ServerSignature.
+    class MissingScramServerSignature < Error
+      def initialize(msg = nil)
+        msg ||= "Server signaled completion of SCRAM conversation without providing ServerSignature"
+        super(msg)
+      end
+    end
+  end
+end

data/lib/mongo/error/multi_index_drop.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/need_primary_server.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/no_server_available.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/no_srv_records.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/notable.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2019 MongoDB, Inc.
+# Copyright (C) 2019-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,8 +15,9 @@
 module Mongo
   class Error < StandardError
 
-    # A module encapsulating note tracking functionality, since currently
-    # the driver does not have a single exception hierarchy root.
+    # A module encapsulating functionality to manage data attached to
+    # exceptions in the driver, since the driver does not currently have a
+    # single exception hierarchy root.
     #
     # @since 2.11.0
     # @api private
@@ -42,9 +43,23 @@ module Mongo
         unless @notes
           @notes = []
         end
+        if Lint.enabled?
+          if @notes.include?(note)
+            # The driver makes an effort to not add duplicated notes, by
+            # keeping track of *when* a particular exception should have the
+            # particular notes attached to it throughout the call stack.
+            raise Error::LintError, "Adding a note which already exists in exception #{self}: #{note}"
+          end
+        end
         @notes << note
       end
 
+      # Returns connection pool generation for the connection on which the
+      # error occurred.
+      #
+      # @return [ Integer | nil ] Connection pool generation.
+      attr_accessor :generation
+
       # @api public
       def to_s
         super + notes_tail

data/lib/mongo/error/operation_failure.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -28,18 +28,18 @@ module Mongo
       # @since 2.6.0
       # @api private
       WRITE_RETRY_ERRORS = [
-        {:code_name => 'InterruptedAtShutdown', :code => 11600},
-        {:code_name => 'InterruptedDueToStepDown', :code => 11602},
-        {:code_name => 'NotMaster', :code => 10107},
-        {:code_name => 'NotMasterNoSlaveOk', :code => 13435},
-        {:code_name => 'NotMasterOrSecondary', :code => 13436},
-        {:code_name => 'PrimarySteppedDown', :code => 189},
-        {:code_name => 'ShutdownInProgress', :code => 91},
-        {:code_name => 'HostNotFound', :code => 7},
         {:code_name => 'HostUnreachable', :code => 6},
+        {:code_name => 'HostNotFound', :code => 7},
         {:code_name => 'NetworkTimeout', :code => 89},
+        {:code_name => 'ShutdownInProgress', :code => 91},
+        {:code_name => 'PrimarySteppedDown', :code => 189},
+        {:code_name => 'ExceededTimeLimit', :code => 262},
         {:code_name => 'SocketException', :code => 9001},
-        {:code_name => 'ExceededTimeLimit', :code => 262}
+        {:code_name => 'NotMaster', :code => 10107},
+        {:code_name => 'InterruptedAtShutdown', :code => 11600},
+        {:code_name => 'InterruptedDueToReplStateChange', :code => 11602},
+        {:code_name => 'NotMasterNoSlaveOk', :code => 13435},
+        {:code_name => 'NotMasterOrSecondary', :code => 13436},
       ].freeze
 
       # These are magic error messages that could indicate a master change.
@@ -71,6 +71,14 @@ module Mongo
 
       def_delegators :@result, :operation_time
 
+      # @!method connection_description
+      #
+      # @return [ Server::Description ] Server description of the server that
+      #   the operation that this exception refers to was performed on.
+      #
+      # @api private
+      def_delegator :@result, :connection_description
+
       # @return [ Integer ] The error code parsed from the document.
       #
       # @since 2.6.0
@@ -89,8 +97,7 @@ module Mongo
       # @since 2.1.1
       # @deprecated
       def retryable?
-        write_retryable? ||
-        code.nil? && RETRY_MESSAGES.any?{ |m| message.include?(m) }
+        write_retryable? || RETRY_MESSAGES.any?{ |m| message.include?(m) }
       end
 
       # Whether the error is a retryable error according to the modern retryable
@@ -103,11 +110,11 @@ module Mongo
       #
       # @since 2.4.2
       def write_retryable?
-        write_retryable_code? ||
-        code.nil? && WRITE_RETRY_MESSAGES.any? { |m| message.include?(m) }
+        WRITE_RETRY_MESSAGES.any? { |m| message.include?(m) } ||
+        write_retryable_code?
       end
 
-      private def write_retryable_code?
+      def write_retryable_code?
         if code
           WRITE_RETRY_ERRORS.any? { |e| e[:code] == code }
         else
@@ -115,16 +122,31 @@ module Mongo
           false
         end
       end
+      private :write_retryable_code?
 
       # Error codes and code names that should result in a failing getMore
       # command on a change stream NOT being resumed.
       #
-      # @since 2.6.0
       # @api private
-      CHANGE_STREAM_NOT_RESUME_ERRORS = [
-        {:code_name => 'CappedPositionLost', :code => 136},
-        {:code_name => 'CursorKilled', :code => 237},
-        {:code_name => 'Interrupted', :code => 11601},
+      CHANGE_STREAM_RESUME_ERRORS = [
+        {code_name: 'HostUnreachable', code: 6},
+        {code_name: 'HostNotFound', code: 7},
+        {code_name: 'NetworkTimeout', code: 89},
+        {code_name: 'ShutdownInProgress', code: 91},
+        {code_name: 'PrimarySteppedDown', code: 189},
+        {code_name: 'ExceededTimeLimit', code: 262},
+        {code_name: 'SocketException', code: 9001},
+        {code_name: 'NotMaster', code: 10107},
+        {code_name: 'InterruptedAtShutdown', code: 11600},
+        {code_name: 'InterruptedDueToReplStateChange', code: 11602},
+        {code_name: 'NotMasterNoSlaveOk', code: 13435},
+        {code_name: 'NotMasterOrSecondary', code: 13436},
+
+        {code_name: 'StaleShardVersion', code: 63},
+        {code_name: 'FailedToSatisfyReadPreference', code: 133},
+        {code_name: 'StaleEpoch', code: 150},
+        {code_name: 'RetryChangeStream', code: 234},
+        {code_name: 'StaleConfig', code: 13388},
       ].freeze
 
       # Change stream can be resumed when these error messages are encountered.
@@ -144,59 +166,47 @@ module Mongo
       # @since 2.6.0
       def change_stream_resumable?
         if @result && @result.is_a?(Mongo::Operation::GetMore::Result)
-          !change_stream_not_resumable_label? &&
-          (change_stream_resumable_message? ||
-          change_stream_resumable_code?)
+          # Connection description is not populated for unacknowledged writes.
+          if connection_description.max_wire_version >= 9
+            label?('ResumableChangeStreamError')
+          else
+            change_stream_resumable_code?
+          end
         else
           false
         end
       end
 
-      def change_stream_resumable_message?
-        CHANGE_STREAM_RESUME_MESSAGES.any? { |m| message.include?(m) }
-      end
-      private :change_stream_resumable_message?
-
       def change_stream_resumable_code?
-        if code
-          !CHANGE_STREAM_NOT_RESUME_ERRORS.any? { |e| e[:code] == code }
-        else
-          true
-        end
+        CHANGE_STREAM_RESUME_ERRORS.any? { |e| e[:code] == code }
       end
       private :change_stream_resumable_code?
 
-      def change_stream_not_resumable_label?
-        if labels
-          labels.include? 'NonResumableChangeStreamError'
-        else
-          false
-        end
-      end
-      private :change_stream_not_resumable_label?
-
       # @return [ true | false ] Whether the failure includes a write
       #   concern error. A failure may have a top level error and a write
       #   concern error or either one of the two.
       #
       # @since 2.10.0
-      # @api experimental
       def write_concern_error?
-        @write_concern_error
+        !!@write_concern_error_document
       end
 
+      # Returns the write concern error document as it was reported by the
+      # server, if any.
+      #
+      # @return [ Hash | nil ] Write concern error as reported to the server.
+      attr_reader :write_concern_error_document
+
       # @return [ Integer | nil ] The error code for the write concern error,
       #   if a write concern error is present and has a code.
       #
       # @since 2.10.0
-      # @api experimental
       attr_reader :write_concern_error_code
 
       # @return [ String | nil ] The code name for the write concern error,
       #   if a write concern error is present and has a code name.
       #
       # @since 2.10.0
-      # @api experimental
       attr_reader :write_concern_error_code_name
 
       # Create the operation failure.
@@ -213,12 +223,14 @@ module Mongo
       #
       # @option options [ Integer ] :code Error code.
       # @option options [ String ] :code_name Error code name.
-      # @option options [ true | false ] :write_concern_error Whether the
-      #   write concern error is present.
+      # @option options [ Hash ] :write_concern_error_document The
+      #   server-supplied write concern error document, if any.
       # @option options [ Integer ] :write_concern_error_code Error code for
       #   write concern error, if any.
       # @option options [ String ] :write_concern_error_code_name Error code
       #   name for write concern error, if any.
+      # @option options [ Array<String> ] :write_concern_error_labels Error
+      #   labels for the write concern error, if any.
       # @option options [ Array<String> ] :labels The set of labels associated
       #   with the error.
       # @option options [ true | false ] :wtimeout Whether the error is a wtimeout.
@@ -229,9 +241,10 @@ module Mongo
         @result = result
         @code = options[:code]
         @code_name = options[:code_name]
-        @write_concern_error = !!options[:write_concern_error]
+        @write_concern_error_document = options[:write_concern_error_document]
         @write_concern_error_code = options[:write_concern_error_code]
         @write_concern_error_code_name = options[:write_concern_error_code_name]
+        @write_concern_error_labels = options[:write_concern_error_labels] || []
         @labels = options[:labels] || []
         @wtimeout = !!options[:wtimeout]
       end

data/lib/mongo/error/parser.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -112,6 +112,15 @@ module Mongo
         !!write_concern_error_document
       end
 
+      # Returns the write concern error document as it was reported by the
+      # server, if any.
+      #
+      # @return [ Hash | nil ] Write concern error as reported to the server.
+      # @api experimental
+      def write_concern_error_document
+        document['writeConcernError']
+      end
+
       # @return [ Integer | nil ] The error code for the write concern error,
       #   if a write concern error is present and has a code.
       #
@@ -130,12 +139,14 @@ module Mongo
         write_concern_error_document && write_concern_error_document['codeName']
       end
 
-      private
-
-      def write_concern_error_document
-        document['writeConcernError']
+      # @return [ Array<String> | nil ] The error labels associated with this
+      # write concern error, if there is a write concern error present.
+      def write_concern_error_labels
+        write_concern_error_document && write_concern_error_document['errorLabels']
       end
 
+      private
+
       def parse!
         @message = ""
         parse_single(@message, ERR)