google-cloud-debugger 0.34.0 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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