google-cloud-app_engine 1.1.0 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
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