google-cloud-dataflow-v1beta3 0.9.0 → 0.10.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (24) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/client.rb +32 -3
  4. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/client.rb +32 -3
  5. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/service_stub.rb +22 -8
  6. data/lib/google/cloud/dataflow/v1beta3/jobs/client.rb +46 -15
  7. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/client.rb +42 -13
  8. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/service_stub.rb +62 -38
  9. data/lib/google/cloud/dataflow/v1beta3/messages/client.rb +33 -3
  10. data/lib/google/cloud/dataflow/v1beta3/messages/rest/client.rb +32 -3
  11. data/lib/google/cloud/dataflow/v1beta3/messages/rest/service_stub.rb +22 -8
  12. data/lib/google/cloud/dataflow/v1beta3/metrics/client.rb +38 -7
  13. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/client.rb +38 -7
  14. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/service_stub.rb +38 -20
  15. data/lib/google/cloud/dataflow/v1beta3/snapshots/client.rb +36 -7
  16. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/client.rb +36 -7
  17. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/service_stub.rb +38 -20
  18. data/lib/google/cloud/dataflow/v1beta3/templates_service/client.rb +36 -7
  19. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/client.rb +36 -7
  20. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/service_stub.rb +38 -20
  21. data/lib/google/cloud/dataflow/v1beta3/version.rb +1 -1
  22. data/proto_docs/google/api/client.rb +74 -10
  23. data/proto_docs/google/api/resource.rb +7 -2
  24. metadata +5 -5
@@ -33,6 +33,9 @@ module Google
33
33
  # A Job is a multi-stage computation graph run by the Cloud Dataflow service.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ API_VERSION = ""
38
+
36
39
  # @private
37
40
  DEFAULT_ENDPOINT_TEMPLATE = "dataflow.$UNIVERSE_DOMAIN$"
38
41
 
@@ -148,8 +151,28 @@ module Google
148
151
  endpoint: @config.endpoint,
149
152
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
150
153
  universe_domain: @config.universe_domain,
151
- credentials: credentials
154
+ credentials: credentials,
155
+ logger: @config.logger
152
156
  )
157
+
158
+ @jobs_stub.logger(stub: true)&.info do |entry|
159
+ entry.set_system_name
160
+ entry.set_service
161
+ entry.message = "Created client for #{entry.service}"
162
+ entry.set_credentials_fields credentials
163
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
164
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
165
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
166
+ end
167
+ end
168
+
169
+ ##
170
+ # The logger used for request/response debug logging.
171
+ #
172
+ # @return [Logger]
173
+ #
174
+ def logger
175
+ @jobs_stub.logger
153
176
  end
154
177
 
155
178
  # Service calls
@@ -224,12 +247,13 @@ module Google
224
247
  # Customize the options with defaults
225
248
  call_metadata = @config.rpcs.create_job.metadata.to_h
226
249
 
227
- # Set x-goog-api-client and x-goog-user-project headers
250
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
228
251
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
229
252
  lib_name: @config.lib_name, lib_version: @config.lib_version,
230
253
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
231
254
  transports_version_send: [:rest]
232
255
 
256
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
233
257
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
234
258
 
235
259
  options.apply_defaults timeout: @config.rpcs.create_job.timeout,
@@ -242,7 +266,6 @@ module Google
242
266
 
243
267
  @jobs_stub.create_job request, options do |result, operation|
244
268
  yield result, operation if block_given?
245
- return result
246
269
  end
247
270
  rescue ::Gapic::Rest::Error => e
248
271
  raise ::Google::Cloud::Error.from_error(e)
@@ -316,12 +339,13 @@ module Google
316
339
  # Customize the options with defaults
317
340
  call_metadata = @config.rpcs.get_job.metadata.to_h
318
341
 
319
- # Set x-goog-api-client and x-goog-user-project headers
342
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
320
343
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
321
344
  lib_name: @config.lib_name, lib_version: @config.lib_version,
322
345
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
323
346
  transports_version_send: [:rest]
324
347
 
348
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
325
349
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
326
350
 
327
351
  options.apply_defaults timeout: @config.rpcs.get_job.timeout,
@@ -334,7 +358,6 @@ module Google
334
358
 
335
359
  @jobs_stub.get_job request, options do |result, operation|
336
360
  yield result, operation if block_given?
337
- return result
338
361
  end
339
362
  rescue ::Gapic::Rest::Error => e
340
363
  raise ::Google::Cloud::Error.from_error(e)
@@ -409,12 +432,13 @@ module Google
409
432
  # Customize the options with defaults
410
433
  call_metadata = @config.rpcs.update_job.metadata.to_h
411
434
 
412
- # Set x-goog-api-client and x-goog-user-project headers
435
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
413
436
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
414
437
  lib_name: @config.lib_name, lib_version: @config.lib_version,
415
438
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
416
439
  transports_version_send: [:rest]
417
440
 
441
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
418
442
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
419
443
 
420
444
  options.apply_defaults timeout: @config.rpcs.update_job.timeout,
@@ -427,7 +451,6 @@ module Google
427
451
 
428
452
  @jobs_stub.update_job request, options do |result, operation|
429
453
  yield result, operation if block_given?
430
- return result
431
454
  end
432
455
  rescue ::Gapic::Rest::Error => e
433
456
  raise ::Google::Cloud::Error.from_error(e)
@@ -514,12 +537,13 @@ module Google
514
537
  # Customize the options with defaults
515
538
  call_metadata = @config.rpcs.list_jobs.metadata.to_h
516
539
 
517
- # Set x-goog-api-client and x-goog-user-project headers
540
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
518
541
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
519
542
  lib_name: @config.lib_name, lib_version: @config.lib_version,
520
543
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
521
544
  transports_version_send: [:rest]
522
545
 
546
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
523
547
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
524
548
 
525
549
  options.apply_defaults timeout: @config.rpcs.list_jobs.timeout,
@@ -532,7 +556,6 @@ module Google
532
556
 
533
557
  @jobs_stub.list_jobs request, options do |result, operation|
534
558
  yield result, operation if block_given?
535
- return result
536
559
  end
537
560
  rescue ::Gapic::Rest::Error => e
538
561
  raise ::Google::Cloud::Error.from_error(e)
@@ -612,12 +635,13 @@ module Google
612
635
  # Customize the options with defaults
613
636
  call_metadata = @config.rpcs.aggregated_list_jobs.metadata.to_h
614
637
 
615
- # Set x-goog-api-client and x-goog-user-project headers
638
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
616
639
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
617
640
  lib_name: @config.lib_name, lib_version: @config.lib_version,
618
641
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
619
642
  transports_version_send: [:rest]
620
643
 
644
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
621
645
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
622
646
 
623
647
  options.apply_defaults timeout: @config.rpcs.aggregated_list_jobs.timeout,
@@ -630,7 +654,6 @@ module Google
630
654
 
631
655
  @jobs_stub.aggregated_list_jobs request, options do |result, operation|
632
656
  yield result, operation if block_given?
633
- return result
634
657
  end
635
658
  rescue ::Gapic::Rest::Error => e
636
659
  raise ::Google::Cloud::Error.from_error(e)
@@ -700,12 +723,13 @@ module Google
700
723
  # Customize the options with defaults
701
724
  call_metadata = @config.rpcs.snapshot_job.metadata.to_h
702
725
 
703
- # Set x-goog-api-client and x-goog-user-project headers
726
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
704
727
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
705
728
  lib_name: @config.lib_name, lib_version: @config.lib_version,
706
729
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
707
730
  transports_version_send: [:rest]
708
731
 
732
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
709
733
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
710
734
 
711
735
  options.apply_defaults timeout: @config.rpcs.snapshot_job.timeout,
@@ -718,7 +742,6 @@ module Google
718
742
 
719
743
  @jobs_stub.snapshot_job request, options do |result, operation|
720
744
  yield result, operation if block_given?
721
- return result
722
745
  end
723
746
  rescue ::Gapic::Rest::Error => e
724
747
  raise ::Google::Cloud::Error.from_error(e)
@@ -798,6 +821,11 @@ module Google
798
821
  # default endpoint URL. The default value of nil uses the environment
799
822
  # universe (usually the default "googleapis.com" universe).
800
823
  # @return [::String,nil]
824
+ # @!attribute [rw] logger
825
+ # A custom logger to use for request/response debug logging, or the value
826
+ # `:default` (the default) to construct a default logger, or `nil` to
827
+ # explicitly disable logging.
828
+ # @return [::Logger,:default,nil]
801
829
  #
802
830
  class Configuration
803
831
  extend ::Gapic::Config
@@ -819,6 +847,7 @@ module Google
819
847
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
820
848
  config_attr :quota_project, nil, ::String, nil
821
849
  config_attr :universe_domain, nil, ::String, nil
850
+ config_attr :logger, :default, ::Logger, nil, :default
822
851
 
823
852
  # @private
824
853
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the create_job REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "create_job",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Dataflow::V1beta3::Job.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "get_job",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Dataflow::V1beta3::Job.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "update_job",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::Dataflow::V1beta3::Job.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -201,16 +219,18 @@ module Google
201
219
 
202
220
  response = @client_stub.make_http_request(
203
221
  verb,
204
- uri: uri,
205
- body: body || "",
206
- params: query_string_params,
222
+ uri: uri,
223
+ body: body || "",
224
+ params: query_string_params,
225
+ method_name: "list_jobs",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Cloud::Dataflow::V1beta3::ListJobsResponse.decode_json response.body, ignore_unknown_fields: true
211
-
212
- yield result, operation if block_given?
213
- result
230
+ catch :response do
231
+ yield result, operation if block_given?
232
+ result
233
+ end
214
234
  end
215
235
 
216
236
  ##
@@ -239,16 +259,18 @@ module Google
239
259
 
240
260
  response = @client_stub.make_http_request(
241
261
  verb,
242
- uri: uri,
243
- body: body || "",
244
- params: query_string_params,
262
+ uri: uri,
263
+ body: body || "",
264
+ params: query_string_params,
265
+ method_name: "aggregated_list_jobs",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Cloud::Dataflow::V1beta3::ListJobsResponse.decode_json response.body, ignore_unknown_fields: true
249
-
250
- yield result, operation if block_given?
251
- result
270
+ catch :response do
271
+ yield result, operation if block_given?
272
+ result
273
+ end
252
274
  end
253
275
 
254
276
  ##
@@ -277,16 +299,18 @@ module Google
277
299
 
278
300
  response = @client_stub.make_http_request(
279
301
  verb,
280
- uri: uri,
281
- body: body || "",
282
- params: query_string_params,
302
+ uri: uri,
303
+ body: body || "",
304
+ params: query_string_params,
305
+ method_name: "snapshot_job",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Cloud::Dataflow::V1beta3::Snapshot.decode_json response.body, ignore_unknown_fields: true
287
-
288
- yield result, operation if block_given?
289
- result
310
+ catch :response do
311
+ yield result, operation if block_given?
312
+ result
313
+ end
290
314
  end
291
315
 
292
316
  ##
@@ -31,6 +31,9 @@ module Google
31
31
  # Dataflow jobs.
32
32
  #
33
33
  class Client
34
+ # @private
35
+ API_VERSION = ""
36
+
34
37
  # @private
35
38
  DEFAULT_ENDPOINT_TEMPLATE = "dataflow.$UNIVERSE_DOMAIN$"
36
39
 
@@ -155,8 +158,28 @@ module Google
155
158
  universe_domain: @config.universe_domain,
156
159
  channel_args: @config.channel_args,
157
160
  interceptors: @config.interceptors,
158
- channel_pool_config: @config.channel_pool
161
+ channel_pool_config: @config.channel_pool,
162
+ logger: @config.logger
159
163
  )
164
+
165
+ @messages_stub.stub_logger&.info do |entry|
166
+ entry.set_system_name
167
+ entry.set_service
168
+ entry.message = "Created client for #{entry.service}"
169
+ entry.set_credentials_fields credentials
170
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
171
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
172
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
173
+ end
174
+ end
175
+
176
+ ##
177
+ # The logger used for request/response debug logging.
178
+ #
179
+ # @return [Logger]
180
+ #
181
+ def logger
182
+ @messages_stub.logger
160
183
  end
161
184
 
162
185
  # Service calls
@@ -248,10 +271,11 @@ module Google
248
271
  # Customize the options with defaults
249
272
  metadata = @config.rpcs.list_job_messages.metadata.to_h
250
273
 
251
- # Set x-goog-api-client and x-goog-user-project headers
274
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
252
275
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
253
276
  lib_name: @config.lib_name, lib_version: @config.lib_version,
254
277
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION
278
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
255
279
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
256
280
 
257
281
  header_params = {}
@@ -279,7 +303,7 @@ module Google
279
303
  @messages_stub.call_rpc :list_job_messages, request, options: options do |response, operation|
280
304
  response = ::Gapic::PagedEnumerable.new @messages_stub, :list_job_messages, request, response, operation, options
281
305
  yield response, operation if block_given?
282
- return response
306
+ throw :response, response
283
307
  end
284
308
  rescue ::GRPC::BadStatus => e
285
309
  raise ::Google::Cloud::Error.from_error(e)
@@ -368,6 +392,11 @@ module Google
368
392
  # default endpoint URL. The default value of nil uses the environment
369
393
  # universe (usually the default "googleapis.com" universe).
370
394
  # @return [::String,nil]
395
+ # @!attribute [rw] logger
396
+ # A custom logger to use for request/response debug logging, or the value
397
+ # `:default` (the default) to construct a default logger, or `nil` to
398
+ # explicitly disable logging.
399
+ # @return [::Logger,:default,nil]
371
400
  #
372
401
  class Configuration
373
402
  extend ::Gapic::Config
@@ -392,6 +421,7 @@ module Google
392
421
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
393
422
  config_attr :quota_project, nil, ::String, nil
394
423
  config_attr :universe_domain, nil, ::String, nil
424
+ config_attr :logger, :default, ::Logger, nil, :default
395
425
 
396
426
  # @private
397
427
  def initialize parent_config = nil
@@ -33,6 +33,9 @@ module Google
33
33
  # Dataflow jobs.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ API_VERSION = ""
38
+
36
39
  # @private
37
40
  DEFAULT_ENDPOINT_TEMPLATE = "dataflow.$UNIVERSE_DOMAIN$"
38
41
 
@@ -148,8 +151,28 @@ module Google
148
151
  endpoint: @config.endpoint,
149
152
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
150
153
  universe_domain: @config.universe_domain,
151
- credentials: credentials
154
+ credentials: credentials,
155
+ logger: @config.logger
152
156
  )
157
+
158
+ @messages_stub.logger(stub: true)&.info do |entry|
159
+ entry.set_system_name
160
+ entry.set_service
161
+ entry.message = "Created client for #{entry.service}"
162
+ entry.set_credentials_fields credentials
163
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
164
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
165
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
166
+ end
167
+ end
168
+
169
+ ##
170
+ # The logger used for request/response debug logging.
171
+ #
172
+ # @return [Logger]
173
+ #
174
+ def logger
175
+ @messages_stub.logger
153
176
  end
154
177
 
155
178
  # Service calls
@@ -240,12 +263,13 @@ module Google
240
263
  # Customize the options with defaults
241
264
  call_metadata = @config.rpcs.list_job_messages.metadata.to_h
242
265
 
243
- # Set x-goog-api-client and x-goog-user-project headers
266
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
244
267
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
245
268
  lib_name: @config.lib_name, lib_version: @config.lib_version,
246
269
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
247
270
  transports_version_send: [:rest]
248
271
 
272
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
249
273
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
250
274
 
251
275
  options.apply_defaults timeout: @config.rpcs.list_job_messages.timeout,
@@ -258,7 +282,6 @@ module Google
258
282
 
259
283
  @messages_stub.list_job_messages request, options do |result, operation|
260
284
  yield result, operation if block_given?
261
- return result
262
285
  end
263
286
  rescue ::Gapic::Rest::Error => e
264
287
  raise ::Google::Cloud::Error.from_error(e)
@@ -338,6 +361,11 @@ module Google
338
361
  # default endpoint URL. The default value of nil uses the environment
339
362
  # universe (usually the default "googleapis.com" universe).
340
363
  # @return [::String,nil]
364
+ # @!attribute [rw] logger
365
+ # A custom logger to use for request/response debug logging, or the value
366
+ # `:default` (the default) to construct a default logger, or `nil` to
367
+ # explicitly disable logging.
368
+ # @return [::Logger,:default,nil]
341
369
  #
342
370
  class Configuration
343
371
  extend ::Gapic::Config
@@ -359,6 +387,7 @@ module Google
359
387
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
360
388
  config_attr :quota_project, nil, ::String, nil
361
389
  config_attr :universe_domain, nil, ::String, nil
390
+ config_attr :logger, :default, ::Logger, nil, :default
362
391
 
363
392
  # @private
364
393
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the list_job_messages REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "list_job_messages",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Dataflow::V1beta3::ListJobMessagesResponse.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##