google-cloud-resource_manager 0.39.0 → 1.0.0

data/lib/google-cloud-resource_manager.rb

@@ -1,4 +1,6 @@
-# Copyright 2016 Google LLC
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,123 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-##
-# This file is here to be autorequired by bundler, so that the
-# Google::Cloud.resource_manager and Google::Cloud#resource_manager methods can
-# be available, but the library and all dependencies won't be loaded until
-# required and used.
-
-
-gem "google-cloud-core"
-require "google/cloud" unless defined? Google::Cloud.new
-require "google/cloud/config"
-require "googleauth"
-
-module Google
-  module Cloud
-    ##
-    # 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
-    # {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
-    #   [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 [Google::Cloud::ResourceManager::Manager]
-    #
-    # @example
-    #   require "google/cloud"
-    #
-    #   gcloud = Google::Cloud.new
-    #   resource_manager = gcloud.resource_manager
-    #   resource_manager.projects.each do |project|
-    #     puts projects.project_id
-    #   end
-    #
-    # @example The default scope can be overridden with the `scope` option:
-    #   require "google/cloud"
-    #
-    #   gcloud  = Google::Cloud.new
-    #   readonly_scope = \
-    #     "https://www.googleapis.com/auth/cloudresourcemanager.readonly"
-    #   resource_manager = gcloud.resource_manager scope: readonly_scope
-    #
-    def resource_manager scope: nil, retries: nil, timeout: nil
-      retries ||= @retries
-      timeout ||= @timeout
-      Google::Cloud.resource_manager @keyfile, scope: scope,
-                                               retries: retries,
-                                               timeout: timeout
-    end
-
-    ##
-    # 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
-    # {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
-    #   Google::Auth::Credentials object. (See {ResourceManager::Credentials})
-    # @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 [Google::Cloud::ResourceManager::Manager]
-    #
-    # @example
-    #   require "google/cloud"
-    #
-    #   resource_manager = Google::Cloud.resource_manager
-    #   resource_manager.projects.each do |project|
-    #     puts projects.project_id
-    #   end
-    #
-    def self.resource_manager credentials = nil, scope: nil, retries: nil,
-                              timeout: nil
-      require "google/cloud/resource_manager"
-      Google::Cloud::ResourceManager.new credentials: credentials, scope: scope,
-                                         retries: retries, timeout: timeout
-    end
-  end
-end
-
-# Set the default resource manager configuration
-Google::Cloud.configure.add_config! :resource_manager do |config|
-  default_creds = Google::Cloud::Config.deferred do
-    Google::Cloud::Config.credentials_from_env(
-      "RESOURCE_MANAGER_CREDENTIALS", "RESOURCE_MANAGER_CREDENTIALS_JSON",
-      "RESOURCE_MANAGER_KEYFILE", "RESOURCE_MANAGER_KEYFILE_JSON"
-    )
-  end
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-  config.add_field! :credentials, default_creds,
-                    match: [String, Hash, Google::Auth::Credentials],
-                    allow_nil: true
-  config.add_alias! :keyfile, :credentials
-  config.add_field! :scope, nil, match: [String, Array]
-  config.add_field! :quota_project, nil, match: String
-  config.add_field! :retries, nil, match: Integer
-  config.add_field! :timeout, nil, match: Integer
-  config.add_field! :endpoint, nil, match: String
-end
+require "google/cloud/resource_manager" unless defined? Google::Cloud::ResourceManager::VERSION

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-resource_manager
 version: !ruby/object:Gem::Version
-  version: 0.39.0
+  version: 1.0.0
 platform: ruby
 authors:
-- Mike Moore
-- Chris Smith
+- Google LLC
 bindir: bin
 cert_chain: []
-date: 2025-03-04 00:00:00.000000000 Z
+date: 2025-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -25,69 +24,35 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
-  name: google-apis-cloudresourcemanager_v1
+  name: google-cloud-resource_manager-v3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
-- !ruby/object:Gem::Dependency
-  name: googleauth
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.16.2
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 2.a
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.16.2
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 2.a
-description: google-cloud-resource_manager is the official library for Google Cloud
-  Resource Manager.
-email:
-- mike@blowmage.com
-- quartzmo@gmail.com
+        version: '1.2'
+description: Creates, reads, and updates metadata for Google Cloud Platform resource
+  containers.
+email: googleapis-packages@google.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
 - AUTHENTICATION.md
-- CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
-- LICENSE
-- LOGGING.md
-- OVERVIEW.md
-- TROUBLESHOOTING.md
+- LICENSE.md
+- MIGRATING.md
+- README.md
 - lib/google-cloud-resource_manager.rb
 - lib/google/cloud/resource_manager.rb
-- lib/google/cloud/resource_manager/credentials.rb
-- lib/google/cloud/resource_manager/manager.rb
-- lib/google/cloud/resource_manager/policy.rb
-- lib/google/cloud/resource_manager/project.rb
-- lib/google/cloud/resource_manager/project/list.rb
-- lib/google/cloud/resource_manager/project/updater.rb
-- lib/google/cloud/resource_manager/resource.rb
-- lib/google/cloud/resource_manager/service.rb
 - lib/google/cloud/resource_manager/version.rb
-homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-resource_manager
+homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
 metadata: {}
@@ -107,5 +72,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.5
 specification_version: 4
-summary: API Client library for Google Cloud Resource Manager
+summary: Creates, reads, and updates metadata for Google Cloud Platform resource containers.
 test_files: []

data/CHANGELOG.md

@@ -1,175 +0,0 @@
-# Release History
-
-### 0.39.0 (2025-03-04)
-
-#### Features
-
-* Update minimum Ruby version to 3.0 ([#29261](https://github.com/googleapis/google-cloud-ruby/issues/29261)) 
-
-### 0.38.0 (2024-03-07)
-
-#### Features
-
-* Update minimum supported Ruby version to 2.7 ([#25298](https://github.com/googleapis/google-cloud-ruby/issues/25298)) 
-
-### 0.37.0 (2022-06-30)
-
-#### Features
-
-* Update minimum Ruby version to 2.6 ([#18444](https://github.com/googleapis/google-cloud-ruby/issues/18444)) 
-
-### 0.36.2 / 2021-07-08
-
-#### Documentation
-
-* Update AUTHENTICATION.md in handwritten packages
-
-### 0.36.1 / 2021-06-17
-
-#### Bug Fixes
-
-* Expand googleauth dependency to support future 1.x versions
-
-### 0.36.0 / 2021-03-10
-
-#### Features
-
-* Drop support for Ruby 2.4 and add support for Ruby 3.0
-
-### 0.35.0 / 2021-01-13
-
-#### Features
-
-* Replace google-api-client with google-apis-cloudresourcemanager_v1
-
-### 0.34.0 / 2020-09-16
-
-#### Features
-
-* quota_project can be set via library configuration
-
-### 0.33.3 / 2020-05-28
-
-#### Documentation
-
-* Fix a few broken links
-
-### 0.33.2 / 2020-04-01
-
-#### Documentation
-
-* fix some incorrect markdown causing spurious links
-
-### 0.33.1 / 2020-02-04
-
-#### Bug Fixes
-
-* List all projects example
-
-### 0.33.0 / 2019-10-29
-
-This release requires Ruby 2.4 or later.
-
-#### Documentation
-
-* Clarify which Google Cloud Platform environments support automatic authentication
-
-### 0.32.0 / 2019-10-01
-
-#### Features
-
-* Support overriding of service endpoint
-
-### 0.31.1 / 2019-08-23
-
-#### Documentation
-
-* Update documentation
-
-### 0.31.0 / 2019-02-12
-
-* Add parent resoure to `Project`:
-  * Add `Project#parent`.
-  * Add `parent` optional named argument to `Manager#create_project`.
-  * Add `Resource` class.
-  * Add `Manager#resource` convenience method.
-
-### 0.30.3 / 2018-09-20
-
-* Update documentation.
-  * Change documentation URL to googleapis GitHub org.
-* Fix circular require warning.
-
-### 0.30.2 / 2018-09-12
-
-* Add missing documentation files to package.
-
-### 0.30.1 / 2018-09-10
-
-* Update documentation.
-
-### 0.30.0 / 2018-06-22
-
-* Update Policy, protect from role duplication.
-* Updated dependencies.
-
-### 0.29.0 / 2018-02-27
-
-* Support Shared Configuration.
-* Fix issue with IAM Policy not refreshing properly.
-* Update Google API Client dependency.
-
-### 0.28.0 / 2017-11-14
-
-* Add `Google::Cloud::ResourceManager::Credentials` class.
-* Rename constructor arguments to `project_id` and `credentials`.
-  (The previous arguments `project` and `keyfile` are still supported.)
-* Document `Google::Auth::Credentials` as `credentials` value.
-* Updated `google-api-client`, `googleauth` dependencies.
-
-### 0.27.0 / 2017-09-28
-
-* Update Google API Client dependency to 0.14.x.
-
-### 0.26.0 / 2017-06-27
-
-* Upgrade dependency on Google API Client
-
-### 0.25.0 / 2017-06-01
-
-* Fix apiary client argument case.
-* Update gem spec homepage links.
-* Remove memoization of Policy.
-* Remove force parameter from Project#policy.
-* Remove Policy#deep_dup.
-
-### 0.24.1 / 2017-04-06
-
-* Fix error due to missing require.
-
-### 0.24.0 / 2017-04-05
-
-* Upgrade dependency on Google API Client
-
-### 0.23.0 / 2017-03-31
-
-* Updated documentation
-
-### 0.22.0 / 2017-03-03
-
-* Dependency on Google API Client has been updated to 0.10.x.
-
-### 0.21.0 / 2016-10-20
-
-* New service constructor Google::Cloud::ResourceManager.new
-
-### 0.20.1 / 2016-09-02
-
-* Fix for timeout on uploads.
-
-### 0.20.0 / 2016-08-26
-
-This gem contains the Google Cloud Resource Manager service implementation for the `google-cloud` gem. The `google-cloud` gem replaces the old `gcloud` gem. Legacy code can continue to use the `gcloud` gem.
-
-* Namespace is now `Google::Cloud`
-* The `google-cloud` gem is now an umbrella package for individual gems

data/CODE_OF_CONDUCT.md

@@ -1,40 +0,0 @@
-# Contributor Code of Conduct
-
-As contributors and maintainers of this project, and in the interest of
-fostering an open and welcoming community, we pledge to respect all people who
-contribute through reporting issues, posting feature requests, updating
-documentation, submitting pull requests or patches, and other activities.
-
-We are committed to making participation in this project a harassment-free
-experience for everyone, regardless of level of experience, gender, gender
-identity and expression, sexual orientation, disability, personal appearance,
-body size, race, ethnicity, age, religion, or nationality.
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery
-* Personal attacks
-* Trolling or insulting/derogatory comments
-* Public or private harassment
-* Publishing other's private information, such as physical or electronic
-  addresses, without explicit permission
-* Other unethical or unprofessional conduct.
-
-Project maintainers have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct. By adopting this Code of Conduct, project
-maintainers commit themselves to fairly and consistently applying these
-principles to every aspect of managing this project. Project maintainers who do
-not follow or enforce the Code of Conduct may be permanently removed from the
-project team.
-
-This code of conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community.
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by opening an issue or contacting one or more of the project
-maintainers.
-
-This Code of Conduct is adapted from the [Contributor
-Covenant](http://contributor-covenant.org), version 1.2.0, available at
-[http://contributor-covenant.org/version/1/2/0/](http://contributor-covenant.org/version/1/2/0/)

data/CONTRIBUTING.md

@@ -1,189 +0,0 @@
-# Contributing to Google Cloud Resource Manager
-
-1. **Sign one of the contributor license agreements below.**
-2. Fork the repo, develop and test your code changes.
-3. Send a pull request.
-
-## Contributor License Agreements
-
-Before we can accept your pull requests you'll need to sign a Contributor
-License Agreement (CLA):
-
-- **If you are an individual writing original source code** and **you own the
-  intellectual property**, then you'll need to sign an [individual
-  CLA](https://developers.google.com/open-source/cla/individual).
-- **If you work for a company that wants to allow you to contribute your work**,
-  then you'll need to sign a [corporate
-  CLA](https://developers.google.com/open-source/cla/corporate).
-
-You can sign these electronically (just scroll to the bottom). After that, we'll
-be able to accept your pull requests.
-
-## Setup
-
-In order to use the google-cloud-resource_manager console and run the project's
-tests, there is a small amount of setup:
-
-1. Install Ruby. google-cloud-resource_manager requires Ruby 2.5+. You may
-   choose to manage your Ruby and gem installations with [RVM](https://rvm.io/),
-   [rbenv](https://github.com/rbenv/rbenv), or
-   [chruby](https://github.com/postmodern/chruby).
-
-2. Install [Bundler](http://bundler.io/).
-
-   ```sh
-   $ gem install bundler
-   ```
-
-3. Install the top-level project dependencies.
-
-   ```sh
-   $ bundle install
-   ```
-
-4. Install the Resource Manager dependencies.
-
-   ```sh
-   $ cd google-cloud-resource_manager/
-   $ bundle install
-   ```
-
-## Console
-
-In order to run code interactively, you can automatically load
-google-cloud-resource_manager and its dependencies in IRB. This requires that
-your developer environment has already been configured by following the steps
-described in the {file:AUTHENTICATION.md Authentication Guide}. An IRB console
-can be created with:
-
-```sh
-$ cd google-cloud-resource_manager/
-$ bundle exec rake console
-```
-
-## Resource Manager Tests
-
-Tests are very important part of google-cloud-resource_manager. All
-contributions should include tests that ensure the contributed code behaves as
-expected.
-
-To run the unit tests, documentation tests, and code style checks together for a
-package:
-
-``` sh
-$ cd google-cloud-resource_manager/
-$ bundle exec rake ci
-```
-
-To run the command above, plus all acceptance tests, use `rake ci:acceptance` or
-its handy alias, `rake ci:a`.
-
-### Resource Manager Unit Tests
-
-
-The project uses the [minitest](https://github.com/seattlerb/minitest) library,
-including [specs](https://github.com/seattlerb/minitest#specs),
-[mocks](https://github.com/seattlerb/minitest#mocks) and
-[minitest-autotest](https://github.com/seattlerb/minitest-autotest).
-
-To run the Resource Manager unit tests:
-
-``` sh
-$ cd google-cloud-resource_manager/
-$ bundle exec rake test
-```
-
-### Resource Manager Documentation Tests
-
-The project tests the code examples in the gem's
-[YARD](https://github.com/lsegal/yard)-based documentation.
-
-The example testing functions in a way that is very similar to unit testing, and
-in fact the library providing it,
-[yard-doctest](https://github.com/p0deje/yard-doctest), is based on the
-project's unit test library, [minitest](https://github.com/seattlerb/minitest).
-
-To run the Resource Manager documentation tests:
-
-``` sh
-$ cd google-cloud-resource_manager/
-$ bundle exec rake doctest
-```
-
-If you add, remove or modify documentation examples when working on a pull
-request, you may need to update the setup for the tests. The stubs and mocks
-required to run the tests are located in `support/doctest_helper.rb`. Please
-note that much of the setup is matched by the title of the
-[`@example`](http://www.rubydoc.info/gems/yard/file/docs/Tags.md#example) tag.
-If you alter an example's title, you may encounter breaking tests.
-
-### Resource Manager Acceptance Tests
-
-The Resource Manager acceptance tests interact with the live service API. Follow
-the instructions in the {file:AUTHENTICATION.md Authentication Guide} for
-enabling the Resource Manager API. Occasionally, some API features may not yet
-be generally available, making it difficult for some contributors to
-successfully run the entire acceptance test suite. However, please ensure that
-you do successfully run acceptance tests for any code areas covered by your pull
-request.
-
-To run the acceptance tests, first create and configure a project in the Google
-Developers Console, as described in the {file:AUTHENTICATION.md Authentication Guide}. Be sure to download the JSON KEY file. Make note of the PROJECT_ID and
-the KEYFILE location on your system.
-
-Before you can run the Resource Manager acceptance tests, you must first create
-indexes used in the tests.
-
-#### Running the Resource Manager acceptance tests
-
-To run the Resource Manager acceptance tests:
-
-``` sh
-$ cd google-cloud-resource_manager/
-$ bundle exec rake acceptance[\\{my-project-id},\\{/path/to/keyfile.json}]
-```
-
-Or, if you prefer you can store the values in the `GCLOUD_TEST_PROJECT` and
-`GCLOUD_TEST_KEYFILE` environment variables:
-
-``` sh
-$ cd google-cloud-resource_manager/
-$ export GCLOUD_TEST_PROJECT=\\{my-project-id}
-$ export GCLOUD_TEST_KEYFILE=\\{/path/to/keyfile.json}
-$ bundle exec rake acceptance
-```
-
-If you want to use a different project and credentials for acceptance tests, you
-can use the more specific `BIGTABLE_TEST_PROJECT`  and `BIGTABLE_TEST_KEYFILE`
-environment variables:
-
-``` sh
-$ cd google-cloud-resource_manager/
-$ export BIGTABLE_TEST_PROJECT=\\{my-project-id}
-$ export BIGTABLE_TEST_KEYFILE=\\{/path/to/keyfile.json}
-$ bundle exec rake acceptance
-```
-
-## Coding Style
-
-Please follow the established coding style in the library. The style is is
-largely based on [The Ruby Style
-Guide](https://github.com/bbatsov/ruby-style-guide) with a few exceptions based
-on seattle-style:
-
-* Avoid parenthesis when possible, including in method definitions.
-* Always use double quotes strings. ([Option
-  B](https://github.com/bbatsov/ruby-style-guide#strings))
-
-You can check your code against these rules by running Rubocop like so:
-
-```sh
-$ cd google-cloud-resource_manager/
-$ bundle exec rake rubocop
-```
-
-## Code of Conduct
-
-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
-{file:CODE_OF_CONDUCT.md Code of Conduct} for more information.