google-cloud-resource_settings 1.5.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e5f417bad115ed3c29500bff929d1ba05b41aaf31dacbeddc769a2c96a5cc395
4
- data.tar.gz: 7774d233063575e55d181dc603a4cbbe6979b065babe99f6ea2e1bff42de5d7e
3
+ metadata.gz: c6ea87e5150d17a9cb2d3f37b77bb46220ac181fa27a4619a1f470c59636e7ba
4
+ data.tar.gz: 57d12aa62356721df71026218bd6f80749196aacfeeef487a0fa1a982c90a1eb
5
5
  SHA512:
6
- metadata.gz: 4839dc0f663129a59ac83b4eedf1aa710163a2b9eea19190d964bed87d52d4c3d4d08302a3a4865f789fd9d8025d3f05c6942801da264a34dc645ddd23b1efe4
7
- data.tar.gz: 8d6a624d187940aa63bd4399a63b56309dc28cefac527c42569a3ad19f9b4b1dc89afa4c6d12bc26e61d6b29ba2be82b8d40d50c08e5a1b69feb8358ff2eebce
6
+ metadata.gz: 497a116ab0879e162e5a40f54c45e185bc58798c2bdae931aeca4e66cd4056e20bc3d3c129c8650ba2c26fd47c43684064a660c0fa71f02016b9f4a97fb614ba
7
+ data.tar.gz: 18cc8a81723310c80b7037050e10fffb25434d314adb4297f49f5510bae301973895182aad0f357c31402238494107cf687bb8bd6143ba64a8942e4145a16339
data/README.md CHANGED
@@ -1,134 +1,4 @@
1
- # Ruby Client for the Resource Settings API
1
+ # Tombstone for Ruby gem google-cloud-resource_settings
2
2
 
3
- API Client library for the Resource Settings API
4
-
5
- You can use Resource Settings to centrally configure settings for your Google Cloud projects, folders, and organization. These settings are inherited by their descendants in the resource hierarchy. Each setting is created and managed by Google.
6
-
7
- Actual client classes for the various versions of this API are defined in
8
- _versioned_ client gems, with names of the form `google-cloud-resource_settings-v*`.
9
- The gem `google-cloud-resource_settings` is the main client library that brings the
10
- verisoned gems in as dependencies, and provides high-level methods for
11
- constructing clients. More information on versioned clients can be found below
12
- in the section titled *Which client should I use?*.
13
-
14
- View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-resource_settings/latest)
15
- for this library, google-cloud-resource_settings, to see the convenience methods for
16
- constructing client objects. Reference documentation for the client objects
17
- themselves can be found in the client library documentation for the versioned
18
- client gems:
19
- [google-cloud-resource_settings-v1](https://cloud.google.com/ruby/docs/reference/google-cloud-resource_settings-v1/latest).
20
-
21
- See also the [Product Documentation](https://cloud.google.com/resource-manager/docs/resource-settings/overview)
22
- for more usage information.
23
-
24
- ## Quick Start
25
-
26
- ```
27
- $ gem install google-cloud-resource_settings
28
- ```
29
-
30
- In order to use this library, you first need to go through the following steps:
31
-
32
- 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
33
- 1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
34
- 1. [Enable the API.](https://console.cloud.google.com/apis/library/resourcesettings.googleapis.com)
35
- 1. {file:AUTHENTICATION.md Set up authentication.}
36
-
37
- ## Debug Logging
38
-
39
- This library comes with opt-in Debug Logging that can help you troubleshoot
40
- your application's integration with the API. When logging is activated, key
41
- events such as requests and responses, along with data payloads and metadata
42
- such as headers and client configuration, are logged to the standard error
43
- stream.
44
-
45
- **WARNING:** Client Library Debug Logging includes your data payloads in
46
- plaintext, which could include sensitive data such as PII for yourself or your
47
- customers, private keys, or other security data that could be compromising if
48
- leaked. Always practice good data hygiene with your application logs, and follow
49
- the principle of least access. Google also recommends that Client Library Debug
50
- Logging be enabled only temporarily during active debugging, and not used
51
- permanently in production.
52
-
53
- To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
54
- to the value `all`. Alternatively, you can set the value to a comma-delimited
55
- list of client library gem names. This will select the default logging behavior,
56
- which writes logs to the standard error stream. On a local workstation, this may
57
- result in logs appearing on the console. When running on a Google Cloud hosting
58
- service such as [Google Cloud Run](https://cloud.google.com/run), this generally
59
- results in logs appearing alongside your application logs in the
60
- [Google Cloud Logging](https://cloud.google.com/logging/) service.
61
-
62
- Debug logging also requires that the versioned clients for this service be
63
- sufficiently recent, released after about Dec 10, 2024. If logging is not
64
- working, try updating the versioned clients in your bundle or installed gems:
65
- [google-cloud-resource_settings-v1](https://cloud.google.com/ruby/docs/reference/google-cloud-resource_settings-v1/latest).
66
-
67
- ## Supported Ruby Versions
68
-
69
- This library is supported on Ruby 3.0+.
70
-
71
- Google provides official support for Ruby versions that are actively supported
72
- by Ruby Core—that is, Ruby versions that are either in normal maintenance or
73
- in security maintenance, and not end of life. Older versions of Ruby _may_
74
- still work, but are unsupported and not recommended. See
75
- https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
76
- support schedule.
77
-
78
- ## Which client should I use?
79
-
80
- Most modern Ruby client libraries for Google APIs come in two flavors: the main
81
- client library with a name such as `google-cloud-resource_settings`,
82
- and lower-level _versioned_ client libraries with names such as
83
- `google-cloud-resource_settings-v1`.
84
- _In most cases, you should install the main client._
85
-
86
- ### What's the difference between the main client and a versioned client?
87
-
88
- A _versioned client_ provides a basic set of data types and client classes for
89
- a _single version_ of a specific service. (That is, for a service with multiple
90
- versions, there might be a separate versioned client for each service version.)
91
- Most versioned clients are written and maintained by a code generator.
92
-
93
- The _main client_ is designed to provide you with the _recommended_ client
94
- interfaces for the service. There will be only one main client for any given
95
- service, even a service with multiple versions. The main client includes
96
- factory methods for constructing the client objects we recommend for most
97
- users. In some cases, those will be classes provided by an underlying versioned
98
- client; in other cases, they will be handwritten higher-level client objects
99
- with additional capabilities, convenience methods, or best practices built in.
100
- Generally, the main client will default to a recommended service version,
101
- although in some cases you can override this if you need to talk to a specific
102
- service version.
103
-
104
- ### Why would I want to use the main client?
105
-
106
- We recommend that most users install the main client gem for a service. You can
107
- identify this gem as the one _without_ a version in its name, e.g.
108
- `google-cloud-resource_settings`.
109
- The main client is recommended because it will embody the best practices for
110
- accessing the service, and may also provide more convenient interfaces or
111
- tighter integration into frameworks and third-party libraries. In addition, the
112
- documentation and samples published by Google will generally demonstrate use of
113
- the main client.
114
-
115
- ### Why would I want to use a versioned client?
116
-
117
- You can use a versioned client if you are content with a possibly lower-level
118
- class interface, you explicitly want to avoid features provided by the main
119
- client, or you want to access a specific service version not be covered by the
120
- main client. You can identify versioned client gems because the service version
121
- is part of the name, e.g. `google-cloud-resource_settings-v1`.
122
-
123
- ### What about the google-apis-<name> clients?
124
-
125
- Client library gems with names that begin with `google-apis-` are based on an
126
- older code generation technology. They talk to a REST/JSON backend (whereas
127
- most modern clients talk to a [gRPC](https://grpc.io/) backend) and they may
128
- not offer the same performance, features, and ease of use provided by more
129
- modern clients.
130
-
131
- The `google-apis-` clients have wide coverage across Google services, so you
132
- might need to use one if there is no modern client available for the service.
133
- However, if a modern client is available, we generally recommend it over the
134
- older `google-apis-` clients.
3
+ This gem is obsolete because the related Google backend is turned down.
4
+ For more information, see https://cloud.google.com/terms/deprecation.
@@ -1,12 +1,10 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2021 Google LLC
1
+ # Copyright 2025 Google LLC
4
2
  #
5
3
  # Licensed under the Apache License, Version 2.0 (the "License");
6
4
  # you may not use this file except in compliance with the License.
7
5
  # You may obtain a copy of the License at
8
6
  #
9
- # https://www.apache.org/licenses/LICENSE-2.0
7
+ # http://www.apache.org/licenses/LICENSE-2.0
10
8
  #
11
9
  # Unless required by applicable law or agreed to in writing, software
12
10
  # distributed under the License is distributed on an "AS IS" BASIS,
@@ -14,13 +12,10 @@
14
12
  # See the License for the specific language governing permissions and
15
13
  # limitations under the License.
16
14
 
17
- # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
-
19
-
20
15
  module Google
21
16
  module Cloud
22
17
  module ResourceSettings
23
- VERSION = "1.5.0"
18
+ VERSION = "2.0.0"
24
19
  end
25
20
  end
26
21
  end
metadata CHANGED
@@ -1,68 +1,36 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-resource_settings
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.5.0
4
+ version: 2.0.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-01-29 00:00:00.000000000 Z
11
- dependencies:
12
- - !ruby/object:Gem::Dependency
13
- name: google-cloud-core
14
- requirement: !ruby/object:Gem::Requirement
15
- requirements:
16
- - - "~>"
17
- - !ruby/object:Gem::Version
18
- version: '1.6'
19
- type: :runtime
20
- prerelease: false
21
- version_requirements: !ruby/object:Gem::Requirement
22
- requirements:
23
- - - "~>"
24
- - !ruby/object:Gem::Version
25
- version: '1.6'
26
- - !ruby/object:Gem::Dependency
27
- name: google-cloud-resource_settings-v1
28
- requirement: !ruby/object:Gem::Requirement
29
- requirements:
30
- - - ">="
31
- - !ruby/object:Gem::Version
32
- version: '0.6'
33
- - - "<"
34
- - !ruby/object:Gem::Version
35
- version: 2.a
36
- type: :runtime
37
- prerelease: false
38
- version_requirements: !ruby/object:Gem::Requirement
39
- requirements:
40
- - - ">="
41
- - !ruby/object:Gem::Version
42
- version: '0.6'
43
- - - "<"
44
- - !ruby/object:Gem::Version
45
- version: 2.a
46
- description: You can use Resource Settings to centrally configure settings for your
47
- Google Cloud projects, folders, and organization. These settings are inherited by
48
- their descendants in the resource hierarchy. Each setting is created and managed
49
- by Google.
10
+ date: 2025-03-07 00:00:00.000000000 Z
11
+ dependencies: []
12
+ description: This gem is obsolete because the related Google backend is turned down.
13
+ For more information, see https://cloud.google.com/terms/deprecation.
50
14
  email: googleapis-packages@google.com
51
15
  executables: []
52
16
  extensions: []
53
17
  extra_rdoc_files: []
54
18
  files:
55
- - ".yardopts"
56
- - AUTHENTICATION.md
57
19
  - LICENSE.md
58
20
  - README.md
59
- - lib/google-cloud-resource_settings.rb
60
- - lib/google/cloud/resource_settings.rb
61
21
  - lib/google/cloud/resource_settings/version.rb
62
22
  homepage: https://github.com/googleapis/google-cloud-ruby
63
23
  licenses:
64
24
  - Apache-2.0
65
25
  metadata: {}
26
+ post_install_message: |2+
27
+
28
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
29
+ The google-cloud-resource_settings gem is OBSOLETE.
30
+ For more information, see:
31
+ https://cloud.google.com/terms/deprecation
32
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
33
+
66
34
  rdoc_options: []
67
35
  require_paths:
68
36
  - lib
@@ -70,14 +38,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
70
38
  requirements:
71
39
  - - ">="
72
40
  - !ruby/object:Gem::Version
73
- version: '3.0'
41
+ version: '2.0'
74
42
  required_rubygems_version: !ruby/object:Gem::Requirement
75
43
  requirements:
76
44
  - - ">="
77
45
  - !ruby/object:Gem::Version
78
46
  version: '0'
79
47
  requirements: []
80
- rubygems_version: 3.6.2
48
+ rubygems_version: 3.6.5
81
49
  specification_version: 4
82
- summary: API Client library for the Resource Settings API
50
+ summary: This gem is obsolete because the related backend is turned down.
83
51
  test_files: []
data/.yardopts DELETED
@@ -1,11 +0,0 @@
1
- --no-private
2
- --title="Resource Settings API"
3
- --exclude _pb\.rb$
4
- --markup markdown
5
- --markup-provider redcarpet
6
-
7
- ./lib/**/*.rb
8
- -
9
- README.md
10
- AUTHENTICATION.md
11
- LICENSE.md
data/AUTHENTICATION.md DELETED
@@ -1,122 +0,0 @@
1
- # Authentication
2
-
3
- The recommended way to authenticate to the google-cloud-resource_settings library is to use
4
- [Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).
5
- To review all of your authentication options, see [Credentials lookup](#credential-lookup).
6
-
7
- ## Quickstart
8
-
9
- The following example shows how to set up authentication for a local development
10
- environment with your user credentials.
11
-
12
- **NOTE:** This method is _not_ recommended for running in production. User credentials
13
- should be used only during development.
14
-
15
- 1. [Download and install the Google Cloud CLI](https://cloud.google.com/sdk).
16
- 2. Set up a local ADC file with your user credentials:
17
-
18
- ```sh
19
- gcloud auth application-default login
20
- ```
21
-
22
- 3. Write code as if already authenticated.
23
-
24
- For more information about setting up authentication for a local development environment, see
25
- [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-dev).
26
-
27
- ## Credential Lookup
28
-
29
- The google-cloud-resource_settings library provides several mechanisms to configure your system.
30
- Generally, using Application Default Credentials to facilitate automatic
31
- credentials discovery is the easist method. But if you need to explicitly specify
32
- credentials, there are several methods available to you.
33
-
34
- Credentials are accepted in the following ways, in the following order or precedence:
35
-
36
- 1. Credentials specified in method arguments
37
- 2. Credentials specified in configuration
38
- 3. Credentials pointed to or included in environment variables
39
- 4. Credentials found in local ADC file
40
- 5. Credentials returned by the metadata server for the attached service account (GCP)
41
-
42
- ### Configuration
43
-
44
- You can configure a path to a JSON credentials file, either for an individual client object or
45
- globally, for all client objects. The JSON file can contain credentials created for
46
- [workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
47
- [workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
48
- [service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
49
-
50
- Note: Service account keys are a security risk if not managed correctly. You should
51
- [choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
52
- whenever possible.
53
-
54
- To configure a credentials file for an individual client initialization:
55
-
56
- ```ruby
57
- require "google/cloud/resource_settings"
58
-
59
- client = Google::Cloud::ResourceSettings.resource_settings_service do |config|
60
- config.credentials = "path/to/credentialfile.json"
61
- end
62
- ```
63
-
64
- To configure a credentials file globally for all clients:
65
-
66
- ```ruby
67
- require "google/cloud/resource_settings"
68
-
69
- Google::Cloud::ResourceSettings.configure do |config|
70
- config.credentials = "path/to/credentialfile.json"
71
- end
72
-
73
- client = Google::Cloud::ResourceSettings.resource_settings_service
74
- ```
75
-
76
- ### Environment Variables
77
-
78
- You can also use an environment variable to provide a JSON credentials file.
79
- The environment variable can contain a path to the credentials file or, for
80
- environments such as Docker containers where writing files is not encouraged,
81
- you can include the credentials file itself.
82
-
83
- The JSON file can contain credentials created for
84
- [workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
85
- [workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
86
- [service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
87
-
88
- Note: Service account keys are a security risk if not managed correctly. You should
89
- [choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
90
- whenever possible.
91
-
92
- The environment variables that google-cloud-resource_settings
93
- checks for credentials are:
94
-
95
- * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
96
- * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
97
-
98
- ```ruby
99
- require "google/cloud/resource_settings"
100
-
101
- ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
102
-
103
- client = Google::Cloud::ResourceSettings.resource_settings_service
104
- ```
105
-
106
- ### Local ADC file
107
-
108
- You can set up a local ADC file with your user credentials for authentication during
109
- development. If credentials are not provided in code or in environment variables,
110
- then the local ADC credentials are discovered.
111
-
112
- Follow the steps in [Quickstart](#quickstart) to set up a local ADC file.
113
-
114
- ### Google Cloud Platform environments
115
-
116
- When running on Google Cloud Platform (GCP), including Google Compute Engine
117
- (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
118
- Functions (GCF) and Cloud Run, credentials are retrieved from the attached
119
- service account automatically. Code should be written as if already authenticated.
120
-
121
- For more information, see
122
- [Set up ADC for Google Cloud services](https://cloud.google.com/docs/authentication/provide-credentials-adc#attached-sa).
@@ -1,170 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2021 Google LLC
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the "License");
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # https://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an "AS IS" BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
-
19
- # Require this file early so that the version constant gets defined before
20
- # requiring "google/cloud". This is because google-cloud-core will load the
21
- # entrypoint (gem name) file, which in turn re-requires this file (hence
22
- # causing a require cycle) unless the version constant is already defined.
23
- require "google/cloud/resource_settings/version"
24
-
25
- require "googleauth"
26
- gem "google-cloud-core"
27
- require "google/cloud" unless defined? ::Google::Cloud.new
28
- require "google/cloud/config"
29
-
30
- # Set the default configuration
31
- ::Google::Cloud.configure.add_config! :resource_settings do |config|
32
- config.add_field! :endpoint, nil, match: ::String
33
- config.add_field! :credentials, nil, match: [::String, ::Hash, ::Google::Auth::Credentials]
34
- config.add_field! :scope, nil, match: [::Array, ::String]
35
- config.add_field! :lib_name, nil, match: ::String
36
- config.add_field! :lib_version, nil, match: ::String
37
- config.add_field! :interceptors, nil, match: ::Array
38
- config.add_field! :timeout, nil, match: ::Numeric
39
- config.add_field! :metadata, nil, match: ::Hash
40
- config.add_field! :retry_policy, nil, match: [::Hash, ::Proc]
41
- config.add_field! :quota_project, nil, match: ::String
42
- config.add_field! :universe_domain, nil, match: ::String
43
- end
44
-
45
- module Google
46
- module Cloud
47
- module ResourceSettings
48
- ##
49
- # Create a new client object for ResourceSettingsService.
50
- #
51
- # By default, this returns an instance of
52
- # [Google::Cloud::ResourceSettings::V1::ResourceSettingsService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-resource_settings-v1/latest/Google-Cloud-ResourceSettings-V1-ResourceSettingsService-Client)
53
- # for a gRPC client for version V1 of the API.
54
- # However, you can specify a different API version by passing it in the
55
- # `version` parameter. If the ResourceSettingsService service is
56
- # supported by that API version, and the corresponding gem is available, the
57
- # appropriate versioned client will be returned.
58
- # You can also specify a different transport by passing `:rest` or `:grpc` in
59
- # the `transport` parameter.
60
- #
61
- # Raises an exception if the currently installed versioned client gem for the
62
- # given API version does not support the given transport of the ResourceSettingsService service.
63
- # You can determine whether the method will succeed by calling
64
- # {Google::Cloud::ResourceSettings.resource_settings_service_available?}.
65
- #
66
- # ## About ResourceSettingsService
67
- #
68
- # An interface to interact with resource settings and setting values throughout
69
- # the resource hierarchy.
70
- #
71
- # Services may surface a number of settings for users to control how their
72
- # resources behave. Values of settings applied on a given Cloud resource are
73
- # evaluated hierarchically and inherited by all descendants of that resource.
74
- #
75
- # For all requests, returns a `google.rpc.Status` with
76
- # `google.rpc.Code.PERMISSION_DENIED` if the IAM check fails or the `parent`
77
- # resource is not in a Cloud Organization.
78
- # For all requests, returns a `google.rpc.Status` with
79
- # `google.rpc.Code.INVALID_ARGUMENT` if the request is malformed.
80
- # (== deprecation_description Resource Settings is deprecated. As of November
81
- # 7, 2023, no organizations will be onboarded for any of the enabled settings,
82
- # and the service will be shut down on October 1, 2024. ==)
83
- #
84
- # @param version [::String, ::Symbol] The API version to connect to. Optional.
85
- # Defaults to `:v1`.
86
- # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
87
- # @return [::Object] A client object for the specified version.
88
- #
89
- def self.resource_settings_service version: :v1, transport: :grpc, &block
90
- require "google/cloud/resource_settings/#{version.to_s.downcase}"
91
-
92
- package_name = Google::Cloud::ResourceSettings
93
- .constants
94
- .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
95
- .first
96
- service_module = Google::Cloud::ResourceSettings.const_get(package_name).const_get(:ResourceSettingsService)
97
- service_module = service_module.const_get(:Rest) if transport == :rest
98
- service_module.const_get(:Client).new(&block)
99
- end
100
-
101
- ##
102
- # Determines whether the ResourceSettingsService service is supported by the current client.
103
- # If true, you can retrieve a client object by calling {Google::Cloud::ResourceSettings.resource_settings_service}.
104
- # If false, that method will raise an exception. This could happen if the given
105
- # API version does not exist or does not support the ResourceSettingsService service,
106
- # or if the versioned client gem needs an update to support the ResourceSettingsService service.
107
- #
108
- # @param version [::String, ::Symbol] The API version to connect to. Optional.
109
- # Defaults to `:v1`.
110
- # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
111
- # @return [boolean] Whether the service is available.
112
- #
113
- def self.resource_settings_service_available? version: :v1, transport: :grpc
114
- require "google/cloud/resource_settings/#{version.to_s.downcase}"
115
- package_name = Google::Cloud::ResourceSettings
116
- .constants
117
- .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
118
- .first
119
- return false unless package_name
120
- service_module = Google::Cloud::ResourceSettings.const_get package_name
121
- return false unless service_module.const_defined? :ResourceSettingsService
122
- service_module = service_module.const_get :ResourceSettingsService
123
- if transport == :rest
124
- return false unless service_module.const_defined? :Rest
125
- service_module = service_module.const_get :Rest
126
- end
127
- service_module.const_defined? :Client
128
- rescue ::LoadError
129
- false
130
- end
131
-
132
- ##
133
- # Configure the google-cloud-resource_settings library.
134
- #
135
- # The following configuration parameters are supported:
136
- #
137
- # * `credentials` (*type:* `String, Hash, Google::Auth::Credentials`) -
138
- # The path to the keyfile as a String, the contents of the keyfile as a
139
- # Hash, or a Google::Auth::Credentials object.
140
- # * `lib_name` (*type:* `String`) -
141
- # The library name as recorded in instrumentation and logging.
142
- # * `lib_version` (*type:* `String`) -
143
- # The library version as recorded in instrumentation and logging.
144
- # * `interceptors` (*type:* `Array<GRPC::ClientInterceptor>`) -
145
- # An array of interceptors that are run before calls are executed.
146
- # * `timeout` (*type:* `Numeric`) -
147
- # Default timeout in seconds.
148
- # * `metadata` (*type:* `Hash{Symbol=>String}`) -
149
- # Additional headers to be sent with the call.
150
- # * `retry_policy` (*type:* `Hash`) -
151
- # The retry policy. The value is a hash with the following keys:
152
- # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
153
- # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
154
- # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
155
- # * `:retry_codes` (*type:* `Array<String>`) -
156
- # The error codes that should trigger a retry.
157
- #
158
- # @return [::Google::Cloud::Config] The default configuration used by this library
159
- #
160
- def self.configure
161
- yield ::Google::Cloud.configure.resource_settings if block_given?
162
-
163
- ::Google::Cloud.configure.resource_settings
164
- end
165
- end
166
- end
167
- end
168
-
169
- helper_path = ::File.join __dir__, "resource_settings", "helpers.rb"
170
- require "google/cloud/resource_settings/helpers" if ::File.file? helper_path
@@ -1,19 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2021 Google LLC
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the "License");
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # https://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an "AS IS" BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
-
19
- require "google/cloud/resource_settings" unless defined? Google::Cloud::ResourceSettings::VERSION