google-cloud-core 1.2.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd3cf2a2e538cb37ffd2daae810180a7cf19dcad051f1fdce8d6b6c6dd13a566
-  data.tar.gz: e197ffcd7a014052eaeabba0f744ce0c3c86da7be88639bd9e91338eb122b7e4
+  metadata.gz: 0da3f7e70a825960a1eefff5508fadf4e4e58005a16c1ee0cf3f1c9f04af65bb
+  data.tar.gz: 82b1d53b8a7339152f8a65a2c0ded58ac4edc1549c24eeff03c9bdaae0f10c56
 SHA512:
-  metadata.gz: 27e11063ff53977170fa53a5559d272ac324225ee0ee9bc85f2b696b5b6f31f0719b605283eae7b73d12808a8326a97f9dd5308d89fab5b89df22dac5fdca8b3
-  data.tar.gz: 4ba78b2ef42de56f09660dd30c40eee1fcd7c74a6ba5c57fc126dcd05cb9af59e9087caa8f9745a44f8e332c67a6e8b16252ef8f600655ff811c74314635011b
+  metadata.gz: 9c29b01b9004f1cbe7a93a56e69286bce35a582f012ba819876f41667dc8b7b19d92c4f1108c314099d56882c9fe1022fe4a38d05dd76a70fda5bd48d78a0365
+  data.tar.gz: af2334493f6309401623c8c3c6b4712f421a3ce12563b1cf6a8ffa5dc03380e8afb043590d0a56fe397ef645aa89458af57df718cf0fd9a01f2ac5291fb09ed1

data/.yardopts

@@ -1,7 +1,12 @@
 --no-private
 --title=Google Cloud Core
 --markup markdown
+--markup-provider redcarpet
 
 ./lib/**/*.rb
 -
 README.md
+AUTHENTICATION.md
+CONTRIBUTING.md
+CODE_OF_CONDUCT.md
+LICENSE

data/AUTHENTICATION.md

@@ -0,0 +1,41 @@
+## With `google-cloud-ruby`
+
+With `google-cloud-ruby` it's incredibly easy to get authenticated and start using Google's APIs. You can set your credentials on a global basis as well as on a per-API basis.
+
+### Google Cloud Platform environments
+
+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
+
+The google-cloud library aims to make authentication as simple as possible, and provides several mechanisms to configure your system without providing **Project ID** and **Service Account Credentials** directly in code.
+
+**Project ID** is discovered in the following order:
+
+1. Specify project ID in code
+2. Discover project ID in environment variables
+3. Discover GCE project ID
+
+**Credentials** are discovered in the following order:
+
+1. Specify credentials in code
+2. Discover credentials path in environment variables
+3. Discover credentials JSON in environment variables
+4. Discover credentials file in the Cloud SDK's path
+5. Discover GCE credentials
+
+### Environment Variables
+
+The **Project ID** and **Credentials JSON** can be placed in environment variables instead of declaring them directly in code. Each service has its own environment variable, allowing for different service accounts to be used for different services. The path to the **Credentials JSON** file can be stored in the environment variable, or the **Credentials JSON** itself can be stored for environments such as Docker containers where writing files is difficult or not encouraged.
+
+Here are the environment variables (in the order they are checked) for project ID:
+
+1. `GOOGLE_CLOUD_PROJECT`
+
+Here are the environment variables (in the order they are checked) for credentials:
+
+1. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file
+2. `GOOGLE_CLOUD_KEYFILE_JSON` - JSON contents
+
+
+

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,40 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct. By adopting this Code of Conduct, project
+maintainers commit themselves to fairly and consistently applying these
+principles to every aspect of managing this project. Project maintainers who do
+not follow or enforce the Code of Conduct may be permanently removed from the
+project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by opening an issue or contacting one or more of the project
+maintainers.
+
+This Code of Conduct is adapted from the [Contributor
+Covenant](http://contributor-covenant.org), version 1.2.0, available at
+[http://contributor-covenant.org/version/1/2/0/](http://contributor-covenant.org/version/1/2/0/)

data/CONTRIBUTING.md

@@ -0,0 +1,141 @@
+# Contributing to Google Cloud
+
+1. **Sign one of the contributor license agreements below.**
+2. Fork the repo, develop and test your code changes.
+3. Send a pull request.
+
+## Contributor License Agreements
+
+Before we can accept your pull requests you'll need to sign a Contributor
+License Agreement (CLA):
+
+- **If you are an individual writing original source code** and **you own the
+  intellectual property**, then you'll need to sign an [individual
+  CLA](https://developers.google.com/open-source/cla/individual).
+- **If you work for a company that wants to allow you to contribute your work**,
+  then you'll need to sign a [corporate
+  CLA](https://developers.google.com/open-source/cla/corporate).
+
+You can sign these electronically (just scroll to the bottom). After that, we'll
+be able to accept your pull requests.
+
+## Setup
+
+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.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).
+
+2. Install [Bundler](http://bundler.io/).
+
+   ```sh
+   $ gem install bundler
+   ```
+
+3. Install the top-level project dependencies.
+
+   ```sh
+   $ bundle install
+   ```
+
+4. Install the Google Cloud dependencies.
+
+   ```sh
+   $ cd google-cloud-core/
+   $ bundle install
+   ```
+
+## Console
+
+In order to run code interactively, you can automatically load
+google-cloud and its dependencies in IRB. This requires that your
+developer environment has already been configured by following the steps
+described in the {file:AUTHENTICATION.md Authentication Guide}. An IRB console
+can be created with:
+
+```sh
+$ cd google-cloud-core/
+$ bundle exec rake console
+```
+
+## Google Cloud Tests
+
+Tests are very important part of google-cloud. All contributions
+should include tests that ensure the contributed code behaves as expected.
+
+To run the unit tests, documentation tests, and code style checks together for a
+package:
+
+``` sh
+$ cd google-cloud-core/
+$ bundle exec rake ci
+```
+
+To run the command above, plus all acceptance tests, use `rake ci:acceptance` or
+its handy alias, `rake ci:a`.
+
+### Google Cloud Unit Tests
+
+
+The project uses the [minitest](https://github.com/seattlerb/minitest) library,
+including [specs](https://github.com/seattlerb/minitest#specs),
+[mocks](https://github.com/seattlerb/minitest#mocks) and
+[minitest-autotest](https://github.com/seattlerb/minitest-autotest).
+
+To run the Google Cloud unit tests:
+
+``` sh
+$ cd google-cloud-core/
+$ bundle exec rake test
+```
+
+### Google Cloud Documentation Tests
+
+The project tests the code examples in the gem's
+[YARD](https://github.com/lsegal/yard)-based documentation.
+
+The example testing functions in a way that is very similar to unit testing, and
+in fact the library providing it,
+[yard-doctest](https://github.com/p0deje/yard-doctest), is based on the
+project's unit test library, [minitest](https://github.com/seattlerb/minitest).
+
+To run the Google Cloud documentation tests:
+
+``` sh
+$ cd google-cloud-core/
+$ bundle exec rake doctest
+```
+
+If you add, remove or modify documentation examples when working on a pull
+request, you may need to update the setup for the tests. The stubs and mocks
+required to run the tests are located in `support/doctest_helper.rb`. Please
+note that much of the setup is matched by the title of the
+[`@example`](http://www.rubydoc.info/gems/yard/file/docs/Tags.md#example) tag.
+If you alter an example's title, you may encounter breaking tests.
+
+## Coding Style
+
+Please follow the established coding style in the library. The style is is
+largely based on [The Ruby Style
+Guide](https://github.com/bbatsov/ruby-style-guide) with a few exceptions based
+on seattle-style:
+
+* Avoid parenthesis when possible, including in method definitions.
+* Always use double quotes strings. ([Option
+  B](https://github.com/bbatsov/ruby-style-guide#strings))
+
+You can check your code against these rules by running Rubocop like so:
+
+```sh
+$ cd google-cloud-core/
+$ bundle exec rake rubocop
+```
+
+## Code of Conduct
+
+Please note that this project is released with a Contributor Code of Conduct. By
+participating in this project you agree to abide by its terms. See
+{file:CODE_OF_CONDUCT.md Code of Conduct} for more information.

data/README.md

@@ -1,32 +1,52 @@
 # google-cloud-core
 
-This library contains shared types, such as error classes, for the google-cloud project. Please see the top-level project [README](../README.md) for general information.
+This library contains shared types, such as error classes, for the google-cloud
+project. Please see the [GitHub
+repository](https://github.com/googleapis/google-cloud-ruby) for more
+information about the individual google-cloud gems.
 
-- [google-cloud-core API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-core/latest)
+- [google-cloud-core API documentation](https://googleapis.dev/ruby/google-cloud-core/latest)
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.0+.
+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.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.
 
 ## Versioning
 
 This library follows [Semantic Versioning](http://semver.org/).
 
-It is currently in major version zero (0.y.z), which means that anything may change at any time and the public API should not be considered stable.
+It is currently in major version zero (0.y.z), which means that anything may
+change at any time and the public API should not be considered stable.
 
 ## Contributing
 
 Contributions to this library are always welcome and highly encouraged.
 
-See the [Contributing Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/contributing) for more information on how to get started.
+See the [Contributing
+Guide](https://googleapis.dev/ruby/google-cloud-core/latest/file.CONTRIBUTING.html)
+for more information on how to get started.
 
-Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct](../CODE_OF_CONDUCT.md) for more information.
+Please note that this project is released with a Contributor Code of Conduct. By
+participating in this project you agree to abide by its terms. See [Code of
+Conduct](https://googleapis.dev/ruby/google-cloud-core/latest/file.CODE_OF_CONDUCT.html)
+for more information.
 
 ## License
 
-This library is licensed under Apache 2.0. Full license text is available in [LICENSE](LICENSE).
+This library is licensed under Apache 2.0. Full license text is available in
+[LICENSE](https://googleapis.dev/ruby/google-cloud-core/latest/file.LICENSE.html).
 
 ## Support
 
-Please [report bugs at the project on Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues).
-Don't hesitate to [ask questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby) about the client or APIs on [StackOverflow](http://stackoverflow.com).
+Please [report bugs at the project on
+Github](https://github.com/googleapis/google-cloud-ruby/issues). Don't
+hesitate to [ask
+questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby)
+about the client or APIs on [StackOverflow](http://stackoverflow.com).

data/lib/google/cloud.rb

@@ -30,19 +30,15 @@ require "google/cloud/core/version"
 # App Engine and Google Kubernetes Engine. In other environments you can
 # configure authentication easily, either directly in your code or via
 # environment variables. Read more about the options for connecting in the
-# [Authentication
-# Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
-#
-# You can learn more about various options for connection on the [Authentication
-# Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+# {file:AUTHENTICATION.md Authentication Guide}.
 #
 module Google
   module Cloud
     ##
     # Creates a new object for connecting to Google Cloud.
     #
-    # For more information on connecting to Google Cloud see the [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+    # For more information on connecting to Google Cloud see the
+    # {file:AUTHENTICATION.md Authentication Guide}.
     #
     # @param [String] project_id Project identifier for the service you are
     #   connecting to.
@@ -85,6 +81,9 @@ module Google
     #                 when running from GCP environments.
     # * `credentials`: The service account JSON file path. Automatically
     #                  discovered when running from GCP environments.
+    # * `on_error`: A Proc to be run when an error is encountered during on a
+    #               background thread. The Proc must take the error object as
+    #               the single argument.
     #
     # @return [Google::Cloud::Config] The top-level configuration object for
     #     Google::Cloud libraries.
@@ -96,28 +95,76 @@ module Google
 
       @config
     end
+
+    ##
+    # Initialize toplevel configuration
+    # @private
+    #
+    def self.init_configuration
+      configure do |config|
+        default_project = Google::Cloud::Config.deferred do
+          ENV["GOOGLE_CLOUD_PROJECT"] || ENV["GCLOUD_PROJECT"]
+        end
+        default_creds = Google::Cloud::Config.deferred do
+          Google::Cloud::Config.credentials_from_env \
+            "GOOGLE_CLOUD_CREDENTIALS", "GOOGLE_CLOUD_CREDENTIALS_JSON",
+            "GOOGLE_CLOUD_KEYFILE", "GOOGLE_CLOUD_KEYFILE_JSON",
+            "GCLOUD_KEYFILE", "GCLOUD_KEYFILE_JSON"
+        end
+
+        config.add_field! :project_id, default_project,
+                          match: String, allow_nil: true
+        config.add_alias! :project, :project_id
+        config.add_field! :credentials, default_creds, match: Object
+        config.add_alias! :keyfile, :credentials
+        config.add_field! :on_error, nil, match: Proc
+      end
+    end
+
+    ##
+    # Safely load all google-cloud-* gems.
+    # @private
+    #
+    def self.auto_load_gems
+      currently_loaded_files = loaded_files
+
+      auto_load_files.each do |auto_load_file|
+        auto_load_file = File.realpath auto_load_file
+        next if currently_loaded_files.include? auto_load_file
+        require auto_load_file
+      end
+    end
+
+    ##
+    # Find files that are currently loaded.
+    # @private
+    #
+    def self.loaded_files
+      files = Array(caller).map do |backtrace_line|
+        until backtrace_line.split(":").size < 2 || File.file?(backtrace_line)
+          backtrace_line = backtrace_line.split(":")[0..-2].join ":"
+        end
+        backtrace_line
+      end
+      files.uniq!
+      files.select! { |file| File.file? file }
+      files.map { |file| File.realpath file }
+    end
+
+    ##
+    # Find all google-cloud-* files for available gems.
+    # @private
+    #
+    def self.auto_load_files
+      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
   end
 end
 
 # Set the default top-level configuration
-Google::Cloud.configure do |config|
-  default_project = Google::Cloud::Config.deferred do
-    ENV["GOOGLE_CLOUD_PROJECT"] || ENV["GCLOUD_PROJECT"]
-  end
-  default_creds = Google::Cloud::Config.deferred do
-    Google::Cloud::Config.credentials_from_env \
-      "GOOGLE_CLOUD_CREDENTIALS", "GOOGLE_CLOUD_CREDENTIALS_JSON",
-      "GOOGLE_CLOUD_KEYFILE", "GOOGLE_CLOUD_KEYFILE_JSON",
-      "GCLOUD_KEYFILE", "GCLOUD_KEYFILE_JSON"
-  end
-
-  config.add_field! :project_id, default_project, match: String, allow_nil: true
-  config.add_alias! :project, :project_id
-  config.add_field! :credentials, default_creds, match: Object
-  config.add_alias! :keyfile, :credentials
-end
+Google::Cloud.init_configuration
 
 # Auto-load all Google Cloud service gems.
-Gem.find_files("google-cloud-*.rb").each do |google_cloud_service|
-  require google_cloud_service
-end
+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,
@@ -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.2.0".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://accounts.google.com/o/oauth2/token"
-      AUDIENCE = "https://accounts.google.com/o/oauth2/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.2.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-27 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: '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: '5.10'
+        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,19 +110,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: minitest-rg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -141,16 +169,16 @@ dependencies:
   name: yard-doctest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.8
+        version: 0.1.13
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.8
+        version: 0.1.13
 description: google-cloud-core is the internal shared library for google-cloud-ruby.
 email:
 - mike@blowmage.com
@@ -160,14 +188,16 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
+- AUTHENTICATION.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
 - LICENSE
 - README.md
 - lib/google/cloud.rb
 - 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/GoogleCloudPlatform/google-cloud-ruby/tree/master/google-cloud-core
+homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-core
 licenses:
 - Apache-2.0
 metadata: {}
@@ -179,15 +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: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+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.
-      #
-      # @returns [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.
-      #
-      # @returns [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.
-      #
-      # @returns [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.
-      #
-      # @returns [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.
-      #
-      # @returns [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.
-      #
-      # @returns [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.
-      #
-      # @returns [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