google-cloud-binary_authorization-v1beta1 0.13.1 → 0.14.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f5bc666db54edf37046522c8e3d6434d146c55afeb2bcc88f3ab073b572ed9a4
4
- data.tar.gz: 2db3c9df2c3c578061c877a6111493334b77a91bc303e153faae0c2f2d72243f
3
+ metadata.gz: ef8e90a0bca04376c531dd4857c38436fbdd9f85e459cbe436845bfd949fd344
4
+ data.tar.gz: 04a9d1b6c8d9f86ba773d2d26ce25e64782b3d75f984b89c5c09f5cdde8ead62
5
5
  SHA512:
6
- metadata.gz: a6b72bdd07d47abf6a49bd7793c1b79c8ef7d95d151c538d3b70baee95a73c4046d0b46cdda714e3913c7d674f696dc2ea7ede48ad36bdf9d022fecf6c9608fd
7
- data.tar.gz: 2fcc24f339e86fcd0d959e287b34fcd7ea0dc87dbb416c51802c7a0cbd21aba5b467bd68c14458cb60ff3d7a9fb36ddf92c4763ee66fe410dc5d3096d34e1d72
6
+ metadata.gz: 1d09ab1328896956d83e32c428aa3d1a594e6c58a4d3e493b7ee26c1cec95f63f34e05c9b1178e4607142c046d8462b1ee7bc9432e0cc106e4d90242c2d41cc6
7
+ data.tar.gz: bef8a56221a44fa303d18bd33cb1db9e03c8344a0f545caba1d026cada779a7fda6a3d0d50aee716149103af903a5e954ac00b8fbe2ac2e0c433247a5cf92939
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/binary-authorization/)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
48
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
- 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)
52
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/binary_authorization/v1beta1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::BinaryAuthorization::V1beta1::BinauthzManagementService::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -195,8 +195,28 @@ module Google
195
195
  universe_domain: @config.universe_domain,
196
196
  channel_args: @config.channel_args,
197
197
  interceptors: @config.interceptors,
198
- channel_pool_config: @config.channel_pool
198
+ channel_pool_config: @config.channel_pool,
199
+ logger: @config.logger
199
200
  )
201
+
202
+ @binauthz_management_service_stub.stub_logger&.info do |entry|
203
+ entry.set_system_name
204
+ entry.set_service
205
+ entry.message = "Created client for #{entry.service}"
206
+ entry.set_credentials_fields credentials
207
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
208
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
209
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
210
+ end
211
+ end
212
+
213
+ ##
214
+ # The logger used for request/response debug logging.
215
+ #
216
+ # @return [Logger]
217
+ #
218
+ def logger
219
+ @binauthz_management_service_stub.logger
200
220
  end
201
221
 
202
222
  # Service calls
@@ -288,7 +308,6 @@ module Google
288
308
 
289
309
  @binauthz_management_service_stub.call_rpc :get_policy, request, options: options do |response, operation|
290
310
  yield response, operation if block_given?
291
- return response
292
311
  end
293
312
  rescue ::GRPC::BadStatus => e
294
313
  raise ::Google::Cloud::Error.from_error(e)
@@ -380,7 +399,6 @@ module Google
380
399
 
381
400
  @binauthz_management_service_stub.call_rpc :update_policy, request, options: options do |response, operation|
382
401
  yield response, operation if block_given?
383
- return response
384
402
  end
385
403
  rescue ::GRPC::BadStatus => e
386
404
  raise ::Google::Cloud::Error.from_error(e)
@@ -475,7 +493,6 @@ module Google
475
493
 
476
494
  @binauthz_management_service_stub.call_rpc :create_attestor, request, options: options do |response, operation|
477
495
  yield response, operation if block_given?
478
- return response
479
496
  end
480
497
  rescue ::GRPC::BadStatus => e
481
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -563,7 +580,6 @@ module Google
563
580
 
564
581
  @binauthz_management_service_stub.call_rpc :get_attestor, request, options: options do |response, operation|
565
582
  yield response, operation if block_given?
566
- return response
567
583
  end
568
584
  rescue ::GRPC::BadStatus => e
569
585
  raise ::Google::Cloud::Error.from_error(e)
@@ -652,7 +668,6 @@ module Google
652
668
 
653
669
  @binauthz_management_service_stub.call_rpc :update_attestor, request, options: options do |response, operation|
654
670
  yield response, operation if block_given?
655
- return response
656
671
  end
657
672
  rescue ::GRPC::BadStatus => e
658
673
  raise ::Google::Cloud::Error.from_error(e)
@@ -752,7 +767,7 @@ module Google
752
767
  @binauthz_management_service_stub.call_rpc :list_attestors, request, options: options do |response, operation|
753
768
  response = ::Gapic::PagedEnumerable.new @binauthz_management_service_stub, :list_attestors, request, response, operation, options
754
769
  yield response, operation if block_given?
755
- return response
770
+ throw :response, response
756
771
  end
757
772
  rescue ::GRPC::BadStatus => e
758
773
  raise ::Google::Cloud::Error.from_error(e)
@@ -840,7 +855,6 @@ module Google
840
855
 
841
856
  @binauthz_management_service_stub.call_rpc :delete_attestor, request, options: options do |response, operation|
842
857
  yield response, operation if block_given?
843
- return response
844
858
  end
845
859
  rescue ::GRPC::BadStatus => e
846
860
  raise ::Google::Cloud::Error.from_error(e)
@@ -929,6 +943,11 @@ module Google
929
943
  # default endpoint URL. The default value of nil uses the environment
930
944
  # universe (usually the default "googleapis.com" universe).
931
945
  # @return [::String,nil]
946
+ # @!attribute [rw] logger
947
+ # A custom logger to use for request/response debug logging, or the value
948
+ # `:default` (the default) to construct a default logger, or `nil` to
949
+ # explicitly disable logging.
950
+ # @return [::Logger,:default,nil]
932
951
  #
933
952
  class Configuration
934
953
  extend ::Gapic::Config
@@ -953,6 +972,7 @@ module Google
953
972
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
954
973
  config_attr :quota_project, nil, ::String, nil
955
974
  config_attr :universe_domain, nil, ::String, nil
975
+ config_attr :logger, :default, ::Logger, nil, :default
956
976
 
957
977
  # @private
958
978
  def initialize parent_config = nil
@@ -188,8 +188,28 @@ module Google
188
188
  endpoint: @config.endpoint,
189
189
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
190
190
  universe_domain: @config.universe_domain,
191
- credentials: credentials
191
+ credentials: credentials,
192
+ logger: @config.logger
192
193
  )
194
+
195
+ @binauthz_management_service_stub.logger(stub: true)&.info do |entry|
196
+ entry.set_system_name
197
+ entry.set_service
198
+ entry.message = "Created client for #{entry.service}"
199
+ entry.set_credentials_fields credentials
200
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
201
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
202
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
203
+ end
204
+ end
205
+
206
+ ##
207
+ # The logger used for request/response debug logging.
208
+ #
209
+ # @return [Logger]
210
+ #
211
+ def logger
212
+ @binauthz_management_service_stub.logger
193
213
  end
194
214
 
195
215
  # Service calls
@@ -274,7 +294,6 @@ module Google
274
294
 
275
295
  @binauthz_management_service_stub.get_policy request, options do |result, operation|
276
296
  yield result, operation if block_given?
277
- return result
278
297
  end
279
298
  rescue ::Gapic::Rest::Error => e
280
299
  raise ::Google::Cloud::Error.from_error(e)
@@ -359,7 +378,6 @@ module Google
359
378
 
360
379
  @binauthz_management_service_stub.update_policy request, options do |result, operation|
361
380
  yield result, operation if block_given?
362
- return result
363
381
  end
364
382
  rescue ::Gapic::Rest::Error => e
365
383
  raise ::Google::Cloud::Error.from_error(e)
@@ -447,7 +465,6 @@ module Google
447
465
 
448
466
  @binauthz_management_service_stub.create_attestor request, options do |result, operation|
449
467
  yield result, operation if block_given?
450
- return result
451
468
  end
452
469
  rescue ::Gapic::Rest::Error => e
453
470
  raise ::Google::Cloud::Error.from_error(e)
@@ -528,7 +545,6 @@ module Google
528
545
 
529
546
  @binauthz_management_service_stub.get_attestor request, options do |result, operation|
530
547
  yield result, operation if block_given?
531
- return result
532
548
  end
533
549
  rescue ::Gapic::Rest::Error => e
534
550
  raise ::Google::Cloud::Error.from_error(e)
@@ -610,7 +626,6 @@ module Google
610
626
 
611
627
  @binauthz_management_service_stub.update_attestor request, options do |result, operation|
612
628
  yield result, operation if block_given?
613
- return result
614
629
  end
615
630
  rescue ::Gapic::Rest::Error => e
616
631
  raise ::Google::Cloud::Error.from_error(e)
@@ -703,7 +718,7 @@ module Google
703
718
  @binauthz_management_service_stub.list_attestors request, options do |result, operation|
704
719
  result = ::Gapic::Rest::PagedEnumerable.new @binauthz_management_service_stub, :list_attestors, "attestors", request, result, options
705
720
  yield result, operation if block_given?
706
- return result
721
+ throw :response, result
707
722
  end
708
723
  rescue ::Gapic::Rest::Error => e
709
724
  raise ::Google::Cloud::Error.from_error(e)
@@ -784,7 +799,6 @@ module Google
784
799
 
785
800
  @binauthz_management_service_stub.delete_attestor request, options do |result, operation|
786
801
  yield result, operation if block_given?
787
- return result
788
802
  end
789
803
  rescue ::Gapic::Rest::Error => e
790
804
  raise ::Google::Cloud::Error.from_error(e)
@@ -864,6 +878,11 @@ module Google
864
878
  # default endpoint URL. The default value of nil uses the environment
865
879
  # universe (usually the default "googleapis.com" universe).
866
880
  # @return [::String,nil]
881
+ # @!attribute [rw] logger
882
+ # A custom logger to use for request/response debug logging, or the value
883
+ # `:default` (the default) to construct a default logger, or `nil` to
884
+ # explicitly disable logging.
885
+ # @return [::Logger,:default,nil]
867
886
  #
868
887
  class Configuration
869
888
  extend ::Gapic::Config
@@ -885,6 +904,7 @@ module Google
885
904
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
886
905
  config_attr :quota_project, nil, ::String, nil
887
906
  config_attr :universe_domain, nil, ::String, nil
907
+ config_attr :logger, :default, ::Logger, nil, :default
888
908
 
889
909
  # @private
890
910
  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 get_policy 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: "get_policy",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::BinaryAuthorization::V1beta1::Policy.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: "update_policy",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::BinaryAuthorization::V1beta1::Policy.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: "create_attestor",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::BinaryAuthorization::V1beta1::Attestor.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: "get_attestor",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Cloud::BinaryAuthorization::V1beta1::Attestor.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: "update_attestor",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Cloud::BinaryAuthorization::V1beta1::Attestor.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: "list_attestors",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Cloud::BinaryAuthorization::V1beta1::ListAttestorsResponse.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
  ##
@@ -315,16 +339,18 @@ module Google
315
339
 
316
340
  response = @client_stub.make_http_request(
317
341
  verb,
318
- uri: uri,
319
- body: body || "",
320
- params: query_string_params,
342
+ uri: uri,
343
+ body: body || "",
344
+ params: query_string_params,
345
+ method_name: "delete_attestor",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
325
-
326
- yield result, operation if block_given?
327
- result
350
+ catch :response do
351
+ yield result, operation if block_given?
352
+ result
353
+ end
328
354
  end
329
355
 
330
356
  ##
@@ -157,8 +157,28 @@ module Google
157
157
  universe_domain: @config.universe_domain,
158
158
  channel_args: @config.channel_args,
159
159
  interceptors: @config.interceptors,
160
- channel_pool_config: @config.channel_pool
160
+ channel_pool_config: @config.channel_pool,
161
+ logger: @config.logger
161
162
  )
163
+
164
+ @system_policy_stub.stub_logger&.info do |entry|
165
+ entry.set_system_name
166
+ entry.set_service
167
+ entry.message = "Created client for #{entry.service}"
168
+ entry.set_credentials_fields credentials
169
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
170
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
171
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
172
+ end
173
+ end
174
+
175
+ ##
176
+ # The logger used for request/response debug logging.
177
+ #
178
+ # @return [Logger]
179
+ #
180
+ def logger
181
+ @system_policy_stub.logger
162
182
  end
163
183
 
164
184
  # Service calls
@@ -244,7 +264,6 @@ module Google
244
264
 
245
265
  @system_policy_stub.call_rpc :get_system_policy, request, options: options do |response, operation|
246
266
  yield response, operation if block_given?
247
- return response
248
267
  end
249
268
  rescue ::GRPC::BadStatus => e
250
269
  raise ::Google::Cloud::Error.from_error(e)
@@ -333,6 +352,11 @@ module Google
333
352
  # default endpoint URL. The default value of nil uses the environment
334
353
  # universe (usually the default "googleapis.com" universe).
335
354
  # @return [::String,nil]
355
+ # @!attribute [rw] logger
356
+ # A custom logger to use for request/response debug logging, or the value
357
+ # `:default` (the default) to construct a default logger, or `nil` to
358
+ # explicitly disable logging.
359
+ # @return [::Logger,:default,nil]
336
360
  #
337
361
  class Configuration
338
362
  extend ::Gapic::Config
@@ -357,6 +381,7 @@ module Google
357
381
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
358
382
  config_attr :quota_project, nil, ::String, nil
359
383
  config_attr :universe_domain, nil, ::String, nil
384
+ config_attr :logger, :default, ::Logger, nil, :default
360
385
 
361
386
  # @private
362
387
  def initialize parent_config = nil
@@ -150,8 +150,28 @@ module Google
150
150
  endpoint: @config.endpoint,
151
151
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
152
152
  universe_domain: @config.universe_domain,
153
- credentials: credentials
153
+ credentials: credentials,
154
+ logger: @config.logger
154
155
  )
156
+
157
+ @system_policy_stub.logger(stub: true)&.info do |entry|
158
+ entry.set_system_name
159
+ entry.set_service
160
+ entry.message = "Created client for #{entry.service}"
161
+ entry.set_credentials_fields credentials
162
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
163
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
164
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
165
+ end
166
+ end
167
+
168
+ ##
169
+ # The logger used for request/response debug logging.
170
+ #
171
+ # @return [Logger]
172
+ #
173
+ def logger
174
+ @system_policy_stub.logger
155
175
  end
156
176
 
157
177
  # Service calls
@@ -230,7 +250,6 @@ module Google
230
250
 
231
251
  @system_policy_stub.get_system_policy request, options do |result, operation|
232
252
  yield result, operation if block_given?
233
- return result
234
253
  end
235
254
  rescue ::Gapic::Rest::Error => e
236
255
  raise ::Google::Cloud::Error.from_error(e)
@@ -310,6 +329,11 @@ module Google
310
329
  # default endpoint URL. The default value of nil uses the environment
311
330
  # universe (usually the default "googleapis.com" universe).
312
331
  # @return [::String,nil]
332
+ # @!attribute [rw] logger
333
+ # A custom logger to use for request/response debug logging, or the value
334
+ # `:default` (the default) to construct a default logger, or `nil` to
335
+ # explicitly disable logging.
336
+ # @return [::Logger,:default,nil]
313
337
  #
314
338
  class Configuration
315
339
  extend ::Gapic::Config
@@ -331,6 +355,7 @@ module Google
331
355
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
332
356
  config_attr :quota_project, nil, ::String, nil
333
357
  config_attr :universe_domain, nil, ::String, nil
358
+ config_attr :logger, :default, ::Logger, nil, :default
334
359
 
335
360
  # @private
336
361
  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 get_system_policy 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: "get_system_policy",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::BinaryAuthorization::V1beta1::Policy.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
  ##
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module BinaryAuthorization
23
23
  module V1beta1
24
- VERSION = "0.13.1"
24
+ VERSION = "0.14.0"
25
25
  end
26
26
  end
27
27
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-binary_authorization-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.13.1
4
+ version: 0.14.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: 2024-08-30 00:00:00.000000000 Z
11
+ date: 2024-12-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.21.1
19
+ version: 0.24.0
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.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -111,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
111
111
  - !ruby/object:Gem::Version
112
112
  version: '0'
113
113
  requirements: []
114
- rubygems_version: 3.5.6
114
+ rubygems_version: 3.5.23
115
115
  signing_key:
116
116
  specification_version: 4
117
117
  summary: The management interface for Binary Authorization, a system providing policy