google-cloud-resource_manager 0.30.0 → 0.30.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b4f6df99ae367d39f011dea18efabf2379755b8d2969c087d5a1c00ab8bacf0
-  data.tar.gz: d6fac18225cd9beb1e90f149ab506aaf3bc8031119fcae9bde38d7e18c7d4294
+  metadata.gz: bd0b1f48311db4574904ff3a47c9837ea0d566a51feca6689cfe93f557385f01
+  data.tar.gz: c4765b14fa28b1f08de397ae14cce5be61b6f97cf52e961e149a29323b75b313
 SHA512:
-  metadata.gz: 72e46a071a6feaee960ea92b84cd04aa10f591dda5e8c907706bfa4b609d5032c9860ed3eaa742e5bb577707055a8dfb13879d37be6f9db210492ca070e20830
-  data.tar.gz: a1461d754b77f742afb56ffb417c52d8ea1200b650468ebc12a22f6e64f36453efb10f3e8f00ba848db0a50ddf878f81777c1d0010618a92b2a83cc0ed56d659
+  metadata.gz: db337590de2584a3f25ee8520bd4805fe549074e4452cdf8e7c138584839f9c602deeef9ee766ca4089c9b7e160ee53c00db375f9e67131b056e47db45752237
+  data.tar.gz: 63830bf855958324c46cc9e99ce340bf7e89421ea37d8092dde767bca23f6936ec223e5c7d969220fdcc2f7b5453c31a41bfedbd9442c1b74539495cb6062260

data/.yardopts

@@ -1,7 +1,16 @@
 --no-private
 --title=Google Cloud Resource Manager
 --markup markdown
+--markup-provider redcarpet
+--main OVERVIEW.md
 
 ./lib/**/*.rb
 -
-README.md
+OVERVIEW.md
+AUTHENTICATION.md
+LOGGING.md
+CONTRIBUTING.md
+TROUBLESHOOTING.md
+CHANGELOG.md
+CODE_OF_CONDUCT.md
+LICENSE

data/README.md

@@ -9,7 +9,7 @@ programmatically manage  container resources such as Organizations and Projects,
 * Delete projects
 * Undelete, or recover, projects that you don't want to delete
 
-- [google-cloud-resource_manager API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-resource_manager/latest)
+- [google-cloud-resource_manager API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-resource_manager/latest)
 - [google-cloud-resource_manager on RubyGems](https://rubygems.org/gems/google-cloud-resource_manager)
 - [Google Cloud Resource Manager documentation](https://cloud.google.com/resource-manager/)
 
@@ -36,7 +36,7 @@ Also make sure all environment variables are cleared of any
 service account credentials. Then google-cloud-resource_manager will be able to detect the user
 authentication and connect with those credentials.
 
-Instructions and configuration options are covered in the [Authentication Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-resource_manager/guides/authentication).
+Instructions and configuration options are covered in the [Authentication Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-resource_manager/latest/file.AUTHENTICATION).
 
 ## Example
 
@@ -62,7 +62,7 @@ projects = resource_manager.projects filter: "labels.env:production"
 
 ## Enabling Logging
 
-To enable logging for this library, set the logger for the underlying [Google API Client](https://github.com/google/google-api-ruby-client/blob/master/README.md#logging) 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://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/).
+To enable logging for this library, set the logger for the underlying [Google API Client](https://github.com/google/google-api-ruby-client/blob/master/README.md#logging) 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://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/).
 
 If you do not set the logger explicitly and your application is running in a Rails environment, it will default to `Rails.logger`. Otherwise, if you do not set the logger and you are not using Rails, logging is disabled by default.
 
@@ -80,34 +80,44 @@ Google::Apis.logger = my_logger
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.0+.
+This library is supported on Ruby 2.3+.
 
-However, Ruby 2.3 or later is strongly recommended, as earlier releases have
-reached or are nearing end-of-life. After June 1, 2018, Google will provide
-official support only for Ruby versions that are considered current and
-supported by Ruby Core (that is, Ruby versions that are either in normal
-maintenance or in security maintenance).
-See https://www.ruby-lang.org/en/downloads/branches/ for further details.
+Google provides official support for Ruby versions that are actively supported
+by Ruby Core—that is, Ruby versions that are either in normal maintenance or in
+security maintenance, and not end of life. Currently, this means Ruby 2.3 and
+later. Older versions of Ruby _may_ still work, but are unsupported and not
+recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
+about the Ruby support schedule.
 
 ## Versioning
 
 This library follows [Semantic Versioning](http://semver.org/).
 
-It is currently in major version zero (0.y.z), which means that anything may change at any time and the public API should not be considered stable.
+It is currently in major version zero (0.y.z), which means that anything may
+change at any time and the public API should not be considered stable.
 
 ## Contributing
 
 Contributions to this library are always welcome and highly encouraged.
 
-See the [Contributing Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/contributing) for more information on how to get started.
+See the [Contributing
+Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-resource_manager/latest/file.CONTRIBUTING)
+for more information on how to get started.
 
-Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct](../CODE_OF_CONDUCT.md) for more information.
+Please note that this project is released with a Contributor Code of Conduct. By
+participating in this project you agree to abide by its terms. See [Code of
+Conduct](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-resource_manager/latest/file.CODE_OF_CONDUCT)
+for more information.
 
 ## License
 
-This library is licensed under Apache 2.0. Full license text is available in [LICENSE](LICENSE).
+This library is licensed under Apache 2.0. Full license text is available in
+[LICENSE](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-resource_manager/latest/file.LICENSE).
 
 ## Support
 
-Please [report bugs at the project on Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues).
-Don't hesitate to [ask questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby) about the client or APIs on [StackOverflow](http://stackoverflow.com).
+Please [report bugs at the project on
+Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues). Don't
+hesitate to [ask
+questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby)
+about the client or APIs on [StackOverflow](http://stackoverflow.com).

data/lib/google-cloud-resource_manager.rb

@@ -30,8 +30,8 @@ module Google
     # Creates a new object for connecting 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/google-cloud-ruby/#/docs/guides/authentication).
+    # For more information on connecting to Google Cloud see the
+    # {file:AUTHENTICATION.md Authentication Guide}.
     #
     # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
     #   set of resources and operations that the connection can access. See
@@ -74,8 +74,8 @@ module Google
     # 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/google-cloud-ruby/#/docs/guides/authentication).
+    # For more information on connecting to Google Cloud see the
+    # {file:AUTHENTICATION.md Authentication Guide}.
     #
     # @param [String, Hash, Google::Auth::Credentials] credentials The path to
     #   the keyfile as a String, the contents of the keyfile as a Hash, or a

data/lib/google/cloud/resource_manager.rb

@@ -24,230 +24,9 @@ module Google
     # # 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:
+    # programmatically manage your projects in the Google Cloud Platform.
     #
-    # * 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
-    #
-    # ## 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 google-cloud will be able to detect the user
-    # authentication and connect with those credentials.
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # ```
-    #
-    # ## Enabling Logging
-    #
-    # To enable logging for this library, set the logger for the underlying
-    # [Google API Client](https://github.com/google/google-api-ruby-client/blob/master/README.md#logging)
-    # 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://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
-    # that will write logs to [Stackdriver
-    # Logging](https://cloud.google.com/logging/).
-    #
-    # If you do not set the logger explicitly and your application is running in
-    # a Rails environment, it will default to `Rails.logger`. Otherwise, if you
-    # do not set the logger and you are not using Rails, logging is disabled by
-    # default.
-    #
-    # Configuring a Ruby stdlib logger:
-    #
-    # ```ruby
-    # require "logger"
-    #
-    # my_logger = Logger.new $stderr
-    # my_logger.level = Logger::WARN
-    #
-    # # Set the Google API Client logger
-    # Google::Apis.logger = my_logger
-    # ```
-    #
-    # ## 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
-    # {Google::Cloud::ResourceManager::Manager#projects})
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # 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
-    # {Google::Cloud::ResourceManager::Project#labels})
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # 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
-    # {Google::Cloud::ResourceManager::Manager#projects})
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # # 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
-    # {Google::Cloud::ResourceManager::Manager#create_project})
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # 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
-    # {Google::Cloud::ResourceManager::Manager#delete} and
-    # {Google::Cloud::ResourceManager::Project#delete})
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # 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
-    # {Google::Cloud::ResourceManager::Manager#undelete} and
-    # {Google::Cloud::ResourceManager::Project#undelete})
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # 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 "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new 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
-    # {Google::Cloud::ResourceManager::Project#policy} and
-    # {Google::Cloud::ResourceManager::Policy}.)
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # project = resource_manager.project "tokyo-rain-123"
-    # policy = project.policy
-    # ```
-    #
-    # A project's access control policy can also be updated:
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # 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
-    # {Google::Cloud::ResourceManager::Project#test_permissions})
-    #
-    # ```ruby
-    # require "google/cloud/resource_manager"
-    #
-    # resource_manager = Google::Cloud::ResourceManager.new
-    # 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).
+    # See {file:OVERVIEW.md Resource Manager Overview}.
     #
     module ResourceManager
       ##
@@ -255,8 +34,7 @@ module Google
       # service. Each call creates a new connection.
       #
       # For more information on connecting to Google Cloud see the
-      # [Authentication
-      # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+      # {file:AUTHENTICATION.md Authentication Guide}.
       #
       # @param [String, Hash, Google::Auth::Credentials] credentials The path to
       #   the keyfile as a String, the contents of the keyfile as a Hash, or a

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module ResourceManager
-      VERSION = "0.30.0".freeze
+      VERSION = "0.30.1".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-resource_manager
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.30.1
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-22 00:00:00.000000000 Z
+date: 2018-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -123,6 +123,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -169,16 +183,16 @@ dependencies:
   name: yard-doctest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.8
+        version: 0.1.13
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.8
+        version: 0.1.13
 description: google-cloud-resource_manager is the official library for Google Cloud
   Resource Manager.
 email: