google-cloud-app_engine 1.1.0 → 1.2.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.
Files changed (6) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +1 -1
  3. data/README.md +0 -26
  4. data/lib/google/cloud/app_engine/version.rb +1 -1
  5. data/lib/google/cloud/app_engine.rb +81 -49
  6. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c83d4f450164b641813c8d8e61edc00ffb060f271c1cf74f1f877409df10c2b8
4
- data.tar.gz: 9ee1fc22d3e5f07999d9479264ec656421de11178b5da45e30b076bfde6f4624
3
+ metadata.gz: 62dedd8ffda5bd64e6f1b1c743d40cd411283d46275472d54724ad4f268ac840
4
+ data.tar.gz: 0ead78ce8fd98488362653ce5004d869e1be1f7a8052966155c0eb2f8def6bad
5
5
  SHA512:
6
- metadata.gz: 00ba517fba08fc82e3d7e137a1ad9c4fc7b7463c46548902a526b3ab47597e856206efba608af932afd866e698e6baef3fb66c53af9609657c540bef1dc6a085
7
- data.tar.gz: 701696931403045a1ff72a1478504592a7e076f20d6447e1131aa66043009033a775565ce59d037305ff0e71f9f156a2bc2b40c49e7dffabea56d1dee7a9cb05
6
+ metadata.gz: a6eab0a6b443457dc2202fbc00fc18c92d4508f2364692605ea3fb445fec1fe89ea1212367aa0c067800b61a83a2ac18a7c8c36a285f3ce48c67cfc95099ead6
7
+ data.tar.gz: 44f4cb00f3f8d27095660b35569189fb8903d2a37e097dd130360493f8260c6ce522f6a31edea46487e8661b6ce7601a5aaccdba8a140e5a3c9cdeee05a99ad2
data/AUTHENTICATION.md CHANGED
@@ -114,7 +114,7 @@ credentials are discovered.
114
114
  To configure your system for this, simply:
115
115
 
116
116
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
117
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
118
  3. Write code as if already authenticated.
119
119
 
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
data/README.md CHANGED
@@ -34,32 +34,6 @@ In order to use this library, you first need to go through the following steps:
34
34
  1. [Enable the API.](https://console.cloud.google.com/apis/library/appengine.googleapis.com)
35
35
  1. {file:AUTHENTICATION.md Set up authentication.}
36
36
 
37
- ## Enabling Logging
38
-
39
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
40
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
41
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
42
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
43
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
44
-
45
- Configuring a Ruby stdlib logger:
46
-
47
- ```ruby
48
- require "logger"
49
-
50
- module MyLogger
51
- LOGGER = Logger.new $stderr, level: Logger::WARN
52
- def logger
53
- LOGGER
54
- end
55
- end
56
-
57
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
58
- module GRPC
59
- extend MyLogger
60
- end
61
- ```
62
-
63
37
  ## Supported Ruby Versions
64
38
 
65
39
  This library is supported on Ruby 2.6+.
data/lib/google/cloud/app_engine/version.rb CHANGED
@@ -20,7 +20,7 @@
20
20
  module Google
21
21
  module Cloud
22
22
  module AppEngine
23
- VERSION = "1.1.0"
23
+ VERSION = "1.2.0"
24
24
  end
25
25
  end
26
26
  end
data/lib/google/cloud/app_engine.rb CHANGED
@@ -49,11 +49,13 @@ module Google
49
49
  #
50
50
  # By default, this returns an instance of
51
51
  # [Google::Cloud::AppEngine::V1::Applications::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/Applications/Client.html)
52
- # for version V1 of the API.
53
- # However, you can specify specify a different API version by passing it in the
52
+ # for a gRPC client for version V1 of the API.
53
+ # However, you can specify a different API version by passing it in the
54
54
  # `version` parameter. If the Applications service is
55
55
  # supported by that API version, and the corresponding gem is available, the
56
56
  # appropriate versioned client will be returned.
57
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
58
+ # the `transport` parameter.
57
59
  #
58
60
  # ## About Applications
59
61
  #
@@ -61,17 +63,19 @@ module Google
61
63
  #
62
64
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
63
65
  # Defaults to `:v1`.
64
- # @return [Applications::Client] A client object for the specified version.
66
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
67
+ # @return [::Object] A client object for the specified version.
65
68
  #
66
- def self.applications version: :v1, &block
69
+ def self.applications version: :v1, transport: :grpc, &block
67
70
  require "google/cloud/app_engine/#{version.to_s.downcase}"
68
71
 
69
72
  package_name = Google::Cloud::AppEngine
70
73
  .constants
71
74
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
72
75
  .first
73
- package_module = Google::Cloud::AppEngine.const_get package_name
74
- package_module.const_get(:Applications).const_get(:Client).new(&block)
76
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:Applications)
77
+ service_module = service_module.const_get(:Rest) if transport == :rest
78
+ service_module.const_get(:Client).new(&block)
75
79
  end
76
80
 
77
81
  ##
@@ -79,11 +83,13 @@ module Google
79
83
  #
80
84
  # By default, this returns an instance of
81
85
  # [Google::Cloud::AppEngine::V1::Services::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/Services/Client.html)
82
- # for version V1 of the API.
83
- # However, you can specify specify a different API version by passing it in the
86
+ # for a gRPC client for version V1 of the API.
87
+ # However, you can specify a different API version by passing it in the
84
88
  # `version` parameter. If the Services service is
85
89
  # supported by that API version, and the corresponding gem is available, the
86
90
  # appropriate versioned client will be returned.
91
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
92
+ # the `transport` parameter.
87
93
  #
88
94
  # ## About Services
89
95
  #
@@ -91,17 +97,19 @@ module Google
91
97
  #
92
98
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
93
99
  # Defaults to `:v1`.
94
- # @return [Services::Client] A client object for the specified version.
100
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
101
+ # @return [::Object] A client object for the specified version.
95
102
  #
96
- def self.services version: :v1, &block
103
+ def self.services version: :v1, transport: :grpc, &block
97
104
  require "google/cloud/app_engine/#{version.to_s.downcase}"
98
105
 
99
106
  package_name = Google::Cloud::AppEngine
100
107
  .constants
101
108
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
102
109
  .first
103
- package_module = Google::Cloud::AppEngine.const_get package_name
104
- package_module.const_get(:Services).const_get(:Client).new(&block)
110
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:Services)
111
+ service_module = service_module.const_get(:Rest) if transport == :rest
112
+ service_module.const_get(:Client).new(&block)
105
113
  end
106
114
 
107
115
  ##
@@ -109,11 +117,13 @@ module Google
109
117
  #
110
118
  # By default, this returns an instance of
111
119
  # [Google::Cloud::AppEngine::V1::Versions::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/Versions/Client.html)
112
- # for version V1 of the API.
113
- # However, you can specify specify a different API version by passing it in the
120
+ # for a gRPC client for version V1 of the API.
121
+ # However, you can specify a different API version by passing it in the
114
122
  # `version` parameter. If the Versions service is
115
123
  # supported by that API version, and the corresponding gem is available, the
116
124
  # appropriate versioned client will be returned.
125
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
126
+ # the `transport` parameter.
117
127
  #
118
128
  # ## About Versions
119
129
  #
@@ -121,17 +131,19 @@ module Google
121
131
  #
122
132
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
123
133
  # Defaults to `:v1`.
124
- # @return [Versions::Client] A client object for the specified version.
134
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
135
+ # @return [::Object] A client object for the specified version.
125
136
  #
126
- def self.versions version: :v1, &block
137
+ def self.versions version: :v1, transport: :grpc, &block
127
138
  require "google/cloud/app_engine/#{version.to_s.downcase}"
128
139
 
129
140
  package_name = Google::Cloud::AppEngine
130
141
  .constants
131
142
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
132
143
  .first
133
- package_module = Google::Cloud::AppEngine.const_get package_name
134
- package_module.const_get(:Versions).const_get(:Client).new(&block)
144
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:Versions)
145
+ service_module = service_module.const_get(:Rest) if transport == :rest
146
+ service_module.const_get(:Client).new(&block)
135
147
  end
136
148
 
137
149
  ##
@@ -139,11 +151,13 @@ module Google
139
151
  #
140
152
  # By default, this returns an instance of
141
153
  # [Google::Cloud::AppEngine::V1::Instances::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/Instances/Client.html)
142
- # for version V1 of the API.
143
- # However, you can specify specify a different API version by passing it in the
154
+ # for a gRPC client for version V1 of the API.
155
+ # However, you can specify a different API version by passing it in the
144
156
  # `version` parameter. If the Instances service is
145
157
  # supported by that API version, and the corresponding gem is available, the
146
158
  # appropriate versioned client will be returned.
159
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
160
+ # the `transport` parameter.
147
161
  #
148
162
  # ## About Instances
149
163
  #
@@ -151,17 +165,19 @@ module Google
151
165
  #
152
166
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
153
167
  # Defaults to `:v1`.
154
- # @return [Instances::Client] A client object for the specified version.
168
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
169
+ # @return [::Object] A client object for the specified version.
155
170
  #
156
- def self.instances version: :v1, &block
171
+ def self.instances version: :v1, transport: :grpc, &block
157
172
  require "google/cloud/app_engine/#{version.to_s.downcase}"
158
173
 
159
174
  package_name = Google::Cloud::AppEngine
160
175
  .constants
161
176
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
162
177
  .first
163
- package_module = Google::Cloud::AppEngine.const_get package_name
164
- package_module.const_get(:Instances).const_get(:Client).new(&block)
178
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:Instances)
179
+ service_module = service_module.const_get(:Rest) if transport == :rest
180
+ service_module.const_get(:Client).new(&block)
165
181
  end
166
182
 
167
183
  ##
@@ -169,11 +185,13 @@ module Google
169
185
  #
170
186
  # By default, this returns an instance of
171
187
  # [Google::Cloud::AppEngine::V1::Firewall::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/Firewall/Client.html)
172
- # for version V1 of the API.
173
- # However, you can specify specify a different API version by passing it in the
188
+ # for a gRPC client for version V1 of the API.
189
+ # However, you can specify a different API version by passing it in the
174
190
  # `version` parameter. If the Firewall service is
175
191
  # supported by that API version, and the corresponding gem is available, the
176
192
  # appropriate versioned client will be returned.
193
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
194
+ # the `transport` parameter.
177
195
  #
178
196
  # ## About Firewall
179
197
  #
@@ -190,17 +208,19 @@ module Google
190
208
  #
191
209
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
192
210
  # Defaults to `:v1`.
193
- # @return [Firewall::Client] A client object for the specified version.
211
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
212
+ # @return [::Object] A client object for the specified version.
194
213
  #
195
- def self.firewall version: :v1, &block
214
+ def self.firewall version: :v1, transport: :grpc, &block
196
215
  require "google/cloud/app_engine/#{version.to_s.downcase}"
197
216
 
198
217
  package_name = Google::Cloud::AppEngine
199
218
  .constants
200
219
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
201
220
  .first
202
- package_module = Google::Cloud::AppEngine.const_get package_name
203
- package_module.const_get(:Firewall).const_get(:Client).new(&block)
221
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:Firewall)
222
+ service_module = service_module.const_get(:Rest) if transport == :rest
223
+ service_module.const_get(:Client).new(&block)
204
224
  end
205
225
 
206
226
  ##
@@ -208,11 +228,13 @@ module Google
208
228
  #
209
229
  # By default, this returns an instance of
210
230
  # [Google::Cloud::AppEngine::V1::AuthorizedDomains::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/AuthorizedDomains/Client.html)
211
- # for version V1 of the API.
212
- # However, you can specify specify a different API version by passing it in the
231
+ # for a gRPC client for version V1 of the API.
232
+ # However, you can specify a different API version by passing it in the
213
233
  # `version` parameter. If the AuthorizedDomains service is
214
234
  # supported by that API version, and the corresponding gem is available, the
215
235
  # appropriate versioned client will be returned.
236
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
237
+ # the `transport` parameter.
216
238
  #
217
239
  # ## About AuthorizedDomains
218
240
  #
@@ -222,17 +244,19 @@ module Google
222
244
  #
223
245
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
224
246
  # Defaults to `:v1`.
225
- # @return [AuthorizedDomains::Client] A client object for the specified version.
247
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
248
+ # @return [::Object] A client object for the specified version.
226
249
  #
227
- def self.authorized_domains version: :v1, &block
250
+ def self.authorized_domains version: :v1, transport: :grpc, &block
228
251
  require "google/cloud/app_engine/#{version.to_s.downcase}"
229
252
 
230
253
  package_name = Google::Cloud::AppEngine
231
254
  .constants
232
255
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
233
256
  .first
234
- package_module = Google::Cloud::AppEngine.const_get package_name
235
- package_module.const_get(:AuthorizedDomains).const_get(:Client).new(&block)
257
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:AuthorizedDomains)
258
+ service_module = service_module.const_get(:Rest) if transport == :rest
259
+ service_module.const_get(:Client).new(&block)
236
260
  end
237
261
 
238
262
  ##
@@ -240,11 +264,13 @@ module Google
240
264
  #
241
265
  # By default, this returns an instance of
242
266
  # [Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/AuthorizedCertificates/Client.html)
243
- # for version V1 of the API.
244
- # However, you can specify specify a different API version by passing it in the
267
+ # for a gRPC client for version V1 of the API.
268
+ # However, you can specify a different API version by passing it in the
245
269
  # `version` parameter. If the AuthorizedCertificates service is
246
270
  # supported by that API version, and the corresponding gem is available, the
247
271
  # appropriate versioned client will be returned.
272
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
273
+ # the `transport` parameter.
248
274
  #
249
275
  # ## About AuthorizedCertificates
250
276
  #
@@ -253,17 +279,19 @@ module Google
253
279
  #
254
280
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
255
281
  # Defaults to `:v1`.
256
- # @return [AuthorizedCertificates::Client] A client object for the specified version.
282
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
283
+ # @return [::Object] A client object for the specified version.
257
284
  #
258
- def self.authorized_certificates version: :v1, &block
285
+ def self.authorized_certificates version: :v1, transport: :grpc, &block
259
286
  require "google/cloud/app_engine/#{version.to_s.downcase}"
260
287
 
261
288
  package_name = Google::Cloud::AppEngine
262
289
  .constants
263
290
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
264
291
  .first
265
- package_module = Google::Cloud::AppEngine.const_get package_name
266
- package_module.const_get(:AuthorizedCertificates).const_get(:Client).new(&block)
292
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:AuthorizedCertificates)
293
+ service_module = service_module.const_get(:Rest) if transport == :rest
294
+ service_module.const_get(:Client).new(&block)
267
295
  end
268
296
 
269
297
  ##
@@ -271,11 +299,13 @@ module Google
271
299
  #
272
300
  # By default, this returns an instance of
273
301
  # [Google::Cloud::AppEngine::V1::DomainMappings::Client](https://googleapis.dev/ruby/google-cloud-app_engine-v1/latest/Google/Cloud/AppEngine/V1/DomainMappings/Client.html)
274
- # for version V1 of the API.
275
- # However, you can specify specify a different API version by passing it in the
302
+ # for a gRPC client for version V1 of the API.
303
+ # However, you can specify a different API version by passing it in the
276
304
  # `version` parameter. If the DomainMappings service is
277
305
  # supported by that API version, and the corresponding gem is available, the
278
306
  # appropriate versioned client will be returned.
307
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
308
+ # the `transport` parameter.
279
309
  #
280
310
  # ## About DomainMappings
281
311
  #
@@ -283,17 +313,19 @@ module Google
283
313
  #
284
314
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
285
315
  # Defaults to `:v1`.
286
- # @return [DomainMappings::Client] A client object for the specified version.
316
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
317
+ # @return [::Object] A client object for the specified version.
287
318
  #
288
- def self.domain_mappings version: :v1, &block
319
+ def self.domain_mappings version: :v1, transport: :grpc, &block
289
320
  require "google/cloud/app_engine/#{version.to_s.downcase}"
290
321
 
291
322
  package_name = Google::Cloud::AppEngine
292
323
  .constants
293
324
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
294
325
  .first
295
- package_module = Google::Cloud::AppEngine.const_get package_name
296
- package_module.const_get(:DomainMappings).const_get(:Client).new(&block)
326
+ service_module = Google::Cloud::AppEngine.const_get(package_name).const_get(:DomainMappings)
327
+ service_module = service_module.const_get(:Rest) if transport == :rest
328
+ service_module.const_get(:Client).new(&block)
297
329
  end
298
330
 
299
331
  ##
@@ -313,7 +345,7 @@ module Google
313
345
  # * `timeout` (*type:* `Numeric`) -
314
346
  # Default timeout in seconds.
315
347
  # * `metadata` (*type:* `Hash{Symbol=>String}`) -
316
- # Additional gRPC headers to be sent with the call.
348
+ # Additional headers to be sent with the call.
317
349
  # * `retry_policy` (*type:* `Hash`) -
318
350
  # The retry policy. The value is a hash with the following keys:
319
351
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-app_engine
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-07-01 00:00:00.000000000 Z
11
+ date: 2023-03-09 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-cloud-app_engine-v1
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.3'
19
+ version: '0.6'
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: '0.3'
29
+ version: '0.6'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -188,7 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
188
188
  - !ruby/object:Gem::Version
189
189
  version: '0'
190
190
  requirements: []
191
- rubygems_version: 3.3.14
191
+ rubygems_version: 3.4.2
192
192
  signing_key:
193
193
  specification_version: 4
194
194
  summary: API Client library for the App Engine Admin API