gcloud 0.12.2 → 0.20.0

data/lib/gcloud/resource_manager.rb

@@ -1,4 +1,4 @@
-# Copyright 2015 Google Inc. All rights reserved.
+# 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.
@@ -14,275 +14,4 @@
 
 
 require "gcloud"
-require "gcloud/resource_manager/manager"
-
-module Gcloud
-  ##
-  # Creates a new `Project` instance connected to the Resource Manager service.
-  # Each call creates a new connection.
-  #
-  # For more information on connecting to Google Cloud see the [Authentication
-  # Guide](https://googlecloudplatform.github.io/gcloud-ruby/#/docs/guides/authentication).
-  #
-  # @param [String, Hash] keyfile Keyfile downloaded from Google Cloud. If file
-  #   path the file must be readable.
-  # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
-  #   set of resources and operations that the connection can access. See [Using
-  #   OAuth 2.0 to Access Google
-  #   APIs](https://developers.google.com/identity/protocols/OAuth2).
-  #
-  #   The default scope is:
-  #
-  #   * `https://www.googleapis.com/auth/cloud-platform`
-  # @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 [Gcloud::ResourceManager::Manager]
-  #
-  # @example
-  #   require "gcloud/resource_manager"
-  #
-  #   resource_manager = Gcloud.resource_manager
-  #   resource_manager.projects.each do |project|
-  #     puts projects.project_id
-  #   end
-  #
-  def self.resource_manager keyfile = nil, scope: nil, retries: nil,
-                            timeout: nil
-    if keyfile.nil?
-      credentials = Gcloud::ResourceManager::Credentials.default scope: scope
-    else
-      credentials = Gcloud::ResourceManager::Credentials.new keyfile,
-                                                             scope: scope
-    end
-    Gcloud::ResourceManager::Manager.new(
-      Gcloud::ResourceManager::Service.new(
-        credentials, retries: retries, timeout: timeout))
-  end
-
-  ##
-  # # Google Cloud Resource Manager
-  #
-  # The Resource Manager API provides methods that you can use to
-  # programmatically manage your projects in the Google Cloud Platform. You may
-  # be familiar with managing projects in the [Developers
-  # Console](https://developers.google.com/console/help/new/). With this API you
-  # can do the following:
-  #
-  # * Get a list of all projects associated with an account
-  # * Create new projects
-  # * Update existing projects
-  # * Delete projects
-  # * Undelete, or recover, projects that you don't want to delete
-  #
-  # The Resource Manager API is a Beta release and is not covered by any SLA or
-  # deprecation policy and may be subject to backward-incompatible changes.
-  #
-  # ## Accessing the Service
-  #
-  # Currently, the full functionality of the Resource Manager API is available
-  # only to whitelisted users. (Contact your account manager or a member of the
-  # Google Cloud sales team if you are interested in access.) Read-only methods
-  # such as {ResourceManager::Manager#projects} and
-  # {ResourceManager::Manager#project} are accessible to any user who enables
-  # the Resource Manager API in the [Developers
-  # Console](https://console.developers.google.com).
-  #
-  # ## Authentication
-  #
-  # The Resource Manager API currently requires authentication of a [User
-  # Account](https://developers.google.com/identity/protocols/OAuth2), and
-  # cannot currently be accessed with a [Service
-  # Account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount).
-  # To use a User Account install the [Google Cloud
-  # SDK](http://cloud.google.com/sdk) and authenticate with the following:
-  #
-  # ```
-  # $ gcloud auth login
-  # ```
-  #
-  # Also make sure all `GCLOUD` environment variables are cleared of any service
-  # accounts. Then gcloud-ruby will be able to detect the user authentication
-  # and connect with those credentials.
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # ```
-  #
-  # ## Listing Projects
-  #
-  # Project is a collection of settings, credentials, and metadata about the
-  # application or applications you're working on. You can retrieve and inspect
-  # all projects that you have permissions to. (See
-  # {Gcloud::ResourceManager::Manager#projects})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # resource_manager.projects.each do |project|
-  #   puts projects.project_id
-  # end
-  # ```
-  #
-  # ## Managing Projects with Labels
-  #
-  # Labels can be added to or removed from projects. (See
-  # {Gcloud::ResourceManager::Project#labels})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # project = resource_manager.project "tokyo-rain-123"
-  # # Label the project as production
-  # project.update do |p|
-  #   p.labels["env"] = "production"
-  # end
-  # ```
-  #
-  # Projects can then be filtered by labels. (See
-  # {Gcloud::ResourceManager::Manager#projects})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # # Find only the productions projects
-  # projects = resource_manager.projects filter: "labels.env:production"
-  # projects.each do |project|
-  #   puts project.project_id
-  # end
-  # ```
-  #
-  # ## Creating a Project
-  #
-  # You can also use the API to create new projects. (See
-  # {Gcloud::ResourceManager::Manager#create_project})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # project = resource_manager.create_project "tokyo-rain-123",
-  #                                           name: "Todos Development",
-  #                                           labels: {env: :development}
-  # ```
-  #
-  # ## Deleting a Project
-  #
-  # You can delete projects when they are no longer needed. (See
-  # {Gcloud::ResourceManager::Manager#delete} and
-  # {Gcloud::ResourceManager::Project#delete})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # resource_manager.delete "tokyo-rain-123"
-  # ```
-  #
-  # ## Undeleting a Project
-  #
-  # You can also restore a deleted project within the waiting period that starts
-  # when the project was deleted. Restoring a project returns it to the state it
-  # was in prior to being deleted. (See
-  # {Gcloud::ResourceManager::Manager#undelete} and
-  # {Gcloud::ResourceManager::Project#undelete})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # resource_manager.undelete "tokyo-rain-123"
-  # ```
-  #
-  # ## Configuring retries and timeout
-  #
-  # You can configure how many times API requests may be automatically retried.
-  # When an API request fails, the response will be inspected to see if the
-  # request meets criteria indicating that it may succeed on retry, such as
-  # `500` and `503` status codes or a specific internal error code such as
-  # `rateLimitExceeded`. If it meets the criteria, the request will be retried
-  # after a delay. If another error occurs, the delay will be increased before a
-  # subsequent attempt, until the `retries` limit is reached.
-  #
-  # You can also set the request `timeout` value in seconds.
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager retries: 10, timeout: 120
-  # ```
-  #
-  # See the [Resource Manager error
-  # messages](https://cloud.google.com/resource-manager/docs/core_errors)
-  # for a list of error conditions.
-  #
-  # ## Managing IAM Policies
-  #
-  # Google Cloud Identity and Access Management ([Cloud
-  # IAM](https://cloud.google.com/iam/)) access control policies can be managed
-  # on projects. These policies allow project owners to manage _who_ (identity)
-  # has access to _what_ (role). See [Cloud IAM
-  # Overview](https://cloud.google.com/iam/docs/overview) for more information.
-  #
-  # A project's access control policy can be retrieved. (See
-  # {Gcloud::ResourceManager::Project#policy} and
-  # {Gcloud::ResourceManager::Policy}.)
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # project = resource_manager.project "tokyo-rain-123"
-  # policy = project.policy
-  # ```
-  #
-  # A project's access control policy can also be updated:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # project = resource_manager.project "tokyo-rain-123"
-  #
-  # policy = project.policy do |p|
-  #   p.add "roles/viewer", "serviceAccount:your-service-account"
-  # end
-  # ```
-  #
-  # And permissions can be tested on a project. (See
-  # {Gcloud::ResourceManager::Project#test_permissions})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # resource_manager = gcloud.resource_manager
-  # project = resource_manager.project "tokyo-rain-123"
-  # perms = project.test_permissions "resourcemanager.projects.get",
-  #                                  "resourcemanager.projects.delete"
-  # perms.include? "resourcemanager.projects.get"    #=> true
-  # perms.include? "resourcemanager.projects.delete" #=> false
-  # ```
-  #
-  # For more information about using access control policies see [Managing
-  # Policies](https://cloud.google.com/iam/docs/managing-policies).
-  #
-  module ResourceManager
-  end
-end
+require "google/cloud/resource_manager"

data/lib/gcloud/storage.rb

@@ -1,4 +1,4 @@
-# Copyright 2014 Google Inc. All rights reserved.
+# 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.
@@ -14,442 +14,4 @@
 
 
 require "gcloud"
-require "gcloud/storage/project"
-
-module Gcloud
-  ##
-  # Creates a new object for connecting to the Storage service.
-  # Each call creates a new connection.
-  #
-  # For more information on connecting to Google Cloud see the [Authentication
-  # Guide](https://googlecloudplatform.github.io/gcloud-ruby/#/docs/guides/authentication).
-  #
-  # @param [String] project Project identifier for the Storage service you are
-  #   connecting to.
-  # @param [String, Hash] keyfile Keyfile downloaded from Google Cloud. If file
-  #   path the file must be readable.
-  # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
-  #   set of resources and operations that the connection can access. See [Using
-  #   OAuth 2.0 to Access Google
-  #   APIs](https://developers.google.com/identity/protocols/OAuth2).
-  #
-  #   The default scope is:
-  #
-  #   * `https://www.googleapis.com/auth/devstorage.full_control`
-  # @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 [Gcloud::Storage::Project]
-  #
-  # @example
-  #   require "gcloud/storage"
-  #
-  #   storage = Gcloud.storage "my-todo-project",
-  #                            "/path/to/keyfile.json"
-  #
-  #   bucket = storage.bucket "my-bucket"
-  #   file = bucket.file "path/to/my-file.ext"
-  #
-  def self.storage project = nil, keyfile = nil, scope: nil, retries: nil,
-                   timeout: nil
-    project ||= Gcloud::Storage::Project.default_project
-    project = project.to_s # Always cast to a string
-    fail ArgumentError, "project is missing" if project.empty?
-
-    if keyfile.nil?
-      credentials = Gcloud::Storage::Credentials.default scope: scope
-    else
-      credentials = Gcloud::Storage::Credentials.new keyfile, scope: scope
-    end
-
-    Gcloud::Storage::Project.new(
-      Gcloud::Storage::Service.new(
-        project, credentials, retries: retries, timeout: timeout))
-  end
-
-  ##
-  # # Google Cloud Storage
-  #
-  # Google Cloud Storage is an Internet service to store data in Google's cloud.
-  # It allows world-wide storage and retrieval of any amount of data and at any
-  # time, taking advantage of Google's own reliable and fast networking
-  # infrastructure to perform data operations in a cost effective manner.
-  #
-  # The goal of gcloud-ruby is to provide a API that is comfortable to
-  # Rubyists. Authentication is handled by {Gcloud#storage}. You can provide the
-  # project and credential information to connect to the Storage service, or if
-  # you are running on Google Compute Engine this configuration is taken care
-  # of for you.
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new "my-todo-project",
-  #                     "/path/to/keyfile.json"
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-bucket"
-  # file = bucket.file "path/to/my-file.ext"
-  # ```
-  #
-  # You can learn more about various options for connection on the
-  # [Authentication
-  # Guide](https://googlecloudplatform.github.io/gcloud-ruby/#/docs/guides/authentication).
-  #
-  # To learn more about Cloud Storage, read the
-  # [Google Cloud Storage Overview
-  # ](https://cloud.google.com/storage/docs/overview).
-  #
-  # ## Retrieving Buckets
-  #
-  # A Bucket is the container for your data. There is no limit on the number of
-  # buckets that you can create in a project. You can use buckets to organize
-  # and control access to your data. Each bucket has a unique name, which is how
-  # they are retrieved: (See {Gcloud::Storage::Project#bucket})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # ```
-  #
-  # You can also retrieve all buckets on a project: (See
-  # {Gcloud::Storage::Project#buckets})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # all_buckets = storage.buckets
-  # ```
-  #
-  # If you have a significant number of buckets, you may need to paginate
-  # through them: (See {Gcloud::Storage::Bucket::List#token})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # all_buckets = []
-  # tmp_buckets = storage.buckets
-  # while tmp_buckets.any? do
-  #   tmp_buckets.each do |bucket|
-  #     all_buckets << bucket
-  #   end
-  #   # break loop if no more buckets available
-  #   break if tmp_buckets.token.nil?
-  #   # get the next group of buckets
-  #   tmp_buckets = storage.buckets token: tmp_buckets.token
-  # end
-  # ```
-  #
-  # ## Creating a Bucket
-  #
-  # A unique name is all that is needed to create a new bucket: (See
-  # {Gcloud::Storage::Project#create_bucket})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.create_bucket "my-todo-app-attachments"
-  # ```
-  #
-  # ## Retrieving Files
-  #
-  # A File is an individual pieces of data that you store in Google Cloud
-  # Storage. Files contain the data stored as well as metadata describing the
-  # data. Files belong to a bucket and cannot be shared among buckets. There is
-  # no limit on the number of objects that you can create in a bucket.
-  #
-  # Files are retrieved by their name, which is the path of the file in the
-  # bucket: (See {Gcloud::Storage::Bucket#file})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # file = bucket.file "avatars/heidi/400x400.png"
-  # ```
-  #
-  # You can also retrieve all files in a bucket: (See Bucket#files)
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # all_files = bucket.files
-  # ```
-  #
-  # Or you can retrieve all files in a specified path:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # avatar_files = bucket.files prefix: "avatars/"
-  # ```
-  #
-  # If you have a significant number of files, you may need to paginate through
-  # them: (See {Gcloud::Storage::File::List#token})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  #
-  # all_files = []
-  # tmp_files = bucket.files
-  # while tmp_files.any? do
-  #   tmp_files.each do |file|
-  #     all_files << file
-  #   end
-  #   # break loop if no more files available
-  #   break if tmp_files.token.nil?
-  #   # get the next group of files
-  #   tmp_files = bucket.files token: tmp_files.token
-  # end
-  # ```
-  #
-  # ## Creating a File
-  #
-  # A new File can be uploaded by specifying the location of a file on the local
-  # file system, and the name/path that the file should be stored in the bucket.
-  # (See {Gcloud::Storage::Bucket#create_file})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # bucket.create_file "/var/todo-app/avatars/heidi/400x400.png",
-  #                    "avatars/heidi/400x400.png"
-  # ```
-  #
-  # ### Customer-supplied encryption keys
-  #
-  # By default, Google Cloud Storage manages server-side encryption keys on
-  # your behalf. However, a [customer-supplied encryption
-  # key](https://cloud.google.com/storage/docs/encryption#customer-supplied)
-  # can be provided with the `encryption_key` and `encryption_key_sha256`
-  # options. If given, the same key and SHA256 hash also must be provided to
-  # subsequently download or copy the file. If you use customer-supplied
-  # encryption keys, you must securely manage your keys and ensure that they are
-  # not lost. Also, please note that file metadata is not encrypted, with the
-  # exception of the CRC32C checksum and MD5 hash. The names of files and
-  # buckets are also not encrypted, and you can read or update the metadata of
-  # an encrypted file without providing the encryption key.
-  #
-  # ```ruby
-  # require "gcloud"
-  # require "digest/sha2"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  # bucket = storage.bucket "my-todo-app"
-  #
-  # # Key generation shown for example purposes only. Write your own.
-  # cipher = OpenSSL::Cipher.new "aes-256-cfb"
-  # cipher.encrypt
-  # key = cipher.random_key
-  # key_hash = Digest::SHA256.digest key
-  #
-  # bucket.create_file "/var/todo-app/avatars/heidi/400x400.png",
-  #                    "avatars/heidi/400x400.png",
-  #                    encryption_key: key,
-  #                    encryption_key_sha256: key_hash
-  #
-  # # Store your key and hash securely for later use.
-  # file = bucket.file "avatars/heidi/400x400.png",
-  #                    encryption_key: key,
-  #                    encryption_key_sha256: key_hash
-  # ```
-  #
-  # ## Downloading a File
-  #
-  # Files can be downloaded to the local file system. (See
-  # {Gcloud::Storage::File#download})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # file = bucket.file "avatars/heidi/400x400.png"
-  # file.download "/var/todo-app/avatars/heidi/400x400.png"
-  # ```
-  #
-  # ## Using Signed URLs
-  #
-  # Access without authentication can be granted to a File for a specified
-  # period of time. This URL uses a cryptographic signature of your credentials
-  # to access the file. (See {Gcloud::Storage::File#signed_url})
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # file = bucket.file "avatars/heidi/400x400.png"
-  # shared_url = file.signed_url method: "GET",
-  #                              expires: 300 # 5 minutes from now
-  # ```
-  #
-  # ## Controlling Access to a Bucket
-  #
-  # Access to a bucket is controlled with {Gcloud::Storage::Bucket#acl}. A
-  # bucket has owners, writers, and readers. Permissions can be granted to an
-  # individual user's email address, a group's email address, as well as many
-  # predefined lists. See the [Access Control
-  # guide](https://cloud.google.com/storage/docs/access-control) for more.
-  #
-  # Access to a bucket can be granted to a user by appending `"user-"` to the
-  # email address:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  #
-  # email = "heidi@example.net"
-  # bucket.acl.add_reader "user-#{email}"
-  # ```
-  #
-  # Access to a bucket can be granted to a group by appending `"group-"` to the
-  # email address:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  #
-  # email = "authors@example.net"
-  # bucket.acl.add_reader "group-#{email}"
-  # ```
-  #
-  # Access to a bucket can also be granted to a predefined list of permissions:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  #
-  # bucket.acl.public!
-  # ```
-  #
-  # ## Controlling Access to a File
-  #
-  # Access to a file is controlled in two ways, either by the setting the
-  # default permissions to all files in a bucket with
-  # {Gcloud::Storage::Bucket#default_acl}, or by setting permissions to an
-  # individual file with {Gcloud::Storage::File#acl}.
-  #
-  # Access to a file can be granted to a user by appending `"user-"` to the
-  # email address:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # file = bucket.file "avatars/heidi/400x400.png"
-  #
-  # email = "heidi@example.net"
-  # file.acl.add_reader "user-#{email}"
-  # ```
-  #
-  # Access to a file can be granted to a group by appending `"group-"` to the
-  # email address:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # file = bucket.file "avatars/heidi/400x400.png"
-  #
-  # email = "authors@example.net"
-  # file.acl.add_reader "group-#{email}"
-  # ```
-  #
-  # Access to a file can also be granted to a predefined list of permissions:
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage
-  #
-  # bucket = storage.bucket "my-todo-app"
-  # file = bucket.file "avatars/heidi/400x400.png"
-  #
-  # file.acl.public!
-  # ```
-  #
-  # ## Configuring retries and timeout
-  #
-  # You can configure how many times API requests may be automatically retried.
-  # When an API request fails, the response will be inspected to see if the
-  # request meets criteria indicating that it may succeed on retry, such as
-  # `500` and `503` status codes or a specific internal error code such as
-  # `rateLimitExceeded`. If it meets the criteria, the request will be retried
-  # after a delay. If another error occurs, the delay will be increased before a
-  # subsequent attempt, until the `retries` limit is reached.
-  #
-  # You can also set the request `timeout` value in seconds.
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # gcloud = Gcloud.new
-  # storage = gcloud.storage retries: 10, timeout: 120
-  # ```
-  #
-  # See the [Storage status and error
-  # codes](https://cloud.google.com/storage/docs/json_api/v1/status-codes)
-  # for a list of error conditions.
-  #
-  module Storage
-  end
-end
+require "google/cloud/storage"