google-cloud-core 0.20.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 29d08e42cbb895f42a47e1eedcd28c7b15dd77fa
+  data.tar.gz: f5808aba10c3cf10fd76786e774b878f7ee9925f
+SHA512:
+  metadata.gz: 9e6c3fcc7b93a69cf29254ccef9c5c7b404743cdbc6e05ea1d08ace3a2c79c884c97e9d536e9e99d5259ca441d5e2d72c1df2af1af7df8557ea6cda3ca96b2c2
+  data.tar.gz: ef9af1e66e014e1f92922e6c869798a27294cb11f0b7d2402780603a80a3a1a327ad883c4ec9f4ab63ced13af05740cf105f466c75eb6b5e7ca395e1c4ebc6cf

data/lib/google/cloud.rb

@@ -0,0 +1,75 @@
+# Copyright 2015 Google Inc. All rights reserved.
+#
+# 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.
+
+
+require "google/cloud/core/version"
+
+##
+# # Google Cloud
+#
+# The google-cloud library is the official library for interacting with Google
+# Cloud Platform. Google Cloud Platform is a set of modular cloud-based services
+# that allow you to create anything from simple websites to complex
+# applications.
+#
+# The goal of google-cloud is to provide a API that is familiar and comfortable
+# to Rubyists. Authentication is handled by providing project and credential
+# information, or if you are running on Google Compute Engine this configuration
+# is taken care of for you.
+#
+# You can learn more about various options for connection on the [Authentication
+# Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+#
+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).
+    #
+    # @param [String] project Project identifier for the Pub/Sub service you are
+    #   connecting to.
+    # @param [String, Hash] keyfile Keyfile downloaded from Google Cloud. If
+    #   file path the file must be readable.
+    # @param [Integer] retries Number of times to retry requests on server
+    #   error. The default value is `3`. Optional.
+    # @param [Integer] timeout Default timeout to use in requests. Optional.
+    #
+    # @return [Google::Cloud]
+    #
+    # @example
+    #   require "google/cloud"
+    #
+    #   gcloud  = Google::Cloud.new
+    #   datastore = gcloud.datastore
+    #   pubsub  = gcloud.pubsub
+    #   storage = gcloud.storage
+    #
+    def self.new project = nil, keyfile = nil, retries: nil, timeout: nil
+      gcloud = Object.new
+      gcloud.instance_variable_set "@project", project
+      gcloud.instance_variable_set "@keyfile", keyfile
+      gcloud.instance_variable_set "@retries", retries
+      gcloud.instance_variable_set "@timeout", timeout
+      gcloud.extend Google::Cloud
+      gcloud
+    end
+  end
+end
+
+# Auto-load all Google Cloud service gems.
+Gem.find_files("google-cloud-*.rb").each do |google_cloud_service|
+  require google_cloud_service
+end

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

@@ -0,0 +1,89 @@
+# Copyright 2014 Google Inc. All rights reserved.
+#
+# 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 Google
+  module Cloud
+    module Core
+      ##
+      # @private
+      # Backoff allows users to control how Google API calls are retried.
+      # If an API call fails the response will be checked to see if the
+      # call can be retried. If the response matches the criteria, then it
+      # will be retried with an incremental backoff. This means that an
+      # increasing delay will be added between each retried call. The first
+      # retry will be delayed one second, the second retry will be delayed
+      # two seconds, and so on.
+      class GrpcBackoff
+        class << self
+          ##
+          # The number of times a retriable API call should be retried.
+          #
+          # The default value is `3`.
+          attr_reader :retries
+          def retries= new_retries
+            @retries = new_retries
+          end
+
+          ##
+          # The GRPC Status Codes that should be retried.
+          #
+          # The default values are `14`.
+          attr_accessor :grpc_codes
+
+          ##
+          # The code to run when a backoff is handled.
+          # This must be a Proc and must take the number of
+          # retries as an argument.
+          #
+          # Note: This method is undocumented and may change.
+          attr_accessor :backoff # :nodoc:
+        end
+        # Set the default values
+        self.retries = 3
+        self.grpc_codes = [14]
+        self.backoff = ->(retries) { sleep retries.to_i }
+
+        ##
+        # @private
+        # Creates a new GrpcBackoff object to catch common errors when calling
+        # the Google API and handle the error by retrying the call.
+        #
+        #   Google::Cloud::Core::GrpcBackoff.new(options).execute do
+        #     datastore.lookup lookup_req
+        #   end
+        def initialize options = {}
+          @retries    = (options[:retries]    || GrpcBackoff.retries).to_i
+          @grpc_codes = (options[:grpc_codes] || GrpcBackoff.grpc_codes).to_a
+          @backoff    =  options[:backoff]    || GrpcBackoff.backoff
+        end
+
+        # @private
+        def execute
+          current_retries = 0
+          loop do
+            begin
+              return yield
+            rescue GRPC::BadStatus => e
+              raise e unless @grpc_codes.include?(e.code) &&
+                             (current_retries < @retries)
+              current_retries += 1
+              @backoff.call current_retries
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,60 @@
+# Copyright 2015 Google Inc. All rights reserved.
+#
+# 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.
+
+
+require "faraday"
+
+module Google
+  module Cloud
+    module Core
+      ##
+      # @private
+      # Represents the Google Compute Engine environment.
+      module GCE
+        CHECK_URI = "http://169.254.169.254"
+        PROJECT_URI = "#{CHECK_URI}/computeMetadata/v1/project/project-id"
+
+        def self.gce? options = {}
+          conn = options[:connection] || Faraday.default_connection
+          resp = conn.get CHECK_URI do |req|
+            req.options.timeout = 0.1
+          end
+          return false unless resp.status == 200
+          return false unless resp.headers.key? "Metadata-Flavor"
+          return resp.headers["Metadata-Flavor"] == "Google"
+        rescue Faraday::TimeoutError, Faraday::ConnectionFailed
+          return false
+        end
+
+        def self.project_id options = {}
+          @gce ||= {}
+          return @gce[:project_id] if @gce.key? :project_id
+          conn = options[:connection] || Faraday.default_connection
+          conn.headers = { "Metadata-Flavor" => "Google" }
+          resp = conn.get PROJECT_URI do |req|
+            req.options.timeout = 0.1
+          end
+          if resp.status == 200
+            @gce[:project_id] = resp.body
+          else
+            @gce[:project_id] = nil
+          end
+        rescue Faraday::TimeoutError, Faraday::ConnectionFailed
+          @gce ||= {}
+          @gce[:project_id] = nil
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,89 @@
+# Copyright 2014 Google Inc. All rights reserved.
+#
+# 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 Google
+  module Cloud
+    module Core
+      ##
+      # @private
+      # Backoff allows users to control how Google API calls are retried.
+      # If an API call fails the response will be checked to see if the
+      # call can be retried. If the response matches the criteria, then it
+      # will be retried with an incremental backoff. This means that an
+      # increasing delay will be added between each retried call. The first
+      # retry will be delayed one second, the second retry will be delayed
+      # two seconds, and so on.
+      class GrpcBackoff
+        class << self
+          ##
+          # The number of times a retriable API call should be retried.
+          #
+          # The default value is `3`.
+          attr_reader :retries
+          def retries= new_retries
+            @retries = new_retries
+          end
+
+          ##
+          # The GRPC Status Codes that should be retried.
+          #
+          # The default values are `14`.
+          attr_accessor :grpc_codes
+
+          ##
+          # The code to run when a backoff is handled.
+          # This must be a Proc and must take the number of
+          # retries as an argument.
+          #
+          # Note: This method is undocumented and may change.
+          attr_accessor :backoff # :nodoc:
+        end
+        # Set the default values
+        self.retries = 3
+        self.grpc_codes = [14]
+        self.backoff = ->(retries) { sleep retries.to_i }
+
+        ##
+        # @private
+        # Creates a new Backoff object to catch common errors when calling
+        # the Google API and handle the error by retrying the call.
+        #
+        #   Google::Cloud::Core::GrpcBackoff.new(options).execute do
+        #     datastore.lookup lookup_ref
+        #   end
+        def initialize options = {}
+          @retries    = (options[:retries]    || GrpcBackoff.retries).to_i
+          @grpc_codes = (options[:grpc_codes] || GrpcBackoff.grpc_codes).to_a
+          @backoff    =  options[:backoff]    || GrpcBackoff.backoff
+        end
+
+        # @private
+        def execute
+          current_retries = 0
+          loop do
+            begin
+              return yield
+            rescue GRPC::BadStatus => e
+              raise e unless @grpc_codes.include?(e.code) &&
+                             (current_retries < @retries)
+              current_retries += 1
+              @backoff.call current_retries
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,91 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# 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.
+
+
+require "google/cloud"
+require "google/protobuf/struct_pb"
+
+module Google
+  module Cloud
+    module Core
+      ##
+      # @private Conversion to/from GRPC objects.
+      module GRPCUtils
+        ##
+        # @private Convert a Hash to a Google::Protobuf::Struct.
+        def self.hash_to_struct hash
+          # TODO: ArgumentError if hash is not a Hash
+          Google::Protobuf::Struct.new fields:
+            Hash[hash.map { |k, v| [String(k), object_to_value(v)] }]
+        end
+
+        ##
+        # @private Convert a Google::Protobuf::Struct to a Hash.
+        def self.struct_to_hash struct
+          # TODO: ArgumentError if struct is not a Google::Protobuf::Struct
+          Hash[struct.fields.map { |k, v| [k, value_to_object(v)] }]
+        end
+
+        ##
+        # @private Convert a Google::Protobuf::Value to an Object.
+        def self.value_to_object value
+          # TODO: ArgumentError if struct is not a Google::Protobuf::Value
+          if value.null_value
+            nil
+          elsif value.number_value
+            value.number_value
+          elsif value.struct_value
+            struct_to_hash value.struct_value
+          elsif value.list_value
+            value.list_value.values.map { |v| value_to_object(v) }
+          elsif !value.bool_value.nil? # Make sure its a bool, not nil
+            value.bool_value
+          else
+            nil # just in case
+          end
+        end
+
+        ##
+        # @private Convert an Object to a Google::Protobuf::Value.
+        def self.object_to_value obj
+          case obj
+          when String then Google::Protobuf::Value.new string_value: obj
+          when Array then Google::Protobuf::ListValue.new(values:
+            obj.map { |o| object_to_value(o) })
+          when Hash then Google::Protobuf::Value.new struct_value:
+            hash_to_struct(obj)
+          when Numeric then Google::Protobuf::Value.new number_value: obj
+          when TrueClass then Google::Protobuf::Value.new bool_value: true
+          when FalseClass then Google::Protobuf::Value.new bool_value: false
+          when NilClass then Google::Protobuf::Value.new null_value: :NULL_VALUE
+          else
+            # We could raise ArgumentError here, or we could convert to a string
+            Google::Protobuf::Value.new string_value: obj.to_s
+          end
+        end
+
+        ##
+        # @private Convert a Google::Protobuf::Map to a Hash
+        def self.map_to_hash map
+          if map.respond_to? :to_h
+            map.to_h
+          else
+            # Enumerable doesn't have to_h on ruby 2.0...
+            Hash[map.to_a]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# 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 Google
+  module Cloud
+    module Core
+      VERSION = "0.20.1"
+    end
+  end
+end

data/lib/google/cloud/credentials.rb

@@ -0,0 +1,132 @@
+# Copyright 2014 Google Inc. All rights reserved.
+#
+# 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.
+
+
+require "json"
+require "signet/oauth_2/client"
+require "forwardable"
+require "googleauth"
+
+module Google
+  module Cloud
+    ##
+    # @private
+    # Represents the OAuth 2.0 signing logic.
+    # 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"]
+
+      attr_accessor :client
+
+      ##
+      # Delegate client methods to the client object.
+      extend Forwardable
+      def_delegators :@client,
+                     :token_credential_uri, :audience,
+                     :scope, :issuer, :signing_key
+
+      def initialize keyfile, scope: nil
+        verify_keyfile_provided! keyfile
+        if keyfile.is_a? Signet::OAuth2::Client
+          @client = keyfile
+        elsif keyfile.is_a? Hash
+          hash = stringify_hash_keys keyfile
+          hash["scope"] ||= scope
+          @client = init_client hash
+        else
+          verify_keyfile_exists! keyfile
+          json = JSON.parse ::File.read(keyfile)
+          json["scope"] ||= scope
+          @client = init_client json
+        end
+        @client.fetch_access_token!
+      end
+
+      ##
+      # Returns the default credentials.
+      #
+      def self.default scope: nil
+        env  = ->(v) { ENV[v] }
+        json = ->(v) { JSON.parse ENV[v] rescue nil unless ENV[v].nil? }
+        path = ->(p) { ::File.file? p }
+
+        # First try to find keyfile file from environment variables.
+        self::PATH_ENV_VARS.map(&env).reject(&:nil?).select(&path)
+          .each do |file|
+            return new file, scope: scope
+          end
+        # Second try to find keyfile json from environment variables.
+        self::JSON_ENV_VARS.map(&json).reject(&:nil?).each do |hash|
+          return new hash, scope: scope
+        end
+        # Third try to find keyfile file from known file paths.
+        self::DEFAULT_PATHS.select(&path).each do |file|
+          return new file, scope: scope
+        end
+        # Finally get instantiated client from Google::Auth.
+        scope ||= self::SCOPE
+        client = Google::Auth.get_application_default scope
+        new client
+      end
+
+      protected
+
+      ##
+      # Verify that the keyfile argument is provided.
+      def verify_keyfile_provided! keyfile
+        fail "You must provide a keyfile to connect with." if keyfile.nil?
+      end
+
+      ##
+      # Verify that the keyfile argument is a file.
+      def verify_keyfile_exists! keyfile
+        exists = ::File.file? keyfile
+        fail "The keyfile '#{keyfile}' is not a valid file." unless exists
+      end
+
+      ##
+      # Initializes the Signet client.
+      def init_client keyfile
+        client_opts = client_options keyfile
+        Signet::OAuth2::Client.new client_opts
+      end
+
+      ##
+      # 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] }]
+      end
+
+      def client_options options
+        # Keyfile options have higher priority over constructor defaults
+        options["token_credential_uri"] ||= self.class::TOKEN_CREDENTIAL_URI
+        options["audience"]             ||= self.class::AUDIENCE
+        options["scope"]                ||= self.class::SCOPE
+
+        # 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"]) }
+      end
+    end
+  end
+end

data/lib/google/cloud/errors.rb

@@ -0,0 +1,208 @@
+# Copyright 2015 Google Inc. All rights reserved.
+#
+# 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 Google
+  module Cloud
+    ##
+    # Base google-cloud exception class.
+    class Error < StandardError
+      # @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
+          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

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: google-cloud-core
+version: !ruby/object:Gem::Version
+  version: 0.20.1
+platform: ruby
+authors:
+- Mike Moore
+- Chris Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+- !ruby/object:Gem::Dependency
+  name: minitest-autotest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-focus
+  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: '1.1'
+- !ruby/object:Gem::Dependency
+  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: 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: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 0.35.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 0.35.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: google-cloud-core is the internal shared library for google-cloud-ruby.
+email:
+- mike@blowmage.com
+- quartzmo@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/google/cloud.rb
+- lib/google/cloud/core/backoff.rb
+- lib/google/cloud/core/gce.rb
+- lib/google/cloud/core/grpc_backoff.rb
+- lib/google/cloud/core/grpc_utils.rb
+- lib/google/cloud/core/version.rb
+- lib/google/cloud/credentials.rb
+- lib/google/cloud/errors.rb
+homepage: http://googlecloudplatform.github.io/google-cloud-ruby/
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.4
+signing_key: 
+specification_version: 4
+summary: Internal shared library for google-cloud-ruby
+test_files: []