google-cloud-debugger 0.34.0 → 0.35.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: 30be42396dffa8707377274047c2876df1d2d06f1f70f7e32a6a0688554e009c
4
- data.tar.gz: b0c705f41712f35d684bff7b3fe8e04d2c5e7c7c6f8f24805f9d45904240c356
3
+ metadata.gz: 4f19d2b92211bb241ec80586ebba95707b5fcedd6d1be32394ed91e06aae1adf
4
+ data.tar.gz: 910b0bbf8d50d8a4554c6082b1eea6bf280c28c267d35b969abea656f636bc06
5
5
  SHA512:
6
- metadata.gz: 0d858eceaf2c0c92f5cc49054664655c823aca4aa9dda6229bb26bec666ca26a4479a65b58b99fa159d0438fb3eb7a46223805953683fc78b40d0e8fefa151c0
7
- data.tar.gz: e1b1437841d2d66b910cec11f3ea2f382d3ca5b87fd06d6866192b9a0a608165863fb9136dcb6892d65d57aaf100e6a93597e02ccd9ffbf64c31a69e80bd7dfa
6
+ metadata.gz: 89febdbe594b902e2ab96889c3783bf2d0ece1ff235a723780951ce78a954a04bc50815d2c23966cfcb4adc43f5cefd6cd58d1366d608bac2fdc6c2ebe1316d2
7
+ data.tar.gz: 4b65fdc445112e6cc75fb3fa72b5151f0a39b487d2801c7e38d060bcaaa053dec8321b99c66434f1acc25d378553221b86f74da2154799ca4c302ca2a2be98d5
@@ -55,32 +55,10 @@ code.
55
55
 
56
56
  ### Google Cloud Platform environments
57
57
 
58
- While running on Google Cloud Platform environments such as Google Compute
59
- Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed.
60
- The **Project ID** and **Credentials** and are discovered automatically. Code
61
- should be written as if already authenticated. Just be sure when you [set up the
62
- GCE instance][gce-how-to], you add the correct scopes for the APIs you want to
63
- access. For example:
64
-
65
- * **All APIs**
66
- * `https://www.googleapis.com/auth/cloud-platform`
67
- * `https://www.googleapis.com/auth/cloud-platform.read-only`
68
- * **BigQuery**
69
- * `https://www.googleapis.com/auth/bigquery`
70
- * `https://www.googleapis.com/auth/bigquery.insertdata`
71
- * **Compute Engine**
72
- * `https://www.googleapis.com/auth/compute`
73
- * **Datastore**
74
- * `https://www.googleapis.com/auth/datastore`
75
- * `https://www.googleapis.com/auth/userinfo.email`
76
- * **DNS**
77
- * `https://www.googleapis.com/auth/ndev.clouddns.readwrite`
78
- * **Pub/Sub**
79
- * `https://www.googleapis.com/auth/pubsub`
80
- * **Storage**
81
- * `https://www.googleapis.com/auth/devstorage.full_control`
82
- * `https://www.googleapis.com/auth/devstorage.read_only`
83
- * `https://www.googleapis.com/auth/devstorage.read_write`
58
+ When running on Google Cloud Platform (GCP), including Google Compute Engine (GCE),
59
+ Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud Functions
60
+ (GCF) and Cloud Run, the **Project ID** and **Credentials** and are discovered
61
+ automatically. Code should be written as if already authenticated.
84
62
 
85
63
  ### Environment Variables
86
64
 
@@ -1,5 +1,17 @@
1
1
  # Release History
2
2
 
3
+ ### 0.35.0 / 2019-10-29
4
+
5
+ This release requires Ruby 2.4 or later.
6
+
7
+ #### Documentation
8
+
9
+ * Clarify which Google Cloud Platform environments support automatic authentication
10
+
11
+ #### Performance Improvements
12
+
13
+ * Update lower-level client network configuration
14
+
3
15
  ### 0.34.0 / 2019-08-23
4
16
 
5
17
  #### Features
@@ -24,7 +24,7 @@ be able to accept your pull requests.
24
24
  In order to use the google-cloud-debugger console and run the project's tests,
25
25
  there is a small amount of setup:
26
26
 
27
- 1. Install Ruby. google-cloud-debugger requires Ruby 2.3+. You may choose to
27
+ 1. Install Ruby. google-cloud-debugger requires Ruby 2.4+. You may choose to
28
28
  manage your Ruby and gem installations with [RVM](https://rvm.io/),
29
29
  [rbenv](https://github.com/rbenv/rbenv), or
30
30
  [chruby](https://github.com/postmodern/chruby).
@@ -13,8 +13,8 @@
13
13
  # limitations under the License.
14
14
 
15
15
 
16
- require "google/cloud/debugger/v2/controller2_client"
17
16
  require "google/cloud/debugger/v2/debugger2_client"
17
+ require "google/cloud/debugger/v2/controller2_client"
18
18
 
19
19
  module Google
20
20
  module Cloud
@@ -80,28 +80,20 @@ module Google
80
80
  module V2
81
81
  # rubocop:enable LineLength
82
82
 
83
- module Controller2
83
+ module Debugger2
84
84
  ##
85
- # The Controller service provides the API for orchestrating a collection of
86
- # debugger agents to perform debugging tasks. These agents are each attached
87
- # to a process of an application which may include one or more replicas.
88
- #
89
- # The debugger agents register with the Controller to identify the application
90
- # being debugged, the Debuggee. All agents that register with the same data,
91
- # represent the same Debuggee, and are assigned the same `debuggee_id`.
85
+ # The Debugger service provides the API that allows users to collect run-time
86
+ # information from a running application, without stopping or slowing it down
87
+ # and without modifying its state. An application may include one or
88
+ # more replicated processes performing the same work.
92
89
  #
93
- # The debugger agents call the Controller to retrieve the list of active
94
- # Breakpoints. Agents with the same `debuggee_id` get the same breakpoints
95
- # list. An agent that can fulfill the breakpoint request updates the
96
- # Controller with the breakpoint result. The controller selects the first
97
- # result received and discards the rest of the results.
98
- # Agents that poll again for active breakpoints will no longer have
99
- # the completed breakpoint in the list and should remove that breakpoint from
100
- # their attached process.
90
+ # A debugged application is represented using the Debuggee concept. The
91
+ # Debugger service provides a way to query for available debuggees, but does
92
+ # not provide a way to create one. A debuggee is created using the Controller
93
+ # service, usually by running a debugger agent with the application.
101
94
  #
102
- # The Controller service does not provide a way to retrieve the results of
103
- # a completed breakpoint. This functionality is available using the Debugger
104
- # service.
95
+ # The Debugger service enables the client to set one or more Breakpoints on a
96
+ # Debuggee and collect the results of the set Breakpoints.
105
97
  #
106
98
  # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
107
99
  # Provides the means for authenticating requests made by the client. This parameter can
@@ -159,24 +151,32 @@ module Google
159
151
  service_port: service_port,
160
152
  lib_version: lib_version
161
153
  }.select { |_, v| v != nil }
162
- Google::Cloud::Debugger::V2::Controller2Client.new(**kwargs)
154
+ Google::Cloud::Debugger::V2::Debugger2Client.new(**kwargs)
163
155
  end
164
156
  end
165
157
 
166
- module Debugger2
158
+ module Controller2
167
159
  ##
168
- # The Debugger service provides the API that allows users to collect run-time
169
- # information from a running application, without stopping or slowing it down
170
- # and without modifying its state. An application may include one or
171
- # more replicated processes performing the same work.
160
+ # The Controller service provides the API for orchestrating a collection of
161
+ # debugger agents to perform debugging tasks. These agents are each attached
162
+ # to a process of an application which may include one or more replicas.
172
163
  #
173
- # A debugged application is represented using the Debuggee concept. The
174
- # Debugger service provides a way to query for available debuggees, but does
175
- # not provide a way to create one. A debuggee is created using the Controller
176
- # service, usually by running a debugger agent with the application.
164
+ # The debugger agents register with the Controller to identify the application
165
+ # being debugged, the Debuggee. All agents that register with the same data,
166
+ # represent the same Debuggee, and are assigned the same `debuggee_id`.
177
167
  #
178
- # The Debugger service enables the client to set one or more Breakpoints on a
179
- # Debuggee and collect the results of the set Breakpoints.
168
+ # The debugger agents call the Controller to retrieve the list of active
169
+ # Breakpoints. Agents with the same `debuggee_id` get the same breakpoints
170
+ # list. An agent that can fulfill the breakpoint request updates the
171
+ # Controller with the breakpoint result. The controller selects the first
172
+ # result received and discards the rest of the results.
173
+ # Agents that poll again for active breakpoints will no longer have
174
+ # the completed breakpoint in the list and should remove that breakpoint from
175
+ # their attached process.
176
+ #
177
+ # The Controller service does not provide a way to retrieve the results of
178
+ # a completed breakpoint. This functionality is available using the Debugger
179
+ # service.
180
180
  #
181
181
  # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
182
182
  # Provides the means for authenticating requests made by the client. This parameter can
@@ -234,7 +234,7 @@ module Google
234
234
  service_port: service_port,
235
235
  lib_version: lib_version
236
236
  }.select { |_, v| v != nil }
237
- Google::Cloud::Debugger::V2::Debugger2Client.new(**kwargs)
237
+ Google::Cloud::Debugger::V2::Controller2Client.new(**kwargs)
238
238
  end
239
239
  end
240
240
  end
@@ -187,6 +187,11 @@ module Google
187
187
  &Google::Devtools::Clouddebugger::V2::Controller2::Stub.method(:new)
188
188
  )
189
189
 
190
+ @update_active_breakpoint = Google::Gax.create_api_call(
191
+ @controller2_stub.method(:update_active_breakpoint),
192
+ defaults["update_active_breakpoint"],
193
+ exception_transformer: exception_transformer
194
+ )
190
195
  @register_debuggee = Google::Gax.create_api_call(
191
196
  @controller2_stub.method(:register_debuggee),
192
197
  defaults["register_debuggee"],
@@ -200,15 +205,60 @@ module Google
200
205
  {'debuggee_id' => request.debuggee_id}
201
206
  end
202
207
  )
203
- @update_active_breakpoint = Google::Gax.create_api_call(
204
- @controller2_stub.method(:update_active_breakpoint),
205
- defaults["update_active_breakpoint"],
206
- exception_transformer: exception_transformer
207
- )
208
208
  end
209
209
 
210
210
  # Service calls
211
211
 
212
+ # Updates the breakpoint state or mutable fields.
213
+ # The entire Breakpoint message must be sent back to the controller service.
214
+ #
215
+ # Updates to active breakpoint fields are only allowed if the new value
216
+ # does not change the breakpoint specification. Updates to the `location`,
217
+ # `condition` and `expressions` fields should not alter the breakpoint
218
+ # semantics. These may only make changes such as canonicalizing a value
219
+ # or snapping the location to the correct line of code.
220
+ #
221
+ # @param debuggee_id [String]
222
+ # Required. Identifies the debuggee being debugged.
223
+ # @param breakpoint [Google::Devtools::Clouddebugger::V2::Breakpoint | Hash]
224
+ # Required. Updated breakpoint information.
225
+ # The field `id` must be set.
226
+ # The agent must echo all Breakpoint specification fields in the update.
227
+ # A hash of the same form as `Google::Devtools::Clouddebugger::V2::Breakpoint`
228
+ # can also be provided.
229
+ # @param options [Google::Gax::CallOptions]
230
+ # Overrides the default settings for this call, e.g, timeout,
231
+ # retries, etc.
232
+ # @yield [result, operation] Access the result along with the RPC operation
233
+ # @yieldparam result [Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointResponse]
234
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
235
+ # @return [Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointResponse]
236
+ # @raise [Google::Gax::GaxError] if the RPC is aborted.
237
+ # @example
238
+ # require "google/cloud/debugger/v2"
239
+ #
240
+ # controller2_client = Google::Cloud::Debugger::V2::Controller2.new
241
+ #
242
+ # # TODO: Initialize `debuggee_id`:
243
+ # debuggee_id = ''
244
+ #
245
+ # # TODO: Initialize `breakpoint`:
246
+ # breakpoint = {}
247
+ # response = controller2_client.update_active_breakpoint(debuggee_id, breakpoint)
248
+
249
+ def update_active_breakpoint \
250
+ debuggee_id,
251
+ breakpoint,
252
+ options: nil,
253
+ &block
254
+ req = {
255
+ debuggee_id: debuggee_id,
256
+ breakpoint: breakpoint
257
+ }.delete_if { |_, v| v.nil? }
258
+ req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointRequest)
259
+ @update_active_breakpoint.call(req, options, &block)
260
+ end
261
+
212
262
  # Registers the debuggee with the controller service.
213
263
  #
214
264
  # All agents attached to the same application must call this method with
@@ -221,7 +271,7 @@ module Google
221
271
  # `debuggee_id` value changing upon re-registration.
222
272
  #
223
273
  # @param debuggee [Google::Devtools::Clouddebugger::V2::Debuggee | Hash]
224
- # Debuggee information to register.
274
+ # Required. Debuggee information to register.
225
275
  # The fields `project`, `uniquifier`, `description` and `agent_version`
226
276
  # of the debuggee must be set.
227
277
  # A hash of the same form as `Google::Devtools::Clouddebugger::V2::Debuggee`
@@ -269,7 +319,7 @@ module Google
269
319
  # setting those breakpoints again.
270
320
  #
271
321
  # @param debuggee_id [String]
272
- # Identifies the debuggee.
322
+ # Required. Identifies the debuggee.
273
323
  # @param wait_token [String]
274
324
  # A token that, if specified, blocks the method call until the list
275
325
  # of active breakpoints has changed, or a server-selected timeout has
@@ -313,56 +363,6 @@ module Google
313
363
  req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::ListActiveBreakpointsRequest)
314
364
  @list_active_breakpoints.call(req, options, &block)
315
365
  end
316
-
317
- # Updates the breakpoint state or mutable fields.
318
- # The entire Breakpoint message must be sent back to the controller service.
319
- #
320
- # Updates to active breakpoint fields are only allowed if the new value
321
- # does not change the breakpoint specification. Updates to the `location`,
322
- # `condition` and `expressions` fields should not alter the breakpoint
323
- # semantics. These may only make changes such as canonicalizing a value
324
- # or snapping the location to the correct line of code.
325
- #
326
- # @param debuggee_id [String]
327
- # Identifies the debuggee being debugged.
328
- # @param breakpoint [Google::Devtools::Clouddebugger::V2::Breakpoint | Hash]
329
- # Updated breakpoint information.
330
- # The field `id` must be set.
331
- # The agent must echo all Breakpoint specification fields in the update.
332
- # A hash of the same form as `Google::Devtools::Clouddebugger::V2::Breakpoint`
333
- # can also be provided.
334
- # @param options [Google::Gax::CallOptions]
335
- # Overrides the default settings for this call, e.g, timeout,
336
- # retries, etc.
337
- # @yield [result, operation] Access the result along with the RPC operation
338
- # @yieldparam result [Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointResponse]
339
- # @yieldparam operation [GRPC::ActiveCall::Operation]
340
- # @return [Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointResponse]
341
- # @raise [Google::Gax::GaxError] if the RPC is aborted.
342
- # @example
343
- # require "google/cloud/debugger/v2"
344
- #
345
- # controller2_client = Google::Cloud::Debugger::V2::Controller2.new
346
- #
347
- # # TODO: Initialize `debuggee_id`:
348
- # debuggee_id = ''
349
- #
350
- # # TODO: Initialize `breakpoint`:
351
- # breakpoint = {}
352
- # response = controller2_client.update_active_breakpoint(debuggee_id, breakpoint)
353
-
354
- def update_active_breakpoint \
355
- debuggee_id,
356
- breakpoint,
357
- options: nil,
358
- &block
359
- req = {
360
- debuggee_id: debuggee_id,
361
- breakpoint: breakpoint
362
- }.delete_if { |_, v| v.nil? }
363
- req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointRequest)
364
- @update_active_breakpoint.call(req, options, &block)
365
- end
366
366
  end
367
367
  end
368
368
  end
@@ -13,25 +13,25 @@
13
13
  "initial_retry_delay_millis": 100,
14
14
  "retry_delay_multiplier": 1.3,
15
15
  "max_retry_delay_millis": 60000,
16
- "initial_rpc_timeout_millis": 60000,
16
+ "initial_rpc_timeout_millis": 20000,
17
17
  "rpc_timeout_multiplier": 1.0,
18
- "max_rpc_timeout_millis": 60000,
18
+ "max_rpc_timeout_millis": 20000,
19
19
  "total_timeout_millis": 600000
20
20
  }
21
21
  },
22
22
  "methods": {
23
+ "UpdateActiveBreakpoint": {
24
+ "timeout_millis": 60000,
25
+ "retry_codes_name": "idempotent",
26
+ "retry_params_name": "default"
27
+ },
23
28
  "RegisterDebuggee": {
24
- "timeout_millis": 300000,
29
+ "timeout_millis": 60000,
25
30
  "retry_codes_name": "non_idempotent",
26
31
  "retry_params_name": "default"
27
32
  },
28
33
  "ListActiveBreakpoints": {
29
- "timeout_millis": 300000,
30
- "retry_codes_name": "idempotent",
31
- "retry_params_name": "default"
32
- },
33
- "UpdateActiveBreakpoint": {
34
- "timeout_millis": 300000,
34
+ "timeout_millis": 60000,
35
35
  "retry_codes_name": "idempotent",
36
36
  "retry_params_name": "default"
37
37
  }
@@ -179,6 +179,11 @@ module Google
179
179
  &Google::Devtools::Clouddebugger::V2::Debugger2::Stub.method(:new)
180
180
  )
181
181
 
182
+ @delete_breakpoint = Google::Gax.create_api_call(
183
+ @debugger2_stub.method(:delete_breakpoint),
184
+ defaults["delete_breakpoint"],
185
+ exception_transformer: exception_transformer
186
+ )
182
187
  @set_breakpoint = Google::Gax.create_api_call(
183
188
  @debugger2_stub.method(:set_breakpoint),
184
189
  defaults["set_breakpoint"],
@@ -192,11 +197,6 @@ module Google
192
197
  defaults["get_breakpoint"],
193
198
  exception_transformer: exception_transformer
194
199
  )
195
- @delete_breakpoint = Google::Gax.create_api_call(
196
- @debugger2_stub.method(:delete_breakpoint),
197
- defaults["delete_breakpoint"],
198
- exception_transformer: exception_transformer
199
- )
200
200
  @list_breakpoints = Google::Gax.create_api_call(
201
201
  @debugger2_stub.method(:list_breakpoints),
202
202
  defaults["list_breakpoints"],
@@ -214,25 +214,21 @@ module Google
214
214
 
215
215
  # Service calls
216
216
 
217
- # Sets the breakpoint to the debuggee.
217
+ # Deletes the breakpoint from the debuggee.
218
218
  #
219
219
  # @param debuggee_id [String]
220
- # ID of the debuggee where the breakpoint is to be set.
221
- # @param breakpoint [Google::Devtools::Clouddebugger::V2::Breakpoint | Hash]
222
- # Breakpoint specification to set.
223
- # The field `location` of the breakpoint must be set.
224
- # A hash of the same form as `Google::Devtools::Clouddebugger::V2::Breakpoint`
225
- # can also be provided.
220
+ # Required. ID of the debuggee whose breakpoint to delete.
221
+ # @param breakpoint_id [String]
222
+ # Required. ID of the breakpoint to delete.
226
223
  # @param client_version [String]
227
- # The client version making the call.
224
+ # Required. The client version making the call.
228
225
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
229
226
  # @param options [Google::Gax::CallOptions]
230
227
  # Overrides the default settings for this call, e.g, timeout,
231
228
  # retries, etc.
232
229
  # @yield [result, operation] Access the result along with the RPC operation
233
- # @yieldparam result [Google::Devtools::Clouddebugger::V2::SetBreakpointResponse]
230
+ # @yieldparam result []
234
231
  # @yieldparam operation [GRPC::ActiveCall::Operation]
235
- # @return [Google::Devtools::Clouddebugger::V2::SetBreakpointResponse]
236
232
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
237
233
  # @example
238
234
  # require "google/cloud/debugger/v2"
@@ -242,44 +238,48 @@ module Google
242
238
  # # TODO: Initialize `debuggee_id`:
243
239
  # debuggee_id = ''
244
240
  #
245
- # # TODO: Initialize `breakpoint`:
246
- # breakpoint = {}
241
+ # # TODO: Initialize `breakpoint_id`:
242
+ # breakpoint_id = ''
247
243
  #
248
244
  # # TODO: Initialize `client_version`:
249
245
  # client_version = ''
250
- # response = debugger2_client.set_breakpoint(debuggee_id, breakpoint, client_version)
246
+ # debugger2_client.delete_breakpoint(debuggee_id, breakpoint_id, client_version)
251
247
 
252
- def set_breakpoint \
248
+ def delete_breakpoint \
253
249
  debuggee_id,
254
- breakpoint,
250
+ breakpoint_id,
255
251
  client_version,
256
252
  options: nil,
257
253
  &block
258
254
  req = {
259
255
  debuggee_id: debuggee_id,
260
- breakpoint: breakpoint,
256
+ breakpoint_id: breakpoint_id,
261
257
  client_version: client_version
262
258
  }.delete_if { |_, v| v.nil? }
263
- req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::SetBreakpointRequest)
264
- @set_breakpoint.call(req, options, &block)
259
+ req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::DeleteBreakpointRequest)
260
+ @delete_breakpoint.call(req, options, &block)
261
+ nil
265
262
  end
266
263
 
267
- # Gets breakpoint information.
264
+ # Sets the breakpoint to the debuggee.
268
265
  #
269
266
  # @param debuggee_id [String]
270
- # ID of the debuggee whose breakpoint to get.
271
- # @param breakpoint_id [String]
272
- # ID of the breakpoint to get.
267
+ # Required. ID of the debuggee where the breakpoint is to be set.
268
+ # @param breakpoint [Google::Devtools::Clouddebugger::V2::Breakpoint | Hash]
269
+ # Required. Breakpoint specification to set.
270
+ # The field `location` of the breakpoint must be set.
271
+ # A hash of the same form as `Google::Devtools::Clouddebugger::V2::Breakpoint`
272
+ # can also be provided.
273
273
  # @param client_version [String]
274
- # The client version making the call.
274
+ # Required. The client version making the call.
275
275
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
276
276
  # @param options [Google::Gax::CallOptions]
277
277
  # Overrides the default settings for this call, e.g, timeout,
278
278
  # retries, etc.
279
279
  # @yield [result, operation] Access the result along with the RPC operation
280
- # @yieldparam result [Google::Devtools::Clouddebugger::V2::GetBreakpointResponse]
280
+ # @yieldparam result [Google::Devtools::Clouddebugger::V2::SetBreakpointResponse]
281
281
  # @yieldparam operation [GRPC::ActiveCall::Operation]
282
- # @return [Google::Devtools::Clouddebugger::V2::GetBreakpointResponse]
282
+ # @return [Google::Devtools::Clouddebugger::V2::SetBreakpointResponse]
283
283
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
284
284
  # @example
285
285
  # require "google/cloud/debugger/v2"
@@ -289,43 +289,44 @@ module Google
289
289
  # # TODO: Initialize `debuggee_id`:
290
290
  # debuggee_id = ''
291
291
  #
292
- # # TODO: Initialize `breakpoint_id`:
293
- # breakpoint_id = ''
292
+ # # TODO: Initialize `breakpoint`:
293
+ # breakpoint = {}
294
294
  #
295
295
  # # TODO: Initialize `client_version`:
296
296
  # client_version = ''
297
- # response = debugger2_client.get_breakpoint(debuggee_id, breakpoint_id, client_version)
297
+ # response = debugger2_client.set_breakpoint(debuggee_id, breakpoint, client_version)
298
298
 
299
- def get_breakpoint \
299
+ def set_breakpoint \
300
300
  debuggee_id,
301
- breakpoint_id,
301
+ breakpoint,
302
302
  client_version,
303
303
  options: nil,
304
304
  &block
305
305
  req = {
306
306
  debuggee_id: debuggee_id,
307
- breakpoint_id: breakpoint_id,
307
+ breakpoint: breakpoint,
308
308
  client_version: client_version
309
309
  }.delete_if { |_, v| v.nil? }
310
- req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::GetBreakpointRequest)
311
- @get_breakpoint.call(req, options, &block)
310
+ req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::SetBreakpointRequest)
311
+ @set_breakpoint.call(req, options, &block)
312
312
  end
313
313
 
314
- # Deletes the breakpoint from the debuggee.
314
+ # Gets breakpoint information.
315
315
  #
316
316
  # @param debuggee_id [String]
317
- # ID of the debuggee whose breakpoint to delete.
317
+ # Required. ID of the debuggee whose breakpoint to get.
318
318
  # @param breakpoint_id [String]
319
- # ID of the breakpoint to delete.
319
+ # Required. ID of the breakpoint to get.
320
320
  # @param client_version [String]
321
- # The client version making the call.
321
+ # Required. The client version making the call.
322
322
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
323
323
  # @param options [Google::Gax::CallOptions]
324
324
  # Overrides the default settings for this call, e.g, timeout,
325
325
  # retries, etc.
326
326
  # @yield [result, operation] Access the result along with the RPC operation
327
- # @yieldparam result []
327
+ # @yieldparam result [Google::Devtools::Clouddebugger::V2::GetBreakpointResponse]
328
328
  # @yieldparam operation [GRPC::ActiveCall::Operation]
329
+ # @return [Google::Devtools::Clouddebugger::V2::GetBreakpointResponse]
329
330
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
330
331
  # @example
331
332
  # require "google/cloud/debugger/v2"
@@ -340,9 +341,9 @@ module Google
340
341
  #
341
342
  # # TODO: Initialize `client_version`:
342
343
  # client_version = ''
343
- # debugger2_client.delete_breakpoint(debuggee_id, breakpoint_id, client_version)
344
+ # response = debugger2_client.get_breakpoint(debuggee_id, breakpoint_id, client_version)
344
345
 
345
- def delete_breakpoint \
346
+ def get_breakpoint \
346
347
  debuggee_id,
347
348
  breakpoint_id,
348
349
  client_version,
@@ -353,17 +354,16 @@ module Google
353
354
  breakpoint_id: breakpoint_id,
354
355
  client_version: client_version
355
356
  }.delete_if { |_, v| v.nil? }
356
- req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::DeleteBreakpointRequest)
357
- @delete_breakpoint.call(req, options, &block)
358
- nil
357
+ req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::GetBreakpointRequest)
358
+ @get_breakpoint.call(req, options, &block)
359
359
  end
360
360
 
361
361
  # Lists all breakpoints for the debuggee.
362
362
  #
363
363
  # @param debuggee_id [String]
364
- # ID of the debuggee whose breakpoints to list.
364
+ # Required. ID of the debuggee whose breakpoints to list.
365
365
  # @param client_version [String]
366
- # The client version making the call.
366
+ # Required. The client version making the call.
367
367
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
368
368
  # @param include_all_users [true, false]
369
369
  # When set to `true`, the response includes the list of breakpoints set by
@@ -430,9 +430,9 @@ module Google
430
430
  # Lists all the debuggees that the user has access to.
431
431
  #
432
432
  # @param project [String]
433
- # Project number of a Google Cloud project whose debuggees to list.
433
+ # Required. Project number of a Google Cloud project whose debuggees to list.
434
434
  # @param client_version [String]
435
- # The client version making the call.
435
+ # Required. The client version making the call.
436
436
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
437
437
  # @param include_inactive [true, false]
438
438
  # When set to `true`, the result includes all debuggees. Otherwise, the
@@ -13,35 +13,35 @@
13
13
  "initial_retry_delay_millis": 100,
14
14
  "retry_delay_multiplier": 1.3,
15
15
  "max_retry_delay_millis": 60000,
16
- "initial_rpc_timeout_millis": 60000,
16
+ "initial_rpc_timeout_millis": 20000,
17
17
  "rpc_timeout_multiplier": 1.0,
18
- "max_rpc_timeout_millis": 60000,
18
+ "max_rpc_timeout_millis": 20000,
19
19
  "total_timeout_millis": 600000
20
20
  }
21
21
  },
22
22
  "methods": {
23
+ "DeleteBreakpoint": {
24
+ "timeout_millis": 60000,
25
+ "retry_codes_name": "idempotent",
26
+ "retry_params_name": "default"
27
+ },
23
28
  "SetBreakpoint": {
24
- "timeout_millis": 300000,
29
+ "timeout_millis": 60000,
25
30
  "retry_codes_name": "non_idempotent",
26
31
  "retry_params_name": "default"
27
32
  },
28
33
  "GetBreakpoint": {
29
- "timeout_millis": 300000,
30
- "retry_codes_name": "idempotent",
31
- "retry_params_name": "default"
32
- },
33
- "DeleteBreakpoint": {
34
- "timeout_millis": 300000,
34
+ "timeout_millis": 60000,
35
35
  "retry_codes_name": "idempotent",
36
36
  "retry_params_name": "default"
37
37
  },
38
38
  "ListBreakpoints": {
39
- "timeout_millis": 300000,
39
+ "timeout_millis": 60000,
40
40
  "retry_codes_name": "idempotent",
41
41
  "retry_params_name": "default"
42
42
  },
43
43
  "ListDebuggees": {
44
- "timeout_millis": 300000,
44
+ "timeout_millis": 60000,
45
45
  "retry_codes_name": "idempotent",
46
46
  "retry_params_name": "default"
47
47
  }
@@ -20,7 +20,7 @@ module Google
20
20
  # Request to register a debuggee.
21
21
  # @!attribute [rw] debuggee
22
22
  # @return [Google::Devtools::Clouddebugger::V2::Debuggee]
23
- # Debuggee information to register.
23
+ # Required. Debuggee information to register.
24
24
  # The fields `project`, `uniquifier`, `description` and `agent_version`
25
25
  # of the debuggee must be set.
26
26
  class RegisterDebuggeeRequest; end
@@ -38,7 +38,7 @@ module Google
38
38
  # Request to list active breakpoints.
39
39
  # @!attribute [rw] debuggee_id
40
40
  # @return [String]
41
- # Identifies the debuggee.
41
+ # Required. Identifies the debuggee.
42
42
  # @!attribute [rw] wait_token
43
43
  # @return [String]
44
44
  # A token that, if specified, blocks the method call until the list
@@ -74,10 +74,10 @@ module Google
74
74
  # Request to update an active breakpoint.
75
75
  # @!attribute [rw] debuggee_id
76
76
  # @return [String]
77
- # Identifies the debuggee being debugged.
77
+ # Required. Identifies the debuggee being debugged.
78
78
  # @!attribute [rw] breakpoint
79
79
  # @return [Google::Devtools::Clouddebugger::V2::Breakpoint]
80
- # Updated breakpoint information.
80
+ # Required. Updated breakpoint information.
81
81
  # The field `id` must be set.
82
82
  # The agent must echo all Breakpoint specification fields in the update.
83
83
  class UpdateActiveBreakpointRequest; end
@@ -20,14 +20,14 @@ module Google
20
20
  # Request to set a breakpoint
21
21
  # @!attribute [rw] debuggee_id
22
22
  # @return [String]
23
- # ID of the debuggee where the breakpoint is to be set.
23
+ # Required. ID of the debuggee where the breakpoint is to be set.
24
24
  # @!attribute [rw] breakpoint
25
25
  # @return [Google::Devtools::Clouddebugger::V2::Breakpoint]
26
- # Breakpoint specification to set.
26
+ # Required. Breakpoint specification to set.
27
27
  # The field `location` of the breakpoint must be set.
28
28
  # @!attribute [rw] client_version
29
29
  # @return [String]
30
- # The client version making the call.
30
+ # Required. The client version making the call.
31
31
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
32
32
  class SetBreakpointRequest; end
33
33
 
@@ -41,13 +41,13 @@ module Google
41
41
  # Request to get breakpoint information.
42
42
  # @!attribute [rw] debuggee_id
43
43
  # @return [String]
44
- # ID of the debuggee whose breakpoint to get.
44
+ # Required. ID of the debuggee whose breakpoint to get.
45
45
  # @!attribute [rw] breakpoint_id
46
46
  # @return [String]
47
- # ID of the breakpoint to get.
47
+ # Required. ID of the breakpoint to get.
48
48
  # @!attribute [rw] client_version
49
49
  # @return [String]
50
- # The client version making the call.
50
+ # Required. The client version making the call.
51
51
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
52
52
  class GetBreakpointRequest; end
53
53
 
@@ -61,20 +61,20 @@ module Google
61
61
  # Request to delete a breakpoint.
62
62
  # @!attribute [rw] debuggee_id
63
63
  # @return [String]
64
- # ID of the debuggee whose breakpoint to delete.
64
+ # Required. ID of the debuggee whose breakpoint to delete.
65
65
  # @!attribute [rw] breakpoint_id
66
66
  # @return [String]
67
- # ID of the breakpoint to delete.
67
+ # Required. ID of the breakpoint to delete.
68
68
  # @!attribute [rw] client_version
69
69
  # @return [String]
70
- # The client version making the call.
70
+ # Required. The client version making the call.
71
71
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
72
72
  class DeleteBreakpointRequest; end
73
73
 
74
74
  # Request to list breakpoints.
75
75
  # @!attribute [rw] debuggee_id
76
76
  # @return [String]
77
- # ID of the debuggee whose breakpoints to list.
77
+ # Required. ID of the debuggee whose breakpoints to list.
78
78
  # @!attribute [rw] include_all_users
79
79
  # @return [true, false]
80
80
  # When set to `true`, the response includes the list of breakpoints set by
@@ -99,7 +99,7 @@ module Google
99
99
  # should be called again with the same `wait_token`.
100
100
  # @!attribute [rw] client_version
101
101
  # @return [String]
102
- # The client version making the call.
102
+ # Required. The client version making the call.
103
103
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
104
104
  class ListBreakpointsRequest
105
105
  # Wrapper message for `Breakpoint.Action`. Defines a filter on the action
@@ -126,14 +126,14 @@ module Google
126
126
  # Request to list debuggees.
127
127
  # @!attribute [rw] project
128
128
  # @return [String]
129
- # Project number of a Google Cloud project whose debuggees to list.
129
+ # Required. Project number of a Google Cloud project whose debuggees to list.
130
130
  # @!attribute [rw] include_inactive
131
131
  # @return [true, false]
132
132
  # When set to `true`, the result includes all debuggees. Otherwise, the
133
133
  # result includes only debuggees that are active.
134
134
  # @!attribute [rw] client_version
135
135
  # @return [String]
136
- # The client version making the call.
136
+ # Required. The client version making the call.
137
137
  # Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
138
138
  class ListDebuggeesRequest; end
139
139
 
@@ -88,11 +88,13 @@ module Google
88
88
  # 01:30 UTC on January 15, 2017.
89
89
  #
90
90
  # In JavaScript, one can convert a Date object to this format using the
91
- # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
91
+ # standard
92
+ # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
92
93
  # method. In Python, a standard `datetime.datetime` object can be converted
93
- # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
94
- # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
95
- # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
94
+ # to this format using
95
+ # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
96
+ # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
97
+ # the Joda Time's [`ISODateTimeFormat.dateTime()`](
96
98
  # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
97
99
  # ) to obtain a formatter capable of generating timestamps in this format.
98
100
  # @!attribute [rw] seconds
@@ -16,7 +16,7 @@
16
16
  module Google
17
17
  module Cloud
18
18
  module Debugger
19
- VERSION = "0.34.0".freeze
19
+ VERSION = "0.35.0".freeze
20
20
  end
21
21
  end
22
22
  end
@@ -5,6 +5,8 @@
5
5
  require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
+ require 'google/api/client_pb'
9
+ require 'google/api/field_behavior_pb'
8
10
  require 'google/devtools/clouddebugger/v2/data_pb'
9
11
  require 'google/protobuf/empty_pb'
10
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/devtools/clouddebugger/v2/controller.proto for package 'google.devtools.clouddebugger.v2'
3
3
  # Original file comments:
4
- # Copyright 2018 Google LLC.
4
+ # Copyright 2019 Google LLC.
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
@@ -4,11 +4,10 @@
4
4
 
5
5
  require 'google/protobuf'
6
6
 
7
- require 'google/api/annotations_pb'
8
7
  require 'google/devtools/source/v1/source_context_pb'
9
- require 'google/protobuf/duration_pb'
10
8
  require 'google/protobuf/timestamp_pb'
11
9
  require 'google/protobuf/wrappers_pb'
10
+ require 'google/api/annotations_pb'
12
11
  Google::Protobuf::DescriptorPool.generated_pool.build do
13
12
  add_message "google.devtools.clouddebugger.v2.FormatMessage" do
14
13
  optional :format, :string, 1
@@ -4,9 +4,11 @@
4
4
 
5
5
  require 'google/protobuf'
6
6
 
7
- require 'google/api/annotations_pb'
7
+ require 'google/api/client_pb'
8
+ require 'google/api/field_behavior_pb'
8
9
  require 'google/devtools/clouddebugger/v2/data_pb'
9
10
  require 'google/protobuf/empty_pb'
11
+ require 'google/api/annotations_pb'
10
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
11
13
  add_message "google.devtools.clouddebugger.v2.SetBreakpointRequest" do
12
14
  optional :debuggee_id, :string, 1
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/devtools/clouddebugger/v2/debugger.proto for package 'google.devtools.clouddebugger.v2'
3
3
  # Original file comments:
4
- # Copyright 2018 Google LLC.
4
+ # Copyright 2019 Google LLC.
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-debugger
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.34.0
4
+ version: 0.35.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Heng Xiong
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-08-23 00:00:00.000000000 Z
11
+ date: 2019-10-30 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: binding_of_caller
@@ -58,14 +58,14 @@ dependencies:
58
58
  requirements:
59
59
  - - "~>"
60
60
  - !ruby/object:Gem::Version
61
- version: '1.7'
61
+ version: '1.8'
62
62
  type: :runtime
63
63
  prerelease: false
64
64
  version_requirements: !ruby/object:Gem::Requirement
65
65
  requirements:
66
66
  - - "~>"
67
67
  - !ruby/object:Gem::Version
68
- version: '1.7'
68
+ version: '1.8'
69
69
  - !ruby/object:Gem::Dependency
70
70
  name: stackdriver-core
71
71
  requirement: !ruby/object:Gem::Requirement
@@ -94,6 +94,20 @@ dependencies:
94
94
  - - "~>"
95
95
  - !ruby/object:Gem::Version
96
96
  version: '1.1'
97
+ - !ruby/object:Gem::Dependency
98
+ name: google-style
99
+ requirement: !ruby/object:Gem::Requirement
100
+ requirements:
101
+ - - "~>"
102
+ - !ruby/object:Gem::Version
103
+ version: 1.24.0
104
+ type: :development
105
+ prerelease: false
106
+ version_requirements: !ruby/object:Gem::Requirement
107
+ requirements:
108
+ - - "~>"
109
+ - !ruby/object:Gem::Version
110
+ version: 1.24.0
97
111
  - !ruby/object:Gem::Dependency
98
112
  name: minitest
99
113
  requirement: !ruby/object:Gem::Requirement
@@ -178,20 +192,6 @@ dependencies:
178
192
  - - "~>"
179
193
  - !ruby/object:Gem::Version
180
194
  version: '3.0'
181
- - !ruby/object:Gem::Dependency
182
- name: rubocop
183
- requirement: !ruby/object:Gem::Requirement
184
- requirements:
185
- - - "~>"
186
- - !ruby/object:Gem::Version
187
- version: 0.64.0
188
- type: :development
189
- prerelease: false
190
- version_requirements: !ruby/object:Gem::Requirement
191
- requirements:
192
- - - "~>"
193
- - !ruby/object:Gem::Version
194
- version: 0.64.0
195
195
  - !ruby/object:Gem::Dependency
196
196
  name: simplecov
197
197
  requirement: !ruby/object:Gem::Requirement
@@ -240,14 +240,14 @@ dependencies:
240
240
  requirements:
241
241
  - - "~>"
242
242
  - !ruby/object:Gem::Version
243
- version: '4.0'
243
+ version: '5.0'
244
244
  type: :development
245
245
  prerelease: false
246
246
  version_requirements: !ruby/object:Gem::Requirement
247
247
  requirements:
248
248
  - - "~>"
249
249
  - !ruby/object:Gem::Version
250
- version: '4.0'
250
+ version: '5.0'
251
251
  - !ruby/object:Gem::Dependency
252
252
  name: rack
253
253
  requirement: !ruby/object:Gem::Requirement
@@ -357,14 +357,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
357
357
  requirements:
358
358
  - - ">="
359
359
  - !ruby/object:Gem::Version
360
- version: 2.2.0
360
+ version: '2.4'
361
361
  required_rubygems_version: !ruby/object:Gem::Requirement
362
362
  requirements:
363
363
  - - ">="
364
364
  - !ruby/object:Gem::Version
365
365
  version: '0'
366
366
  requirements: []
367
- rubygems_version: 3.0.4
367
+ rubygems_version: 3.0.6
368
368
  signing_key:
369
369
  specification_version: 4
370
370
  summary: API Client and instrumentation library for Stackdriver Debugger