google-cloud-core 1.3.1 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6af81909a41c6ab7d265839df76f0e025ae0e95c64351cf208a559e930e0de3
-  data.tar.gz: 98b84b07b4a981970bc84115a6e8b34321378182fb1dcc8b2e7f21d82f0b5616
+  metadata.gz: 0da3f7e70a825960a1eefff5508fadf4e4e58005a16c1ee0cf3f1c9f04af65bb
+  data.tar.gz: 82b1d53b8a7339152f8a65a2c0ded58ac4edc1549c24eeff03c9bdaae0f10c56
 SHA512:
-  metadata.gz: a90ae21817cfa80f826fad42ac2fb7994335dc8638543cfda84f869eba97e55da1f627afe2eaf54d3d7bbb130496503c8107cf5c54ff03270c57933e14cfd4c5
-  data.tar.gz: 0f942939b24390d0a177fd154cf1463745818d348d86a022e17cdb10cf126db47738d950ac2d595cb022077ca75b5c9d344770486f5922cb2e1437eeefe6d6e4
+  metadata.gz: 9c29b01b9004f1cbe7a93a56e69286bce35a582f012ba819876f41667dc8b7b19d92c4f1108c314099d56882c9fe1022fe4a38d05dd76a70fda5bd48d78a0365
+  data.tar.gz: af2334493f6309401623c8c3c6b4712f421a3ce12563b1cf6a8ffa5dc03380e8afb043590d0a56fe397ef645aa89458af57df718cf0fd9a01f2ac5291fb09ed1

data/AUTHENTICATION.md

@@ -4,7 +4,7 @@ With `google-cloud-ruby` it's incredibly easy to get authenticated and start usi
 
 ### Google Cloud Platform environments
 
-While running on Google Cloud Platform environments such as Google Compute Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed. The **Project ID** and **Credentials** and are discovered automatically. Code should be written as if already authenticated.
+While running on Google Cloud Platform (GCP), including Google Compute Engine (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud Functions (GCF) and Cloud Run, no extra work is needed. The **Project ID** and **Credentials** and are discovered automatically. Code should be written as if already authenticated.
 
 ### Project and Credential Lookup
 

data/CONTRIBUTING.md

@@ -24,7 +24,7 @@ be able to accept your pull requests.
 In order to use the google-cloud console and run the project's tests,
 there is a small amount of setup:
 
-1. Install Ruby. google-cloud requires Ruby 2.3+. You may choose to
+1. Install Ruby. google-cloud requires Ruby 2.5+. You may choose to
    manage your Ruby and gem installations with [RVM](https://rvm.io/),
    [rbenv](https://github.com/rbenv/rbenv), or
    [chruby](https://github.com/postmodern/chruby).
@@ -45,7 +45,7 @@ there is a small amount of setup:
 
    ```sh
    $ cd google-cloud-core/
-   $ bundle exec rake bundleupdate
+   $ bundle install
    ```
 
 ## Console

data/README.md

@@ -9,11 +9,11 @@ information about the individual google-cloud gems.
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.3+.
+This library is supported on Ruby 2.5+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or in
-security maintenance, and not end of life. Currently, this means Ruby 2.3 and
+security maintenance, and not end of life. Currently, this means Ruby 2.5 and
 later. Older versions of Ruby _may_ still work, but are unsupported and not
 recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
 about the Ruby support schedule.

data/lib/google/cloud.rb

@@ -121,73 +121,6 @@ module Google
       end
     end
 
-    # Update the supported and recommended version thresholds according to the
-    # MRI support schedule: supported means non-EOL, and recommended means in
-    # normal (rather than security) maintenance. Generally, this means updating
-    # these at the end of March each year, if the previous year patterns hold.
-    # See https://www.ruby-lang.org/en/downloads/branches/
-
-    ##
-    # Minimum "supported" Ruby version (non-EOL)
-    # @private
-    #
-    SUPPORTED_VERSION_THRESHOLD = "2.3".freeze
-
-    ##
-    # Minimum "recommended" Ruby version (normal maintenance)
-    # @private
-    #
-    RECOMMENDED_VERSION_THRESHOLD = "2.4".freeze
-
-    ##
-    # Check Ruby version and emit a warning if it is old
-    # @private
-    #
-    def self.warn_on_old_ruby_version \
-        supported_version: SUPPORTED_VERSION_THRESHOLD,
-        recommended_version: RECOMMENDED_VERSION_THRESHOLD
-      return if ENV["GOOGLE_CLOUD_SUPPRESS_RUBY_WARNINGS"]
-      cur_version = Gem::Version.new RUBY_VERSION
-      if cur_version < Gem::Version.new(supported_version)
-        warn_unsupported_ruby cur_version, recommended_version
-      elsif cur_version < Gem::Version.new(recommended_version)
-        warn_nonrecommended_ruby cur_version, recommended_version
-      end
-    rescue ArgumentError
-      warn "Unable to determine current Ruby version."
-    end
-
-    ##
-    # Print a warning for an EOL version of Ruby
-    # @private
-    #
-    def self.warn_unsupported_ruby cur_version, recommended_version
-      warn "WARNING: You are running Ruby #{cur_version}, which has reached" \
-        " end-of-life and is no longer supported by Ruby Core."
-      warn "The Google Cloud API clients work best on supported versions of" \
-        " Ruby. It is strongly recommended that you upgrade to Ruby" \
-        " #{recommended_version} or later."
-      warn "See https://www.ruby-lang.org/en/downloads/branches/ for more" \
-        " info on the Ruby maintenance schedule."
-      warn "To suppress this message, set the" \
-        " GOOGLE_CLOUD_SUPPRESS_RUBY_WARNINGS environment variable."
-    end
-
-    ##
-    # Print a warning for a supported but nearing EOL version of Ruby
-    # @private
-    #
-    def self.warn_nonrecommended_ruby cur_version, recommended_version
-      warn "WARNING: You are running Ruby #{cur_version}, which is nearing" \
-        " end-of-life."
-      warn "The Google Cloud API clients work best on supported versions of" \
-        " Ruby. Consider upgrading to Ruby #{recommended_version} or later."
-      warn "See https://www.ruby-lang.org/en/downloads/branches/ for more" \
-        " info on the Ruby maintenance schedule."
-      warn "To suppress this message, set the" \
-        " GOOGLE_CLOUD_SUPPRESS_RUBY_WARNINGS environment variable."
-    end
-
     ##
     # Safely load all google-cloud-* gems.
     # @private
@@ -223,9 +156,7 @@ module Google
     # @private
     #
     def self.auto_load_files
-      if Gem.respond_to? :find_latest_files
-        return Gem.find_latest_files "google-cloud-*.rb"
-      end
+      return Gem.find_latest_files "google-cloud-*.rb" if Gem.respond_to? :find_latest_files
       # Ruby 2.0 does not have Gem.find_latest_files
       Gem.find_files "google-cloud-*.rb"
     end
@@ -235,8 +166,5 @@ end
 # Set the default top-level configuration
 Google::Cloud.init_configuration
 
-# Emit a warning if current Ruby is at or nearing end-of-life
-Google::Cloud.warn_on_old_ruby_version
-
 # Auto-load all Google Cloud service gems.
 Google::Cloud.auto_load_gems

data/lib/google/cloud/config.rb

@@ -308,9 +308,7 @@ module Google
       #
       def [] key
         key = resolve_key! key
-        unless @validators.key? key
-          warn! "Key #{key.inspect} does not exist. Returning nil."
-        end
+        warn! "Key #{key.inspect} does not exist. Returning nil." unless @validators.key? key
         value = @values[key]
         value = value.call if Config::DeferredValue === value
         value
@@ -338,6 +336,7 @@ module Google
       def field? key
         @validators[key.to_sym].is_a? ::Proc
       end
+      alias respond_to? field?
 
       ##
       # Check if the given key has been explicitly added as a subconfig name.
@@ -397,11 +396,12 @@ module Google
       def to_s!
         elems = @validators.keys.map do |k|
           v = @values[k]
-          vstr = Config.config?(v) ? v.to_s! : value.inspect
+          vstr = Config.config?(v) ? v.to_s! : v.inspect
           " #{k}=#{vstr}"
         end
         "<Config:#{elems.join}>"
       end
+      alias inspect to_s!
 
       ##
       # Returns a nested hash representation of this configuration state,
@@ -434,10 +434,10 @@ module Google
           str = data.strip
           return str if ::File.file? str
           json = begin
-                   ::JSON.parse str
-                 rescue ::StandardError
-                   nil
-                 end
+            ::JSON.parse str
+          rescue ::StandardError
+            nil
+          end
           return json if json.is_a? ::Hash
         end
         nil
@@ -458,8 +458,8 @@ module Google
       def method_missing name, *args
         name_str = name.to_s
         super unless name_str =~ /^[a-zA-Z]\w*=?$/
-        if name_str.chomp! "="
-          self[name_str] = args.first
+        if name_str.end_with? "="
+          self[name_str[0...-1]] = args.first
         else
           self[name]
         end
@@ -489,22 +489,22 @@ module Google
       ##
       # @private A validator that allows all values
       #
-      OPEN_VALIDATOR = ::Proc.new { true }
+      OPEN_VALIDATOR = proc { true }
 
       ##
       # @private a list of key names that are technically illegal because
       # they clash with method names.
       #
-      ILLEGAL_KEYS = %i[
-        add_options
-        initialize
-        instance_eval
-        instance_exec
-        method_missing
-        singleton_method_added
-        singleton_method_removed
-        singleton_method_undefined
-      ].freeze
+      ILLEGAL_KEYS = [:add_options,
+                      :initialize,
+                      :inspect,
+                      :instance_eval,
+                      :instance_exec,
+                      :method_missing,
+                      :send,
+                      :singleton_method_added,
+                      :singleton_method_removed,
+                      :singleton_method_undefined].freeze
 
       ##
       # @private sentinel indicating a subconfig in the validators hash
@@ -524,9 +524,7 @@ module Google
           warn! "Illegal key name: #{key_str.inspect}. Method dispatch will" \
                 " not work for this key."
         end
-        if @validators.key? key
-          warn! "Key #{key.inspect} already exists. It will be replaced."
-        end
+        warn! "Key #{key.inspect} already exists. It will be replaced." if @validators.key? key
         key
       end
 

data/lib/google/cloud/core/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Core
-      VERSION = "1.3.1".freeze
+      VERSION = "1.6.0".freeze
     end
   end
 end

data/lib/google/cloud/credentials.rb

@@ -30,12 +30,12 @@ module Google
     # This class is intended to be inherited by API-specific classes
     # which overrides the SCOPE constant.
     class Credentials
-      TOKEN_CREDENTIAL_URI = "https://oauth2.googleapis.com/token"
-      AUDIENCE = "https://oauth2.googleapis.com/token"
-      SCOPE = []
-      PATH_ENV_VARS = %w[GOOGLE_CLOUD_KEYFILE GCLOUD_KEYFILE]
-      JSON_ENV_VARS = %w[GOOGLE_CLOUD_KEYFILE_JSON GCLOUD_KEYFILE_JSON]
-      DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
+      TOKEN_CREDENTIAL_URI = "https://oauth2.googleapis.com/token".freeze
+      AUDIENCE = "https://oauth2.googleapis.com/token".freeze
+      SCOPE = [].freeze
+      PATH_ENV_VARS = ["GOOGLE_CLOUD_KEYFILE", "GCLOUD_KEYFILE"].freeze
+      JSON_ENV_VARS = ["GOOGLE_CLOUD_KEYFILE_JSON", "GCLOUD_KEYFILE_JSON"].freeze
+      DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"].freeze
 
       attr_accessor :client
 
@@ -48,9 +48,10 @@ module Google
 
       def initialize keyfile, scope: nil
         verify_keyfile_provided! keyfile
-        if keyfile.is_a? Signet::OAuth2::Client
+        case keyfile
+        when Signet::OAuth2::Client
           @client = keyfile
-        elsif keyfile.is_a? Hash
+        when Hash
           hash = stringify_hash_keys keyfile
           hash["scope"] ||= scope
           @client = init_client hash
@@ -114,7 +115,7 @@ module Google
       ##
       # returns a new Hash with string keys instead of symbol keys.
       def stringify_hash_keys hash
-        Hash[hash.map { |k, v| [k.to_s, v] }]
+        hash.transform_keys(&:to_s)
       end
 
       def client_options options
@@ -125,10 +126,10 @@ module Google
 
         # client options for initializing signet client
         { token_credential_uri: options["token_credential_uri"],
-          audience: options["audience"],
-          scope: Array(options["scope"]),
-          issuer: options["client_email"],
-          signing_key: OpenSSL::PKey::RSA.new(options["private_key"]) }
+          audience:             options["audience"],
+          scope:                Array(options["scope"]),
+          issuer:               options["client_email"],
+          signing_key:          OpenSSL::PKey::RSA.new(options["private_key"]) }
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-core
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.6.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-23 00:00:00.000000000 Z
+date: 2021-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-env
@@ -26,63 +26,77 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: autotest-suffix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: minitest-autotest
+  name: google-style
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.25.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.25.1
 - !ruby/object:Gem::Dependency
-  name: minitest-focus
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '5.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '5.14'
 - !ruby/object:Gem::Dependency
-  name: minitest-rg
+  name: minitest-autotest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: autotest-suffix
+  name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -96,33 +110,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: redcarpet
+  name: minitest-rg
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '5.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '5.2'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.64.0
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.64.0
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -183,7 +197,6 @@ files:
 - lib/google/cloud/config.rb
 - lib/google/cloud/core/version.rb
 - lib/google/cloud/credentials.rb
-- lib/google/cloud/errors.rb
 homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-core
 licenses:
 - Apache-2.0
@@ -196,14 +209,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
+rubygems_version: 3.2.13
 signing_key: 
 specification_version: 4
 summary: Internal shared library for google-cloud-ruby

data/lib/google/cloud/errors.rb

@@ -1,324 +0,0 @@
-# Copyright 2015 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 "English"
-
-module Google
-  module Cloud
-    ##
-    # Base google-cloud exception class.
-    class Error < StandardError
-      ##
-      # Construct a new Google::Cloud::Error object, optionally passing in a
-      # message.
-      def initialize msg = nil
-        super
-        @cause = $ERROR_INFO
-      end
-
-      # Add Error#cause (introduced in 2.1) to Ruby 2.0.
-      unless respond_to? :cause
-        ##
-        # The previous exception at the time this exception was raised. This is
-        # useful for wrapping exceptions and retaining the original exception
-        # information.
-        define_method :cause do
-          @cause
-        end
-      end
-
-      ##
-      # Returns the value of `status_code` from the underlying cause error
-      # object, if both are present. Otherwise returns `nil`.
-      #
-      # This is typically present on errors originating from calls to an API
-      # over HTTP/REST.
-      #
-      # @return [Object, nil]
-      def status_code
-        return nil unless cause && cause.respond_to?(:status_code)
-        cause.status_code
-      end
-
-      ##
-      # Returns the value of `body` from the underlying cause error
-      # object, if both are present. Otherwise returns `nil`.
-      #
-      # This is typically present on errors originating from calls to an API
-      # over HTTP/REST.
-      #
-      # @return [Object, nil]
-      def body
-        return nil unless cause && cause.respond_to?(:body)
-        cause.body
-      end
-
-      ##
-      # Returns the value of `header` from the underlying cause error
-      # object, if both are present. Otherwise returns `nil`.
-      #
-      # This is typically present on errors originating from calls to an API
-      # over HTTP/REST.
-      #
-      # @return [Object, nil]
-      def header
-        return nil unless cause && cause.respond_to?(:header)
-        cause.header
-      end
-
-      ##
-      # Returns the value of `code` from the underlying cause error
-      # object, if both are present. Otherwise returns `nil`.
-      #
-      # This is typically present on errors originating from calls to an API
-      # over gRPC.
-      #
-      # @return [Object, nil]
-      def code
-        return nil unless cause && cause.respond_to?(:code)
-        cause.code
-      end
-
-      ##
-      # Returns the value of `details` from the underlying cause error
-      # object, if both are present. Otherwise returns `nil`.
-      #
-      # This is typically present on errors originating from calls to an API
-      # over gRPC.
-      #
-      # @return [Object, nil]
-      def details
-        return nil unless cause && cause.respond_to?(:details)
-        cause.details
-      end
-
-      ##
-      # Returns the value of `metadata` from the underlying cause error
-      # object, if both are present. Otherwise returns `nil`.
-      #
-      # This is typically present on errors originating from calls to an API
-      # over gRPC.
-      #
-      # @return [Object, nil]
-      def metadata
-        return nil unless cause && cause.respond_to?(:metadata)
-        cause.metadata
-      end
-
-      ##
-      # Returns the value of `status_details` from the underlying cause error
-      # object, if both are present. Otherwise returns `nil`.
-      #
-      # This is typically present on errors originating from calls to an API
-      # over gRPC.
-      #
-      # @return [Object, nil]
-      def status_details
-        return nil unless cause && cause.respond_to?(:status_details)
-        cause.status_details
-      end
-
-      # @private Create a new error object from a client error
-      def self.from_error error
-        klass = if error.respond_to? :code
-                  grpc_error_class_for error.code
-                elsif error.respond_to? :status_code
-                  gapi_error_class_for error.status_code
-                else
-                  self
-                end
-        klass.new error.message
-      end
-
-      # @private Identify the subclass for a gRPC error
-      def self.grpc_error_class_for grpc_error_code
-        # The gRPC status code 0 is for a successful response.
-        # So there is no error subclass for a 0 status code, use current class.
-        [
-          self, CanceledError, UnknownError, InvalidArgumentError,
-          DeadlineExceededError, NotFoundError, AlreadyExistsError,
-          PermissionDeniedError, ResourceExhaustedError,
-          FailedPreconditionError, AbortedError, OutOfRangeError,
-          UnimplementedError, InternalError, UnavailableError, DataLossError,
-          UnauthenticatedError
-        ][grpc_error_code] || self
-      end
-
-      # @private Identify the subclass for a Google API Client error
-      def self.gapi_error_class_for http_status_code
-        # The http status codes mapped to their error classes.
-        {
-          400 => InvalidArgumentError, # FailedPreconditionError/OutOfRangeError
-          401 => UnauthenticatedError,
-          403 => PermissionDeniedError,
-          404 => NotFoundError,
-          409 => AlreadyExistsError, # AbortedError
-          412 => FailedPreconditionError,
-          429 => ResourceExhaustedError,
-          499 => CanceledError,
-          500 => InternalError, # UnknownError/DataLossError
-          501 => UnimplementedError,
-          503 => UnavailableError,
-          504 => DeadlineExceededError
-        }[http_status_code] || self
-      end
-    end
-
-    ##
-    # Canceled indicates the operation was cancelled (typically by the caller).
-    class CanceledError < Error
-    end
-
-    ##
-    # Unknown error.  An example of where this error may be returned is
-    # if a Status value received from another address space belongs to
-    # an error-space that is not known in this address space.  Also
-    # errors raised by APIs that do not return enough error information
-    # may be converted to this error.
-    class UnknownError < Error
-    end
-
-    ##
-    # InvalidArgument indicates client specified an invalid argument.
-    # Note that this differs from FailedPrecondition. It indicates arguments
-    # that are problematic regardless of the state of the system
-    # (e.g., a malformed file name).
-    class InvalidArgumentError < Error
-    end
-
-    ##
-    # DeadlineExceeded means operation expired before completion.
-    # For operations that change the state of the system, this error may be
-    # returned even if the operation has completed successfully. For
-    # example, a successful response from a server could have been delayed
-    # long enough for the deadline to expire.
-    class DeadlineExceededError < Error
-    end
-
-    ##
-    # NotFound means some requested entity (e.g., file or directory) was
-    # not found.
-    class NotFoundError < Error
-    end
-
-    ##
-    # AlreadyExists means an attempt to create an entity failed because one
-    # already exists.
-    class AlreadyExistsError < Error
-    end
-
-    ##
-    # PermissionDenied indicates the caller does not have permission to
-    # execute the specified operation. It must not be used for rejections
-    # caused by exhausting some resource (use ResourceExhausted
-    # instead for those errors).  It must not be
-    # used if the caller cannot be identified (use Unauthenticated
-    # instead for those errors).
-    class PermissionDeniedError < Error
-    end
-
-    ##
-    # Unauthenticated indicates the request does not have valid
-    # authentication credentials for the operation.
-    class UnauthenticatedError < Error
-    end
-
-    ##
-    # ResourceExhausted indicates some resource has been exhausted, perhaps
-    # a per-user quota, or perhaps the entire file system is out of space.
-    class ResourceExhaustedError < Error
-    end
-
-    ##
-    # FailedPrecondition indicates operation was rejected because the
-    # system is not in a state required for the operation's execution.
-    # For example, directory to be deleted may be non-empty, an rmdir
-    # operation is applied to a non-directory, etc.
-    #
-    # A litmus test that may help a service implementor in deciding
-    # between FailedPrecondition, Aborted, and Unavailable:
-    #  (a) Use Unavailable if the client can retry just the failing call.
-    #  (b) Use Aborted if the client should retry at a higher-level
-    #      (e.g., restarting a read-modify-write sequence).
-    #  (c) Use FailedPrecondition if the client should not retry until
-    #      the system state has been explicitly fixed.  E.g., if an "rmdir"
-    #      fails because the directory is non-empty, FailedPrecondition
-    #      should be returned since the client should not retry unless
-    #      they have first fixed up the directory by deleting files from it.
-    #  (d) Use FailedPrecondition if the client performs conditional
-    #      REST Get/Update/Delete on a resource and the resource on the
-    #      server does not match the condition. E.g., conflicting
-    #      read-modify-write on the same resource.
-    class FailedPreconditionError < Error
-    end
-
-    ##
-    # Aborted indicates the operation was aborted, typically due to a
-    # concurrency issue like sequencer check failures, transaction aborts,
-    # etc.
-    #
-    # See litmus test above for deciding between FailedPrecondition,
-    # Aborted, and Unavailable.
-    class AbortedError < Error
-    end
-
-    ##
-    # OutOfRange means operation was attempted past the valid range.
-    # E.g., seeking or reading past end of file.
-    #
-    # Unlike InvalidArgument, this error indicates a problem that may
-    # be fixed if the system state changes. For example, a 32-bit file
-    # system will generate InvalidArgument if asked to read at an
-    # offset that is not in the range [0,2^32-1], but it will generate
-    # OutOfRange if asked to read from an offset past the current
-    # file size.
-    #
-    # There is a fair bit of overlap between FailedPrecondition and
-    # OutOfRange.  We recommend using OutOfRange (the more specific
-    # error) when it applies so that callers who are iterating through
-    # a space can easily look for an OutOfRange error to detect when
-    # they are done.
-    class OutOfRangeError < Error
-    end
-
-    ##
-    # Unimplemented indicates operation is not implemented or not
-    # supported/enabled in this service.
-    class UnimplementedError < Error
-    end
-
-    ##
-    # Internal errors.  Means some invariants expected by underlying
-    # system has been broken.  If you see one of these errors,
-    # something is very broken.
-    class InternalError < Error
-    end
-
-    ##
-    # Unavailable indicates the service is currently unavailable.
-    # This is a most likely a transient condition and may be corrected
-    # by retrying with a backoff.
-    #
-    # See litmus test above for deciding between FailedPrecondition,
-    # Aborted, and Unavailable.
-    class UnavailableError < Error
-    end
-
-    ##
-    # DataLoss indicates unrecoverable data loss or corruption.
-    class DataLossError < Error
-    end
-  end
-end