File: errors.rb

package info (click to toggle)
ruby-gapic-common 1.3.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 392 kB
  • sloc: ruby: 2,081; makefile: 4
file content (60 lines) | stat: -rw-r--r-- 2,090 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# Copyright 2019 Google LLC
#
# 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
#
#     https://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.

require "googleauth"
require "gapic/common/error"

module Gapic
  module GRPC
    ##
    # An error class to represent the Authorization Error.
    # The GRPC layer wraps auth plugin errors in ::GRPC::Unavailable.
    # This class rewraps those GRPC layer errors, presenting a correct status code.
    #
    class AuthorizationError < ::GRPC::Unauthenticated
    end

    ##
    # An error class that represents Deadline Exceeded error with an optional
    # retry root cause.
    #
    # The GRPC layer throws ::GRPC::DeadlineExceeded without any context.
    # If the deadline was exceeded while retrying another exception (e.g.
    # ::GRPC::Unavailable), that exception could be useful for understanding
    # the readon for the timeout.
    #
    # This exception rewraps ::GRPC::DeadlineExceeded, adding an exception
    # that was being retried until the deadline was exceeded (if any) as a
    # `root_cause` attribute.
    #
    # @!attribute [r] root_cause
    #   @return [Object, nil] The exception that was being retried
    #     when the DeadlineExceeded error occured.
    #
    class DeadlineExceededError < ::GRPC::DeadlineExceeded
      attr_reader :root_cause

      ##
      # @param message [String] The error message.
      #
      # @param root_cause [Object, nil] The exception that was being retried
      #   when the DeadlineExceeded error occured.
      #
      def initialize message, root_cause: nil
        super message
        @root_cause = root_cause
      end
    end
  end
end