google-cloud-storage 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2561a9dd9f138630b772a0f6ba3dcbe292892761a3dad92f5b5cab785625b11c
-  data.tar.gz: 5c6ff780bf83212017dd7b82d655925af91fff9653ebb8c8585222790f5501d4
+  metadata.gz: 38b2256d0194e6d5fbedc19e638b2b57dab8038a9f93a3019538d2eb56b740c4
+  data.tar.gz: 10f4915478a797f777cb64a1cfafa6b841c0590a89f3c8d5784e153a13b8a885
 SHA512:
-  metadata.gz: 5d2d95049bf9257957b7c2f5406015caa9e3411af768d79004c133ca25d2907a0e6cb008eb0d935b088818789ec77d91739aac89037e93dfec3de164764700a3
-  data.tar.gz: f3b3c0bc9422b651d378f361f274d1a4a5354dbe4dc862fb02199c5de40071079f2920a984d9bccd5081abfd2836aed5652aa86af97dd58329b724a6b1e54aee
+  metadata.gz: 8d0a5be11ac43e57988db525cad4bf2d006d053a0d69b2ed1c017f71771771017f6e9acc190811b2d575c305971f3ecac736082eac399aff9bea62a9d730cdba
+  data.tar.gz: f412a33c819aace6190dfff910df58fe2708b15f2680c8d2749092b860d980d85156e02ebc97a9f7474de90b2f19e67b6c463acd0012c085465225ad7be3e9be

data/lib/google/cloud/storage.rb

@@ -317,6 +317,23 @@ module Google
     # downloaded.read #=> "Hello world!"
     # ```
     #
+    # Download a public file with an anonymous, unauthenticated client. Use
+    # `skip_lookup` to avoid errors retrieving non-public bucket and file
+    # metadata.
+    #
+    # ```ruby
+    # require "google/cloud/storage"
+    #
+    # storage = Google::Cloud::Storage.anonymous
+    #
+    # bucket = storage.bucket "public-bucket", skip_lookup: true
+    # file = bucket.file "path/to/public-file.ext", skip_lookup: true
+    #
+    # downloaded = file.download
+    # downloaded.rewind
+    # downloaded.read #=> "Hello world!"
+    # ```
+    #
     # ## Using Signed URLs
     #
     # Access without authentication can be granted to a file for a specified
@@ -600,6 +617,34 @@ module Google
           Storage::Service.new(
             project_id, credentials, retries: retries, timeout: timeout))
       end
+
+      ##
+      # Creates an unauthenticated, anonymous client for retrieving public data
+      # from the Storage service. Each call creates a new connection.
+      #
+      # @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::Storage::Project]
+      #
+      # @example Use `skip_lookup` to avoid retrieving non-public metadata:
+      #   require "google/cloud/storage"
+      #
+      #   storage = Google::Cloud::Storage.anonymous
+      #
+      #   bucket = storage.bucket "public-bucket", skip_lookup: true
+      #   file = bucket.file "path/to/public-file.ext", skip_lookup: true
+      #
+      #   downloaded = file.download
+      #   downloaded.rewind
+      #   downloaded.read #=> "Hello world!"
+      #
+      def self.anonymous retries: nil, timeout: nil
+        Storage::Project.new(
+          Storage::Service.new(nil, nil, retries: retries, timeout: timeout)
+        )
+      end
     end
   end
 end

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

@@ -49,6 +49,18 @@ module Google
       #   file = bucket.file "path/to/my-file.ext"
       #   file.download "path/to/downloaded/file.ext"
       #
+      # @example Download a public file with an unauthenticated client:
+      #   require "google/cloud/storage"
+      #
+      #   storage = Google::Cloud::Storage.anonymous
+      #
+      #   bucket = storage.bucket "public-bucket", skip_lookup: true
+      #   file = bucket.file "path/to/public-file.ext", skip_lookup: true
+      #
+      #   downloaded = file.download
+      #   downloaded.rewind
+      #   downloaded.read #=> "Hello world!"
+      #
       class File
         ##
         # @private The Connection object.
@@ -485,6 +497,18 @@ module Google
         #   downloaded.rewind
         #   downloaded.read #=> "Hello world!"
         #
+        # @example Download a public file with an unauthenticated client:
+        #   require "google/cloud/storage"
+        #
+        #   storage = Google::Cloud::Storage.anonymous
+        #
+        #   bucket = storage.bucket "public-bucket", skip_lookup: true
+        #   file = bucket.file "path/to/public-file.ext", skip_lookup: true
+        #
+        #   downloaded = file.download
+        #   downloaded.rewind
+        #   downloaded.read #=> "Hello world!"
+        #
         def download path = nil, verify: :md5, encryption_key: nil
           ensure_service!
           if path.nil?

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

@@ -41,7 +41,6 @@ module Google
         def initialize project, credentials, retries: nil, timeout: nil
           @project = project
           @credentials = credentials
-          @credentials = credentials
           @service = API::StorageService.new
           @service.client_options.application_name    = "gcloud-ruby"
           @service.client_options.application_version = \
@@ -53,7 +52,7 @@ module Google
           @service.request_options.header ||= {}
           @service.request_options.header["x-goog-api-client"] = \
             "gl-ruby/#{RUBY_VERSION} gccl/#{Google::Cloud::Storage::VERSION}"
-          @service.authorization = @credentials.client
+          @service.authorization = @credentials.client if @credentials
         end
 
         def service

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Storage
-      VERSION = "1.8.0"
+      VERSION = "1.9.0"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-storage
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-15 00:00:00.000000000 Z
+date: 2017-11-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core