google-cloud-storage 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32043f65423a16e46517e97ba6bac2a1274c65c8e2de2a65aa2b943441d81450
-  data.tar.gz: 877e9fae1ca774a7a96b9cd22c65f3510b6ff69e572d76ba00774c82b584cb5e
+  metadata.gz: 95278f620e42cb0c09f509e972b2aac94204cd0435a7b824d561903d7dc3f455
+  data.tar.gz: 04410bfcf4d0cf2ce2b4b0db9e4f653122a7dded2ce460dac8ba5a97fc288a74
 SHA512:
-  metadata.gz: 403cc31cb8f15f14d247683926e64c2199b11ddcf40e8971515522ff0b4b0f231ebbeb666d467af9d92712c7ce456a1b6f546ca79c644ec4e2bbc2784e722875
-  data.tar.gz: 01e66c191a69e1de2e4badc0719c218a53c2a9ab1c9eddb2c9a1c8ae20bbae92e86fa15c922e48cb83e875cfe36fb7db407431935ae519cc34d840376577b4e6
+  metadata.gz: 45c6bcb301c44151f4069cf648420f4b411e2662e843cc965105b8bf7f4e3a5f9072aaada1437ecda3df64fffcc4975a96694703f812278f37a24f5820df5d32
+  data.tar.gz: 9204c51ae1a9e967714db5fdee82f3f33c21cc879ccc7530013c861d1f015960ee6783f92dd37d96f5b3c07164314755d93dd7380a7deac75fd8ffe118f96de2

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release History
 
+### 1.20.0 / 2019-08-08
+
+* Add HmacKey
+  * Add Project#create_hmac_key, Project#hmac_key, and Project#hmac_keys.
+* Update documentation listings of current and legacy storage classes.
+* Fix File#download to use generation from current File object.
+
 ### 1.19.0 / 2019-07-11
 
 * Add Bucket#location_type

data/LOGGING.md

@@ -6,7 +6,7 @@ Client](https://github.com/google/google-api-ruby-client/blob/master/README.md#l
 library. The logger that you set may be a Ruby stdlib
 [`Logger`](https://ruby-doc.org/stdlib-2.4.0/libdoc/logger/rdoc/Logger.html) as
 shown below, or a
-[`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger)
+[`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Stackdriver
 Logging](https://cloud.google.com/logging/).
 

data/lib/google/cloud/storage/bucket.rb

@@ -357,8 +357,9 @@ module Google
         ##
         # The bucket's storage class. This defines how objects in the bucket are
         # stored and determines the SLA and the cost of storage. Values include
-        # `MULTI_REGIONAL`, `REGIONAL`, `NEARLINE`, `COLDLINE`, and
-        # `DURABLE_REDUCED_AVAILABILITY`.
+        # `STANDARD`, `NEARLINE`, and `COLDLINE`. `REGIONAL`,`MULTI_REGIONAL`,
+        # and `DURABLE_REDUCED_AVAILABILITY` are supported as legacy storage
+        # classes.
         #
         # @return [String]
         #
@@ -370,8 +371,10 @@ module Google
         # Updates the bucket's storage class. This defines how objects in the
         # bucket are stored and determines the SLA and the cost of storage.
         # Accepted values include `:standard`, `:nearline`, and `:coldline`, as
-        # well as the equivalent strings returned by {Bucket#storage_class}. For
-        # more information, see [Storage
+        # well as the equivalent strings returned by {Bucket#storage_class}.
+        # `:multi_regional`, `:regional`, and  `durable_reduced_availability`
+        # are accepted as legacy storage classes. For more information, see
+        # [Storage
         # Classes](https://cloud.google.com/storage/docs/storage-classes).
         #
         # @param [Symbol, String] new_storage_class Storage class of the bucket.
@@ -1137,7 +1140,9 @@ module Google
         #   Determines how the file is stored and determines the SLA and the
         #   cost of storage. Accepted values include `:standard`, `:nearline`,
         #   and `:coldline`, as well as the equivalent strings returned by
-        #   {#storage_class}. For more information, see [Storage
+        #   {#storage_class}. `:multi_regional`, `:regional`, and
+        #   `durable_reduced_availability` are accepted legacy storage classes.
+        #   For more information, see [Storage
         #   Classes](https://cloud.google.com/storage/docs/storage-classes)
         #   and [Per-Object Storage
         #   Class](https://cloud.google.com/storage/docs/per-object-storage-class).

data/lib/google/cloud/storage/file.rb

@@ -937,8 +937,8 @@ module Google
           end
           file, resp =
             service.download_file bucket, name, path,
-                                  key: encryption_key, range: range,
-                                  user_project: user_project
+                                  generation: generation, key: encryption_key,
+                                  range: range, user_project: user_project
           # FIX: downloading with encryption key will return nil
           file ||= ::File.new path
           verify = :none if range

data/lib/google/cloud/storage/file/signer_v4.rb

@@ -122,9 +122,10 @@ module Google
           def canonical_and_signed_headers headers
             # Headers needs to be in alpha order.
             canonical_headers = headers || {}
-            canonical_headers = Hash[canonical_headers.map do |k, v|
-                                       [k.downcase, v.strip.gsub(/\s+/, " ")]
-                                     end]
+            headers_arr = canonical_headers.map do |k, v|
+              [k.downcase, v.strip.gsub(/[^\S\t]+/, " ").gsub(/\t+/, "\t")]
+            end
+            canonical_headers = Hash[headers_arr]
             canonical_headers["host"] = "storage.googleapis.com"
 
             canonical_headers = canonical_headers.sort_by do |k, _|

data/lib/google/cloud/storage/hmac_key.rb

@@ -0,0 +1,316 @@
+# Copyright 2019 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "google/cloud/storage/hmac_key/list"
+
+module Google
+  module Cloud
+    module Storage
+      ##
+      # # HmacKey
+      #
+      # Represents the metadata for an HMAC key, and also includes the key's
+      # secret if returned by the {Project#create_hmac_key} creation method.
+      #
+      # @see https://cloud.google.com/storage/docs/migrating#migration-simple
+      #   Migrating from Amazon S3 to Cloud Storage - Simple migration
+      #
+      # @attr_reader [String, nil] secret HMAC secret key material, or `nil` if
+      #   the key was not returned by the {Project#create_hmac_key} creation
+      #   method.
+      #
+      # @example
+      #   require "google/cloud/storage"
+      #
+      #   storage = Google::Cloud::Storage.new
+      #
+      #   service_account_email = "my_account@developer.gserviceaccount.com"
+      #   hmac_key = storage.create_hmac_key service_account_email
+      #   hmac_key.secret # ...
+      #
+      #   hmac_key = storage.hmac_key hmac_key.access_id
+      #   hmac_key.secret # nil
+      #
+      #   hmac_key.inactive!
+      #   hmac_key.delete
+      #
+      class HmacKey
+        ##
+        # @private The Connection object.
+        attr_accessor :service
+
+        ##
+        # @private The Google API Client object.
+        attr_accessor :gapi
+
+        ##
+        # @private A boolean value or a project ID string to indicate the
+        # project to be billed for operations.
+        attr_accessor :user_project
+
+        attr_reader :secret
+
+        ##
+        # @private Creates an HmacKey object.
+        def initialize
+          @bucket = nil
+          @service = nil
+          @gapi = nil
+          @user_project = nil
+        end
+
+        ##
+        # The ID of the HMAC Key.
+        #
+        # @return [String]
+        #
+        def access_id
+          @gapi.access_id
+        end
+
+        ##
+        # A URL that can be used to access the HMAC key using the REST API.
+        #
+        # @return [String]
+        #
+        def api_url
+          @gapi.self_link
+        end
+
+        ##
+        # Creation time of the HMAC key.
+        #
+        # @return [String]
+        #
+        def created_at
+          @gapi.time_created
+        end
+
+        ##
+        # HTTP 1.1 Entity tag for the HMAC key.
+        #
+        # @return [String]
+        #
+        def etag
+          @gapi.etag
+        end
+
+        ##
+        # The ID of the HMAC key, including the Project ID and the Access ID.
+        #
+        # @return [String]
+        #
+        def id
+          @gapi.id
+        end
+
+        ##
+        # Project ID owning the service account to which the key authenticates.
+        #
+        # @return [String]
+        #
+        def project_id
+          @gapi.project_id
+        end
+
+        ##
+        # The email address of the key's associated service account.
+        #
+        # @return [String]
+        #
+        def service_account_email
+          @gapi.service_account_email
+        end
+
+        ##
+        # The state of the key. Can be one of `ACTIVE`, `INACTIVE`, or
+        # `DELETED`.
+        #
+        # @return [String]
+        #
+        def state
+          @gapi.state
+        end
+
+        ##
+        # Last modification time of the HMAC key metadata.
+        #
+        # @return [String]
+        #
+        def updated_at
+          @gapi.updated
+        end
+
+        ##
+        # Whether the state of the HMAC key is `ACTIVE`.
+        #
+        # @return [Boolean]
+        #
+        def active?
+          state == "ACTIVE"
+        end
+
+        ##
+        # Updates the state of the HMAC key to `ACTIVE`.
+        #
+        # @return [Google::Cloud::Storage::HmacKey] Returns the HMAC key for
+        #   method chaining.
+        #
+        # @example
+        #   require "google/cloud/storage"
+        #
+        #   storage = Google::Cloud::Storage.new
+        #
+        #   hmac_key = storage.hmac_keys.first
+        #
+        #   hmac_key.active!
+        #   hmac_key.state # "ACTIVE"
+        #
+        def active!
+          put_gapi! "ACTIVE"
+          self
+        end
+
+        ##
+        # Whether the state of the HMAC key is `INACTIVE`.
+        #
+        # @return [Boolean]
+        #
+        def inactive?
+          state == "INACTIVE"
+        end
+
+        ##
+        # Updates the state of the HMAC key to `INACTIVE`.
+        #
+        # @return [Google::Cloud::Storage::HmacKey] Returns the HMAC key for
+        #   method chaining.
+        #
+        # @example
+        #   require "google/cloud/storage"
+        #
+        #   storage = Google::Cloud::Storage.new
+        #
+        #   hmac_key = storage.hmac_keys.first
+        #
+        #   hmac_key.inactive!
+        #   hmac_key.state # "INACTIVE"
+        #
+        def inactive!
+          put_gapi! "INACTIVE"
+          self
+        end
+
+        ##
+        # Whether the state of the HMAC key is `DELETED`.
+        #
+        # @return [Boolean]
+        #
+        def deleted?
+          state == "DELETED"
+        end
+
+        ##
+        # Deletes the HMAC key, and loads the new state of the HMAC key,
+        # which will be `DELETED`.
+        #
+        # The API call to delete the HMAC key may be retried under certain
+        # conditions. See {Google::Cloud#storage} to control this behavior.
+        #
+        # @return [Google::Cloud::Storage::HmacKey] Returns the HMAC key for
+        #   method chaining.
+        #
+        # @example
+        #   require "google/cloud/storage"
+        #
+        #   storage = Google::Cloud::Storage.new
+        #
+        #   hmac_key = storage.hmac_keys.first
+        #
+        #   hmac_key.inactive!.delete!
+        #
+        def delete!
+          ensure_service!
+          @service.delete_hmac_key access_id,
+                                   project_id: project_id,
+                                   user_project: @user_project
+          @gapi = @service.get_hmac_key access_id, project_id: project_id,
+                                                   user_project: @user_project
+          self
+        end
+        alias delete delete!
+
+        ##
+        # Reloads the HMAC key with current data from the Storage service.
+        #
+        def reload!
+          ensure_service!
+          @gapi = service.get_hmac_key access_id, project_id: project_id,
+                                                  user_project: user_project
+          self
+        end
+        alias refresh! reload!
+
+        ##
+        # @private New HmacKey from a Google::Apis::StorageV1::HmacKey object.
+        #
+        # @param [Google::Apis::StorageV1::HmacKey] gapi
+        #
+        #
+        def self.from_gapi gapi, service, user_project: nil
+          hmac_key = from_gapi_metadata gapi.metadata,
+                                        service,
+                                        user_project: user_project
+          hmac_key.tap do |f|
+            f.instance_variable_set :@secret, gapi.secret
+          end
+        end
+
+        ##
+        # @private New HmacKey from a Google::Apis::StorageV1::HmacKeyMetadata
+        # object.
+        #
+        # @param [Google::Apis::StorageV1::HmacKeyMetadata] gapi
+        #
+        #
+        def self.from_gapi_metadata gapi, service, user_project: nil
+          new.tap do |f|
+            f.gapi = gapi
+            f.service = service
+            f.user_project = user_project
+          end
+        end
+
+        protected
+
+        ##
+        # Raise an error unless an active service is available.
+        def ensure_service!
+          raise "Must have active connection" unless service
+        end
+
+        def put_gapi! new_state
+          ensure_service!
+          put_gapi = @gapi.dup
+          put_gapi.state = new_state
+          @gapi = service.update_hmac_key access_id, put_gapi,
+                                          project_id: project_id,
+                                          user_project: @user_project
+          self
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/storage/hmac_key/list.rb

@@ -0,0 +1,182 @@
+# Copyright 2019 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "delegate"
+
+module Google
+  module Cloud
+    module Storage
+      class HmacKey
+        ##
+        # HmacKey::List is a special case Array with additional values.
+        class List < DelegateClass(::Array)
+          ##
+          # If not empty, indicates that there are more HMAC keys
+          # that match the request and this value should be passed to
+          # the next {Google::Cloud::Storage::Project#hmac_keys} to continue.
+          attr_accessor :token
+
+          ##
+          # @private Create a new HmacKey::List with an array of values.
+          def initialize arr = []
+            super arr
+          end
+
+          ##
+          # Whether there is a next page of HMAC keys.
+          #
+          # @return [Boolean]
+          #
+          # @example
+          #   require "google/cloud/storage"
+          #
+          #   storage = Google::Cloud::Storage.new
+          #
+          #   hmac_keys = storage.hmac_keys
+          #   if hmac_keys.next?
+          #     next_hmac_keys = hmac_keys.next
+          #   end
+          #
+          def next?
+            !token.nil?
+          end
+
+          ##
+          # Retrieve the next page of HMAC keys.
+          #
+          # @return [HmacKey::List]
+          #
+          # @example
+          #   require "google/cloud/storage"
+          #
+          #   storage = Google::Cloud::Storage.new
+          #
+          #   hmac_keys = storage.hmac_keys
+          #   if hmac_keys.next?
+          #     next_hmac_keys = hmac_keys.next
+          #   end
+          #
+          def next
+            return nil unless next?
+            ensure_service!
+            gapi = @service.list_hmac_keys \
+              service_account_email: @service_account_email,
+              show_deleted_keys: @show_deleted_keys, token: @token, max: @max,
+              user_project: @user_project
+
+            HmacKey::List.from_gapi \
+              gapi, @service,
+              service_account_email: @service_account_email,
+              show_deleted_keys: @show_deleted_keys, max: @max,
+              user_project: @user_project
+          end
+
+          ##
+          # Retrieves remaining results by repeatedly invoking {#next} until
+          # {#next?} returns `false`. Calls the given block once for each
+          # result, which is passed as the argument to the block.
+          #
+          # An Enumerator is returned if no block is given.
+          #
+          # This method will make repeated API calls until all remaining results
+          # are retrieved. (Unlike `#each`, for example, which merely iterates
+          # over the results returned by a single API call.) Use with caution.
+          #
+          # @param [Integer] request_limit The upper limit of API requests to
+          #   make to load all HMAC keys. Default is no limit.
+          # @yield [key] The block for accessing each HMAC key.
+          # @yieldparam [HmacKey] key The HMAC key object.
+          #
+          # @return [Enumerator]
+          #
+          # @example Iterating each HMAC key by passing a block:
+          #   require "google/cloud/storage"
+          #
+          #   storage = Google::Cloud::Storage.new
+          #
+          #   hmac_keys = storage.hmac_keys
+          #   hmac_keys.all do |key|
+          #     puts key.access_id
+          #   end
+          #
+          # @example Using the enumerator by not passing a block:
+          #   require "google/cloud/storage"
+          #
+          #   storage = Google::Cloud::Storage.new
+          #
+          #   hmac_keys = storage.hmac_keys
+          #   all_names = hmac_keys.all.map do |key|
+          #     key.access_id
+          #   end
+          #
+          # @example Limit the number of API calls made:
+          #   require "google/cloud/storage"
+          #
+          #   storage = Google::Cloud::Storage.new
+          #
+          #   hmac_keys = storage.hmac_keys
+          #   hmac_keys.all(request_limit: 10) do |key|
+          #     puts key.access_id
+          #   end
+          #
+          def all request_limit: nil
+            request_limit = request_limit.to_i if request_limit
+            unless block_given?
+              return enum_for :all, request_limit: request_limit
+            end
+            results = self
+            loop do
+              results.each { |r| yield r }
+              if request_limit
+                request_limit -= 1
+                break if request_limit < 0
+              end
+              break unless results.next?
+              results = results.next
+            end
+          end
+
+          ##
+          # @private New HmacKey::List from a Google API Client
+          # Google::Apis::StorageV1::HmacKeysMetadata object.
+          def self.from_gapi gapi_list, service, service_account_email: nil,
+                             show_deleted_keys: nil, max: nil, user_project: nil
+            hmac_keys = new(Array(gapi_list.items).map do |gapi_object|
+              HmacKey.from_gapi_metadata gapi_object, service,
+                                         user_project: user_project
+            end)
+            hmac_keys.instance_variable_set :@token, gapi_list.next_page_token
+            hmac_keys.instance_variable_set :@service, service
+            hmac_keys.instance_variable_set :@service_account_email,
+                                            service_account_email
+            hmac_keys.instance_variable_set :@show_deleted_keys,
+                                            show_deleted_keys
+            hmac_keys.instance_variable_set :@max, max
+            hmac_keys.instance_variable_set :@user_project, user_project
+            hmac_keys
+          end
+
+          protected
+
+          ##
+          # Raise an error unless an active connection is available.
+          def ensure_service!
+            raise "Must have active connection" unless @service
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/storage/project.rb

@@ -21,6 +21,7 @@ require "google/cloud/storage/bucket"
 require "google/cloud/storage/bucket/cors"
 require "google/cloud/storage/bucket/lifecycle"
 require "google/cloud/storage/file"
+require "google/cloud/storage/hmac_key"
 
 module Google
   module Cloud
@@ -384,6 +385,91 @@ module Google
           Bucket.from_gapi gapi, service, user_project: user_project
         end
 
+        ##
+        # Creates a new HMAC key.
+        #
+        # @param [String] service_account_email The email address of the service
+        #   account. Used to create the HMAC key.
+        # @param [String] project_id The project ID associated with
+        #   `service_account_email`, if `service_account_email` belongs to a
+        #   project other than the currently authenticated project. Optional. If
+        #   not provided, the project ID for the current project will be used.
+        # @param [String] user_project If this parameter is set to a project ID
+        #   other than the current project, and that project is authorized for
+        #   the currently authenticated service account, transit costs will be
+        #   billed to the given project. The default is `nil`.
+        #
+        # @return [Google::Cloud::Storage::HmacKey]
+        #
+        def create_hmac_key service_account_email, project_id: nil,
+                            user_project: nil
+          gapi = service.create_hmac_key service_account_email,
+                                         project_id: project_id,
+                                         user_project: user_project
+          HmacKey.from_gapi gapi, service, user_project: user_project
+        end
+
+        ##
+        # Retrieves an HMAC key's metadata; the key's secret is not included in
+        # the representation.
+        #
+        # @param [String] project_id The project ID associated with the
+        #   `service_account_email` used to create the HMAC key, if the
+        #   service account email belongs to a project other than the
+        #   currently authenticated project. Optional. If not provided, the
+        #   project ID for current project will be used.
+        # @param [String] user_project If this parameter is set to a project ID
+        #   other than the current project, and that project is authorized for
+        #   the currently authenticated service account, transit costs will be
+        #   billed to the given project. The default is `nil`.
+        #
+        # @return [Google::Cloud::Storage::HmacKey]
+        #
+        def hmac_key access_id, project_id: nil, user_project: nil
+          gapi = service.get_hmac_key \
+            access_id, project_id: project_id, user_project: user_project
+          HmacKey.from_gapi_metadata gapi, service, user_project: user_project
+        end
+
+        ##
+        # Retrieves a list of HMAC key metadata matching the criteria; the keys'
+        # secrets are not included.
+        #
+        # @param [String] service_account_email
+        #   If present, only keys for the given service account are returned.
+        # @param [String] project_id The project ID associated with the
+        #   `service_account_email` used to create the HMAC keys, if the
+        #   service account email belongs to a project other than the
+        #   currently authenticated project. Optional. If not provided, the
+        #   project ID for current project will be used.
+        # @param [Boolean] show_deleted_keys
+        #   Whether to include keys in the `DELETED` state. The default value is
+        #   false.
+        # @param [String] token A previously-returned page token representing
+        #   part of the larger set of results to view.
+        # @param [Integer] max Maximum number of keys to return.
+        # @param [String] user_project If this parameter is set to a project ID
+        #   other than the current project, and that project is authorized for
+        #   the currently authenticated service account, transit costs will be
+        #   billed to the given project. The default is `nil`.
+        #
+        # @return [Google::Cloud::Storage::HmacKey]
+        #
+        def hmac_keys service_account_email: nil, project_id: nil,
+                      show_deleted_keys: nil, token: nil, max: nil,
+                      user_project: nil
+          gapi = service.list_hmac_keys \
+            max: max, token: token,
+            service_account_email: service_account_email,
+            project_id: project_id, show_deleted_keys: show_deleted_keys,
+            user_project: user_project
+
+          HmacKey::List.from_gapi \
+            gapi, service,
+            service_account_email: nil, show_deleted_keys: nil,
+            max: max, user_project: user_project
+        end
+
         ##
         # Generates a signed URL. See [Signed
         # URLs](https://cloud.google.com/storage/docs/access-control/signed-urls)

data/lib/google/cloud/storage/service.rb

@@ -16,7 +16,7 @@
 require "google/cloud/storage/version"
 require "google/apis/storage_v1"
 require "digest"
-require "mime/types"
+require "mini_mime"
 require "pathname"
 
 module Google
@@ -451,11 +451,75 @@ module Google
           end
         end
 
+        ##
+        # Creates a new HMAC key for the specified service account.
+        # Returns Google::Apis::StorageV1::HmacKey.
+        def create_hmac_key service_account_email, project_id: nil,
+                            user_project: nil
+          execute do
+            service.create_project_hmac_key \
+              (project_id || @project), service_account_email,
+              user_project: user_project(user_project)
+          end
+        end
+
+        ##
+        # Deletes an HMAC key. Key must be in the INACTIVE state.
+        def delete_hmac_key access_id, project_id: nil, user_project: nil
+          execute do
+            service.delete_project_hmac_key \
+              (project_id || @project), access_id,
+              user_project: user_project(user_project)
+          end
+        end
+
+        ##
+        # Retrieves an HMAC key's metadata.
+        # Returns Google::Apis::StorageV1::HmacKeyMetadata.
+        def get_hmac_key access_id, project_id: nil, user_project: nil
+          execute do
+            service.get_project_hmac_key \
+              (project_id || @project), access_id,
+              user_project: user_project(user_project)
+          end
+        end
+
+        ##
+        # Retrieves a list of HMAC key metadata matching the criteria.
+        # Returns Google::Apis::StorageV1::HmacKeysMetadata.
+        def list_hmac_keys max: nil, token: nil, service_account_email: nil,
+                           project_id: nil, show_deleted_keys: nil,
+                           user_project: nil
+          execute do
+            service.list_project_hmac_keys \
+              (project_id || @project),
+              max_results: max, page_token: token,
+              service_account_email: service_account_email,
+              show_deleted_keys: show_deleted_keys,
+              user_project: user_project(user_project)
+          end
+        end
+
+        ##
+        # Updates the state of an HMAC key. See the HMAC Key resource descriptor
+        # for valid states.
+        # Returns Google::Apis::StorageV1::HmacKeyMetadata.
+        def update_hmac_key access_id, hmac_key_metadata_object,
+                            project_id: nil, user_project: nil
+          execute do
+            service.update_project_hmac_key \
+              (project_id || @project), access_id, hmac_key_metadata_object,
+              user_project: user_project(user_project)
+          end
+        end
+
         ##
         # Retrieves the mime-type for a file path.
         # An empty string is returned if no mime-type can be found.
         def mime_type_for path
-          MIME::Types.of(path).first.to_s
+          mime_type = MiniMime.lookup_by_filename path
+          return "" if mime_type.nil?
+          mime_type.content_type
         end
 
         # @private

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Storage
-      VERSION = "1.19.0".freeze
+      VERSION = "1.20.0".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-storage
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-11 00:00:00.000000000 Z
+date: 2019-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -88,19 +88,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.5'
 - !ruby/object:Gem::Dependency
-  name: mime-types
+  name: mini_mime
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -274,6 +274,8 @@ files:
 - lib/google/cloud/storage/file/signer_v2.rb
 - lib/google/cloud/storage/file/signer_v4.rb
 - lib/google/cloud/storage/file/verifier.rb
+- lib/google/cloud/storage/hmac_key.rb
+- lib/google/cloud/storage/hmac_key/list.rb
 - lib/google/cloud/storage/notification.rb
 - lib/google/cloud/storage/policy.rb
 - lib/google/cloud/storage/post_object.rb
@@ -299,7 +301,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.4
 signing_key: 
 specification_version: 4
 summary: API Client library for Google Cloud Storage