google-cloud-debugger 0.32.4 → 0.32.5
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 +4 -4
- data/CHANGELOG.md +6 -0
- data/INSTRUMENTATION.md +1 -1
- data/LOGGING.md +1 -1
- data/lib/google-cloud-debugger.rb +1 -1
- data/lib/google/cloud/debugger.rb +1 -1
- data/lib/google/cloud/debugger/middleware.rb +1 -1
- data/lib/google/cloud/debugger/rails.rb +1 -1
- data/lib/google/cloud/debugger/v2.rb +6 -6
- data/lib/google/cloud/debugger/v2/controller2_client.rb +20 -20
- data/lib/google/cloud/debugger/v2/debugger2_client.rb +25 -25
- data/lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/controller.rb +13 -13
- data/lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/data.rb +43 -43
- data/lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/debugger.rb +21 -21
- data/lib/google/cloud/debugger/v2/doc/google/protobuf/empty.rb +1 -1
- data/lib/google/cloud/debugger/v2/doc/google/protobuf/timestamp.rb +7 -7
- data/lib/google/cloud/debugger/version.rb +1 -1
- metadata +3 -3
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: a97dcd80e8bb13b21b12f4d0efd24d0e847e60e06920f1c54cb30c84c80e7fbd
|
|
4
|
+
data.tar.gz: f8aec9881b50195d2938e386a7c4703320d89f9c698e9e10f1802f444e3cb975
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 4680c75f8fbbfc2a213b0da0cc82fb8f3f670a25ffee55788da1187bd24e6cfdab05aeba6b8dec4933d89f3ee303281516cc0119191b14c8684dad2b7531ead0
|
|
7
|
+
data.tar.gz: 9e3f974d412aa0a1bff054e49c484414feae005ef70dafebb2f6e95bdaa69f704c83c441a4de879d08c35cfa6cca5a07d040702ddb496d1ca23c31d0db81e79d
|
data/CHANGELOG.md
CHANGED
data/INSTRUMENTATION.md
CHANGED
|
@@ -58,7 +58,7 @@ you want to run on a non Google Cloud environment or you want to customize
|
|
|
58
58
|
the default behavior.
|
|
59
59
|
|
|
60
60
|
See the
|
|
61
|
-
[Configuration Guide](https://
|
|
61
|
+
[Configuration Guide](https://googleapis.github.io/google-cloud-ruby/#/docs/stackdriver/guides/instrumentation_configuration)
|
|
62
62
|
for full configuration parameters.
|
|
63
63
|
|
|
64
64
|
### Using instrumentation with Ruby on Rails
|
data/LOGGING.md
CHANGED
|
@@ -5,7 +5,7 @@ To enable logging for this library, set the logger for the underlying
|
|
|
5
5
|
that you set may be a Ruby stdlib
|
|
6
6
|
[`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as
|
|
7
7
|
shown below, or a
|
|
8
|
-
[`Google::Cloud::Logging::Logger`](https://
|
|
8
|
+
[`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger)
|
|
9
9
|
that will write logs to [Stackdriver
|
|
10
10
|
Logging](https://cloud.google.com/logging/). See
|
|
11
11
|
[grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
|
@@ -149,7 +149,7 @@ module Google
|
|
|
149
149
|
# expression evaluation. Defaults to 0.05.
|
|
150
150
|
#
|
|
151
151
|
# See the [Configuration
|
|
152
|
-
# Guide](https://
|
|
152
|
+
# Guide](https://googleapis.github.io/google-cloud-ruby/docs/stackdriver/latest/file.INSTRUMENTATION_CONFIGURATION)
|
|
153
153
|
# for full configuration parameters.
|
|
154
154
|
#
|
|
155
155
|
# @return [Google::Cloud::Config] The configuration object the
|
|
@@ -99,7 +99,7 @@ module Google
|
|
|
99
99
|
# using the other parameters.
|
|
100
100
|
# @param [Hash] kwargs Hash of configuration settings. Used for backward
|
|
101
101
|
# API compatibility. See the [Configuration
|
|
102
|
-
# Guide](https://
|
|
102
|
+
# Guide](https://googleapis.github.io/google-cloud-ruby/docs/stackdriver/latest/file.INSTRUMENTATION_CONFIGURATION)
|
|
103
103
|
# for the prefered way to set configuration parameters.
|
|
104
104
|
#
|
|
105
105
|
# @return [Google::Cloud::Debugger::Middleware] A new
|
|
@@ -34,7 +34,7 @@ module Google
|
|
|
34
34
|
#
|
|
35
35
|
# The Railtie should also initialize a debugger to be used by the
|
|
36
36
|
# Middleware. See the [Configuration
|
|
37
|
-
# Guide](https://
|
|
37
|
+
# Guide](https://googleapis.github.io/google-cloud-ruby/docs/stackdriver/latest/file.INSTRUMENTATION_CONFIGURATION)
|
|
38
38
|
# on how to configure the Railtie and Middleware.
|
|
39
39
|
#
|
|
40
40
|
class Railtie < ::Rails::Railtie
|
|
@@ -22,7 +22,7 @@ module Google
|
|
|
22
22
|
# rubocop:disable LineLength
|
|
23
23
|
|
|
24
24
|
##
|
|
25
|
-
# # Ruby Client for Stackdriver Debugger API ([Alpha](https://github.com/
|
|
25
|
+
# # Ruby Client for Stackdriver Debugger API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
|
|
26
26
|
#
|
|
27
27
|
# [Stackdriver Debugger API][Product Documentation]:
|
|
28
28
|
# Examines the call stack and variables of a running application
|
|
@@ -36,7 +36,7 @@ module Google
|
|
|
36
36
|
# 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
|
|
37
37
|
# 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
|
|
38
38
|
# 3. [Enable the Stackdriver Debugger API.](https://console.cloud.google.com/apis/library/clouddebugger.googleapis.com)
|
|
39
|
-
# 4. [Setup Authentication.](https://
|
|
39
|
+
# 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
|
|
40
40
|
#
|
|
41
41
|
# ### Installation
|
|
42
42
|
# ```
|
|
@@ -46,7 +46,7 @@ module Google
|
|
|
46
46
|
# ### Next Steps
|
|
47
47
|
# - Read the [Stackdriver Debugger API Product documentation][Product Documentation]
|
|
48
48
|
# to learn more about the product and see How-to Guides.
|
|
49
|
-
# - View this [repository's main README](https://github.com/
|
|
49
|
+
# - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
|
|
50
50
|
# to see the full list of Cloud APIs that we cover.
|
|
51
51
|
#
|
|
52
52
|
# [Product Documentation]: https://cloud.google.com/debugger
|
|
@@ -55,7 +55,7 @@ module Google
|
|
|
55
55
|
#
|
|
56
56
|
# To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
|
57
57
|
# The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
|
|
58
|
-
# or a [`Google::Cloud::Logging::Logger`](https://
|
|
58
|
+
# or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
|
|
59
59
|
# that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
|
60
60
|
# and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
|
61
61
|
#
|
|
@@ -155,10 +155,10 @@ module Google
|
|
|
155
155
|
#
|
|
156
156
|
# The debugger agents register with the Controller to identify the application
|
|
157
157
|
# being debugged, the Debuggee. All agents that register with the same data,
|
|
158
|
-
# represent the same Debuggee, and are assigned the same
|
|
158
|
+
# represent the same Debuggee, and are assigned the same `debuggee_id`.
|
|
159
159
|
#
|
|
160
160
|
# The debugger agents call the Controller to retrieve the list of active
|
|
161
|
-
# Breakpoints. Agents with the same
|
|
161
|
+
# Breakpoints. Agents with the same `debuggee_id` get the same breakpoints
|
|
162
162
|
# list. An agent that can fulfill the breakpoint request updates the
|
|
163
163
|
# Controller with the breakpoint result. The controller selects the first
|
|
164
164
|
# result received and discards the rest of the results.
|
|
@@ -38,10 +38,10 @@ module Google
|
|
|
38
38
|
#
|
|
39
39
|
# The debugger agents register with the Controller to identify the application
|
|
40
40
|
# being debugged, the Debuggee. All agents that register with the same data,
|
|
41
|
-
# represent the same Debuggee, and are assigned the same
|
|
41
|
+
# represent the same Debuggee, and are assigned the same `debuggee_id`.
|
|
42
42
|
#
|
|
43
43
|
# The debugger agents call the Controller to retrieve the list of active
|
|
44
|
-
# Breakpoints. Agents with the same
|
|
44
|
+
# Breakpoints. Agents with the same `debuggee_id` get the same breakpoints
|
|
45
45
|
# list. An agent that can fulfill the breakpoint request updates the
|
|
46
46
|
# Controller with the breakpoint result. The controller selects the first
|
|
47
47
|
# result received and discards the rest of the results.
|
|
@@ -202,17 +202,17 @@ module Google
|
|
|
202
202
|
# Registers the debuggee with the controller service.
|
|
203
203
|
#
|
|
204
204
|
# All agents attached to the same application must call this method with
|
|
205
|
-
# exactly the same request content to get back the same stable
|
|
206
|
-
# Agents should call this method again whenever
|
|
205
|
+
# exactly the same request content to get back the same stable `debuggee_id`.
|
|
206
|
+
# Agents should call this method again whenever `google.rpc.Code.NOT_FOUND`
|
|
207
207
|
# is returned from any controller method.
|
|
208
208
|
#
|
|
209
209
|
# This protocol allows the controller service to disable debuggees, recover
|
|
210
|
-
# from data loss, or change the
|
|
211
|
-
#
|
|
210
|
+
# from data loss, or change the `debuggee_id` format. Agents must handle
|
|
211
|
+
# `debuggee_id` value changing upon re-registration.
|
|
212
212
|
#
|
|
213
213
|
# @param debuggee [Google::Devtools::Clouddebugger::V2::Debuggee | Hash]
|
|
214
214
|
# Debuggee information to register.
|
|
215
|
-
# The fields
|
|
215
|
+
# The fields `project`, `uniquifier`, `description` and `agent_version`
|
|
216
216
|
# of the debuggee must be set.
|
|
217
217
|
# A hash of the same form as `Google::Devtools::Clouddebugger::V2::Debuggee`
|
|
218
218
|
# can also be provided.
|
|
@@ -229,7 +229,7 @@ module Google
|
|
|
229
229
|
#
|
|
230
230
|
# controller2_client = Google::Cloud::Debugger::V2::Controller2.new
|
|
231
231
|
#
|
|
232
|
-
# # TODO: Initialize
|
|
232
|
+
# # TODO: Initialize `debuggee`:
|
|
233
233
|
# debuggee = {}
|
|
234
234
|
# response = controller2_client.register_debuggee(debuggee)
|
|
235
235
|
|
|
@@ -246,7 +246,7 @@ module Google
|
|
|
246
246
|
|
|
247
247
|
# Returns the list of all active breakpoints for the debuggee.
|
|
248
248
|
#
|
|
249
|
-
# The breakpoint specification (
|
|
249
|
+
# The breakpoint specification (`location`, `condition`, and `expressions`
|
|
250
250
|
# fields) is semantically immutable, although the field values may
|
|
251
251
|
# change. For example, an agent may update the location line number
|
|
252
252
|
# to reflect the actual line where the breakpoint was set, but this
|
|
@@ -263,14 +263,14 @@ module Google
|
|
|
263
263
|
# @param wait_token [String]
|
|
264
264
|
# A token that, if specified, blocks the method call until the list
|
|
265
265
|
# of active breakpoints has changed, or a server-selected timeout has
|
|
266
|
-
# expired. The value should be set from the
|
|
267
|
-
# the last response. The initial value should be set to
|
|
266
|
+
# expired. The value should be set from the `next_wait_token` field in
|
|
267
|
+
# the last response. The initial value should be set to `"init"`.
|
|
268
268
|
# @param success_on_timeout [true, false]
|
|
269
|
-
# If set to
|
|
270
|
-
# sets the
|
|
269
|
+
# If set to `true` (recommended), returns `google.rpc.Code.OK` status and
|
|
270
|
+
# sets the `wait_expired` response field to `true` when the server-selected
|
|
271
271
|
# timeout has expired.
|
|
272
272
|
#
|
|
273
|
-
# If set to
|
|
273
|
+
# If set to `false` (deprecated), returns `google.rpc.Code.ABORTED` status
|
|
274
274
|
# when the server-selected timeout has expired.
|
|
275
275
|
# @param options [Google::Gax::CallOptions]
|
|
276
276
|
# Overrides the default settings for this call, e.g, timeout,
|
|
@@ -285,7 +285,7 @@ module Google
|
|
|
285
285
|
#
|
|
286
286
|
# controller2_client = Google::Cloud::Debugger::V2::Controller2.new
|
|
287
287
|
#
|
|
288
|
-
# # TODO: Initialize
|
|
288
|
+
# # TODO: Initialize `debuggee_id`:
|
|
289
289
|
# debuggee_id = ''
|
|
290
290
|
# response = controller2_client.list_active_breakpoints(debuggee_id)
|
|
291
291
|
|
|
@@ -308,8 +308,8 @@ module Google
|
|
|
308
308
|
# The entire Breakpoint message must be sent back to the controller service.
|
|
309
309
|
#
|
|
310
310
|
# Updates to active breakpoint fields are only allowed if the new value
|
|
311
|
-
# does not change the breakpoint specification. Updates to the
|
|
312
|
-
#
|
|
311
|
+
# does not change the breakpoint specification. Updates to the `location`,
|
|
312
|
+
# `condition` and `expressions` fields should not alter the breakpoint
|
|
313
313
|
# semantics. These may only make changes such as canonicalizing a value
|
|
314
314
|
# or snapping the location to the correct line of code.
|
|
315
315
|
#
|
|
@@ -317,7 +317,7 @@ module Google
|
|
|
317
317
|
# Identifies the debuggee being debugged.
|
|
318
318
|
# @param breakpoint [Google::Devtools::Clouddebugger::V2::Breakpoint | Hash]
|
|
319
319
|
# Updated breakpoint information.
|
|
320
|
-
# The field
|
|
320
|
+
# The field `id` must be set.
|
|
321
321
|
# The agent must echo all Breakpoint specification fields in the update.
|
|
322
322
|
# A hash of the same form as `Google::Devtools::Clouddebugger::V2::Breakpoint`
|
|
323
323
|
# can also be provided.
|
|
@@ -334,10 +334,10 @@ module Google
|
|
|
334
334
|
#
|
|
335
335
|
# controller2_client = Google::Cloud::Debugger::V2::Controller2.new
|
|
336
336
|
#
|
|
337
|
-
# # TODO: Initialize
|
|
337
|
+
# # TODO: Initialize `debuggee_id`:
|
|
338
338
|
# debuggee_id = ''
|
|
339
339
|
#
|
|
340
|
-
# # TODO: Initialize
|
|
340
|
+
# # TODO: Initialize `breakpoint`:
|
|
341
341
|
# breakpoint = {}
|
|
342
342
|
# response = controller2_client.update_active_breakpoint(debuggee_id, breakpoint)
|
|
343
343
|
|
|
@@ -207,12 +207,12 @@ module Google
|
|
|
207
207
|
# ID of the debuggee where the breakpoint is to be set.
|
|
208
208
|
# @param breakpoint [Google::Devtools::Clouddebugger::V2::Breakpoint | Hash]
|
|
209
209
|
# Breakpoint specification to set.
|
|
210
|
-
# The field
|
|
210
|
+
# The field `location` of the breakpoint must be set.
|
|
211
211
|
# A hash of the same form as `Google::Devtools::Clouddebugger::V2::Breakpoint`
|
|
212
212
|
# can also be provided.
|
|
213
213
|
# @param client_version [String]
|
|
214
214
|
# The client version making the call.
|
|
215
|
-
# Schema:
|
|
215
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
216
216
|
# @param options [Google::Gax::CallOptions]
|
|
217
217
|
# Overrides the default settings for this call, e.g, timeout,
|
|
218
218
|
# retries, etc.
|
|
@@ -226,13 +226,13 @@ module Google
|
|
|
226
226
|
#
|
|
227
227
|
# debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
|
|
228
228
|
#
|
|
229
|
-
# # TODO: Initialize
|
|
229
|
+
# # TODO: Initialize `debuggee_id`:
|
|
230
230
|
# debuggee_id = ''
|
|
231
231
|
#
|
|
232
|
-
# # TODO: Initialize
|
|
232
|
+
# # TODO: Initialize `breakpoint`:
|
|
233
233
|
# breakpoint = {}
|
|
234
234
|
#
|
|
235
|
-
# # TODO: Initialize
|
|
235
|
+
# # TODO: Initialize `client_version`:
|
|
236
236
|
# client_version = ''
|
|
237
237
|
# response = debugger2_client.set_breakpoint(debuggee_id, breakpoint, client_version)
|
|
238
238
|
|
|
@@ -259,7 +259,7 @@ module Google
|
|
|
259
259
|
# ID of the breakpoint to get.
|
|
260
260
|
# @param client_version [String]
|
|
261
261
|
# The client version making the call.
|
|
262
|
-
# Schema:
|
|
262
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
263
263
|
# @param options [Google::Gax::CallOptions]
|
|
264
264
|
# Overrides the default settings for this call, e.g, timeout,
|
|
265
265
|
# retries, etc.
|
|
@@ -273,13 +273,13 @@ module Google
|
|
|
273
273
|
#
|
|
274
274
|
# debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
|
|
275
275
|
#
|
|
276
|
-
# # TODO: Initialize
|
|
276
|
+
# # TODO: Initialize `debuggee_id`:
|
|
277
277
|
# debuggee_id = ''
|
|
278
278
|
#
|
|
279
|
-
# # TODO: Initialize
|
|
279
|
+
# # TODO: Initialize `breakpoint_id`:
|
|
280
280
|
# breakpoint_id = ''
|
|
281
281
|
#
|
|
282
|
-
# # TODO: Initialize
|
|
282
|
+
# # TODO: Initialize `client_version`:
|
|
283
283
|
# client_version = ''
|
|
284
284
|
# response = debugger2_client.get_breakpoint(debuggee_id, breakpoint_id, client_version)
|
|
285
285
|
|
|
@@ -306,7 +306,7 @@ module Google
|
|
|
306
306
|
# ID of the breakpoint to delete.
|
|
307
307
|
# @param client_version [String]
|
|
308
308
|
# The client version making the call.
|
|
309
|
-
# Schema:
|
|
309
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
310
310
|
# @param options [Google::Gax::CallOptions]
|
|
311
311
|
# Overrides the default settings for this call, e.g, timeout,
|
|
312
312
|
# retries, etc.
|
|
@@ -319,13 +319,13 @@ module Google
|
|
|
319
319
|
#
|
|
320
320
|
# debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
|
|
321
321
|
#
|
|
322
|
-
# # TODO: Initialize
|
|
322
|
+
# # TODO: Initialize `debuggee_id`:
|
|
323
323
|
# debuggee_id = ''
|
|
324
324
|
#
|
|
325
|
-
# # TODO: Initialize
|
|
325
|
+
# # TODO: Initialize `breakpoint_id`:
|
|
326
326
|
# breakpoint_id = ''
|
|
327
327
|
#
|
|
328
|
-
# # TODO: Initialize
|
|
328
|
+
# # TODO: Initialize `client_version`:
|
|
329
329
|
# client_version = ''
|
|
330
330
|
# debugger2_client.delete_breakpoint(debuggee_id, breakpoint_id, client_version)
|
|
331
331
|
|
|
@@ -351,12 +351,12 @@ module Google
|
|
|
351
351
|
# ID of the debuggee whose breakpoints to list.
|
|
352
352
|
# @param client_version [String]
|
|
353
353
|
# The client version making the call.
|
|
354
|
-
# Schema:
|
|
354
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
355
355
|
# @param include_all_users [true, false]
|
|
356
|
-
# When set to
|
|
356
|
+
# When set to `true`, the response includes the list of breakpoints set by
|
|
357
357
|
# any user. Otherwise, it includes only breakpoints set by the caller.
|
|
358
358
|
# @param include_inactive [true, false]
|
|
359
|
-
# When set to
|
|
359
|
+
# When set to `true`, the response includes active and inactive
|
|
360
360
|
# breakpoints. Otherwise, it includes only active breakpoints.
|
|
361
361
|
# @param action [Google::Devtools::Clouddebugger::V2::ListBreakpointsRequest::BreakpointActionValue | Hash]
|
|
362
362
|
# When set, the response includes only breakpoints with the specified action.
|
|
@@ -364,13 +364,13 @@ module Google
|
|
|
364
364
|
# can also be provided.
|
|
365
365
|
# @param strip_results [true, false]
|
|
366
366
|
# This field is deprecated. The following fields are always stripped out of
|
|
367
|
-
# the result:
|
|
367
|
+
# the result: `stack_frames`, `evaluated_expressions` and `variable_table`.
|
|
368
368
|
# @param wait_token [String]
|
|
369
369
|
# A wait token that, if specified, blocks the call until the breakpoints
|
|
370
370
|
# list has changed, or a server selected timeout has expired. The value
|
|
371
371
|
# should be set from the last response. The error code
|
|
372
|
-
#
|
|
373
|
-
# should be called again with the same
|
|
372
|
+
# `google.rpc.Code.ABORTED` (RPC) is returned on wait timeout, which
|
|
373
|
+
# should be called again with the same `wait_token`.
|
|
374
374
|
# @param options [Google::Gax::CallOptions]
|
|
375
375
|
# Overrides the default settings for this call, e.g, timeout,
|
|
376
376
|
# retries, etc.
|
|
@@ -384,10 +384,10 @@ module Google
|
|
|
384
384
|
#
|
|
385
385
|
# debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
|
|
386
386
|
#
|
|
387
|
-
# # TODO: Initialize
|
|
387
|
+
# # TODO: Initialize `debuggee_id`:
|
|
388
388
|
# debuggee_id = ''
|
|
389
389
|
#
|
|
390
|
-
# # TODO: Initialize
|
|
390
|
+
# # TODO: Initialize `client_version`:
|
|
391
391
|
# client_version = ''
|
|
392
392
|
# response = debugger2_client.list_breakpoints(debuggee_id, client_version)
|
|
393
393
|
|
|
@@ -420,9 +420,9 @@ module Google
|
|
|
420
420
|
# Project number of a Google Cloud project whose debuggees to list.
|
|
421
421
|
# @param client_version [String]
|
|
422
422
|
# The client version making the call.
|
|
423
|
-
# Schema:
|
|
423
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
424
424
|
# @param include_inactive [true, false]
|
|
425
|
-
# When set to
|
|
425
|
+
# When set to `true`, the result includes all debuggees. Otherwise, the
|
|
426
426
|
# result includes only debuggees that are active.
|
|
427
427
|
# @param options [Google::Gax::CallOptions]
|
|
428
428
|
# Overrides the default settings for this call, e.g, timeout,
|
|
@@ -437,10 +437,10 @@ module Google
|
|
|
437
437
|
#
|
|
438
438
|
# debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
|
|
439
439
|
#
|
|
440
|
-
# # TODO: Initialize
|
|
440
|
+
# # TODO: Initialize `project`:
|
|
441
441
|
# project = ''
|
|
442
442
|
#
|
|
443
|
-
# # TODO: Initialize
|
|
443
|
+
# # TODO: Initialize `client_version`:
|
|
444
444
|
# client_version = ''
|
|
445
445
|
# response = debugger2_client.list_debuggees(project, client_version)
|
|
446
446
|
|
|
@@ -21,7 +21,7 @@ module Google
|
|
|
21
21
|
# @!attribute [rw] debuggee
|
|
22
22
|
# @return [Google::Devtools::Clouddebugger::V2::Debuggee]
|
|
23
23
|
# Debuggee information to register.
|
|
24
|
-
# The fields
|
|
24
|
+
# The fields `project`, `uniquifier`, `description` and `agent_version`
|
|
25
25
|
# of the debuggee must be set.
|
|
26
26
|
class RegisterDebuggeeRequest; end
|
|
27
27
|
|
|
@@ -29,10 +29,10 @@ module Google
|
|
|
29
29
|
# @!attribute [rw] debuggee
|
|
30
30
|
# @return [Google::Devtools::Clouddebugger::V2::Debuggee]
|
|
31
31
|
# Debuggee resource.
|
|
32
|
-
# The field
|
|
33
|
-
# If the field
|
|
32
|
+
# The field `id` is guranteed to be set (in addition to the echoed fields).
|
|
33
|
+
# If the field `is_disabled` is set to `true`, the agent should disable
|
|
34
34
|
# itself by removing all breakpoints and detaching from the application.
|
|
35
|
-
# It should however continue to poll
|
|
35
|
+
# It should however continue to poll `RegisterDebuggee` until reenabled.
|
|
36
36
|
class RegisterDebuggeeResponse; end
|
|
37
37
|
|
|
38
38
|
# Request to list active breakpoints.
|
|
@@ -43,15 +43,15 @@ module Google
|
|
|
43
43
|
# @return [String]
|
|
44
44
|
# A token that, if specified, blocks the method call until the list
|
|
45
45
|
# of active breakpoints has changed, or a server-selected timeout has
|
|
46
|
-
# expired. The value should be set from the
|
|
47
|
-
# the last response. The initial value should be set to
|
|
46
|
+
# expired. The value should be set from the `next_wait_token` field in
|
|
47
|
+
# the last response. The initial value should be set to `"init"`.
|
|
48
48
|
# @!attribute [rw] success_on_timeout
|
|
49
49
|
# @return [true, false]
|
|
50
|
-
# If set to
|
|
51
|
-
# sets the
|
|
50
|
+
# If set to `true` (recommended), returns `google.rpc.Code.OK` status and
|
|
51
|
+
# sets the `wait_expired` response field to `true` when the server-selected
|
|
52
52
|
# timeout has expired.
|
|
53
53
|
#
|
|
54
|
-
# If set to
|
|
54
|
+
# If set to `false` (deprecated), returns `google.rpc.Code.ABORTED` status
|
|
55
55
|
# when the server-selected timeout has expired.
|
|
56
56
|
class ListActiveBreakpointsRequest; end
|
|
57
57
|
|
|
@@ -59,16 +59,16 @@ module Google
|
|
|
59
59
|
# @!attribute [rw] breakpoints
|
|
60
60
|
# @return [Array<Google::Devtools::Clouddebugger::V2::Breakpoint>]
|
|
61
61
|
# List of all active breakpoints.
|
|
62
|
-
# The fields
|
|
62
|
+
# The fields `id` and `location` are guaranteed to be set on each breakpoint.
|
|
63
63
|
# @!attribute [rw] next_wait_token
|
|
64
64
|
# @return [String]
|
|
65
65
|
# A token that can be used in the next method call to block until
|
|
66
66
|
# the list of breakpoints changes.
|
|
67
67
|
# @!attribute [rw] wait_expired
|
|
68
68
|
# @return [true, false]
|
|
69
|
-
# If set to
|
|
69
|
+
# If set to `true`, indicates that there is no change to the
|
|
70
70
|
# list of active breakpoints and the server-selected timeout has expired.
|
|
71
|
-
# The
|
|
71
|
+
# The `breakpoints` field would be empty and should be ignored.
|
|
72
72
|
class ListActiveBreakpointsResponse; end
|
|
73
73
|
|
|
74
74
|
# Request to update an active breakpoint.
|
|
@@ -78,7 +78,7 @@ module Google
|
|
|
78
78
|
# @!attribute [rw] breakpoint
|
|
79
79
|
# @return [Google::Devtools::Clouddebugger::V2::Breakpoint]
|
|
80
80
|
# Updated breakpoint information.
|
|
81
|
-
# The field
|
|
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
|
|
84
84
|
|
|
@@ -20,15 +20,15 @@ module Google
|
|
|
20
20
|
# Represents a message with parameters.
|
|
21
21
|
# @!attribute [rw] format
|
|
22
22
|
# @return [String]
|
|
23
|
-
# Format template for the message. The
|
|
24
|
-
#
|
|
23
|
+
# Format template for the message. The `format` uses placeholders `$0`,
|
|
24
|
+
# `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
|
|
25
25
|
# character.
|
|
26
26
|
#
|
|
27
27
|
# Examples:
|
|
28
28
|
#
|
|
29
|
-
# *
|
|
30
|
-
# is loaded. Again, $0 is very important
|
|
31
|
-
# *
|
|
29
|
+
# * `Failed to load '$0' which helps debug $1 the first time it
|
|
30
|
+
# is loaded. Again, $0 is very important.`
|
|
31
|
+
# * `Please pay $$10 to use $0 instead of $1.`
|
|
32
32
|
# @!attribute [rw] parameters
|
|
33
33
|
# @return [Array<String>]
|
|
34
34
|
# Optional parameters to be embedded into the message.
|
|
@@ -37,8 +37,8 @@ module Google
|
|
|
37
37
|
# Represents a contextual status message.
|
|
38
38
|
# The message can indicate an error or informational status, and refer to
|
|
39
39
|
# specific parts of the containing object.
|
|
40
|
-
# For example, the
|
|
41
|
-
# to the
|
|
40
|
+
# For example, the `Breakpoint.status` field can indicate an error referring
|
|
41
|
+
# to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
|
|
42
42
|
# @!attribute [rw] is_error
|
|
43
43
|
# @return [true, false]
|
|
44
44
|
# Distinguishes errors from informational messages.
|
|
@@ -80,7 +80,7 @@ module Google
|
|
|
80
80
|
# Path to the source file within the source context of the target binary.
|
|
81
81
|
# @!attribute [rw] line
|
|
82
82
|
# @return [Integer]
|
|
83
|
-
# Line inside the file. The first line in the file has the value
|
|
83
|
+
# Line inside the file. The first line in the file has the value `1`.
|
|
84
84
|
class SourceLocation; end
|
|
85
85
|
|
|
86
86
|
# Represents a variable or an argument possibly of a compound object type.
|
|
@@ -132,7 +132,7 @@ module Google
|
|
|
132
132
|
# }
|
|
133
133
|
#
|
|
134
134
|
# The status should describe the reason for the missing value,
|
|
135
|
-
# such as
|
|
135
|
+
# such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
|
|
136
136
|
#
|
|
137
137
|
# Note that a null pointer should not have members.
|
|
138
138
|
#
|
|
@@ -167,7 +167,7 @@ module Google
|
|
|
167
167
|
#
|
|
168
168
|
# To optimize computation, memory and network traffic, variables that
|
|
169
169
|
# repeat in the output multiple times can be stored once in a shared
|
|
170
|
-
# variable table and be referenced using the
|
|
170
|
+
# variable table and be referenced using the `var_table_index` field. The
|
|
171
171
|
# variables stored in the shared table are nameless and are essentially
|
|
172
172
|
# a partition of the complete variable. To reconstruct the complete
|
|
173
173
|
# variable, merge the referencing variable with the referenced variable.
|
|
@@ -200,8 +200,8 @@ module Google
|
|
|
200
200
|
# Simple value of the variable.
|
|
201
201
|
# @!attribute [rw] type
|
|
202
202
|
# @return [String]
|
|
203
|
-
# Variable type (e.g.
|
|
204
|
-
#
|
|
203
|
+
# Variable type (e.g. `MyClass`). If the variable is split with
|
|
204
|
+
# `var_table_index`, `type` goes next to `value`. The interpretation of
|
|
205
205
|
# a type is agent specific. It is recommended to include the dynamic type
|
|
206
206
|
# rather than a static type of an object.
|
|
207
207
|
# @!attribute [rw] members
|
|
@@ -211,7 +211,7 @@ module Google
|
|
|
211
211
|
# @return [Google::Protobuf::Int32Value]
|
|
212
212
|
# Reference to a variable in the shared variable table. More than
|
|
213
213
|
# one variable can reference the same variable in the table. The
|
|
214
|
-
#
|
|
214
|
+
# `var_table_index` field is an index into `variable_table` in Breakpoint.
|
|
215
215
|
# @!attribute [rw] status
|
|
216
216
|
# @return [Google::Devtools::Clouddebugger::V2::StatusMessage]
|
|
217
217
|
# Status associated with the variable. This field will usually stay
|
|
@@ -220,19 +220,19 @@ module Google
|
|
|
220
220
|
# might be reported in error state even when breakpoint is not in final
|
|
221
221
|
# state.
|
|
222
222
|
#
|
|
223
|
-
# The message may refer to variable name with
|
|
224
|
-
#
|
|
223
|
+
# The message may refer to variable name with `refers_to` set to
|
|
224
|
+
# `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
|
|
225
225
|
# In either case variable value and members will be unset.
|
|
226
226
|
#
|
|
227
|
-
# Example of error message applied to name:
|
|
227
|
+
# Example of error message applied to name: `Invalid expression syntax`.
|
|
228
228
|
#
|
|
229
|
-
# Example of information message applied to value:
|
|
229
|
+
# Example of information message applied to value: `Not captured`.
|
|
230
230
|
#
|
|
231
231
|
# Examples of error message applied to value:
|
|
232
232
|
#
|
|
233
|
-
# *
|
|
234
|
-
# *
|
|
235
|
-
# *
|
|
233
|
+
# * `Malformed string`,
|
|
234
|
+
# * `Field f not found in class C`
|
|
235
|
+
# * `Null pointer dereference`
|
|
236
236
|
class Variable; end
|
|
237
237
|
|
|
238
238
|
# Represents a stack frame context.
|
|
@@ -272,21 +272,21 @@ module Google
|
|
|
272
272
|
# @return [Array<String>]
|
|
273
273
|
# List of read-only expressions to evaluate at the breakpoint location.
|
|
274
274
|
# The expressions are composed using expressions in the programming language
|
|
275
|
-
# at the source location. If the breakpoint action is
|
|
275
|
+
# at the source location. If the breakpoint action is `LOG`, the evaluated
|
|
276
276
|
# expressions are included in log statements.
|
|
277
277
|
# @!attribute [rw] log_message_format
|
|
278
278
|
# @return [String]
|
|
279
|
-
# Only relevant when action is
|
|
280
|
-
# the breakpoint hits. The message may include parameter placeholders
|
|
281
|
-
#
|
|
279
|
+
# Only relevant when action is `LOG`. Defines the message to log when
|
|
280
|
+
# the breakpoint hits. The message may include parameter placeholders `$0`,
|
|
281
|
+
# `$1`, etc. These placeholders are replaced with the evaluated value
|
|
282
282
|
# of the appropriate expression. Expressions not referenced in
|
|
283
|
-
#
|
|
283
|
+
# `log_message_format` are not logged.
|
|
284
284
|
#
|
|
285
|
-
# Example:
|
|
286
|
-
#
|
|
285
|
+
# Example: `Message received, id = $0, count = $1` with
|
|
286
|
+
# `expressions` = `[ message.id, message.count ]`.
|
|
287
287
|
# @!attribute [rw] log_level
|
|
288
288
|
# @return [Google::Devtools::Clouddebugger::V2::Breakpoint::LogLevel]
|
|
289
|
-
# Indicates the severity of the log. Only relevant when action is
|
|
289
|
+
# Indicates the severity of the log. Only relevant when action is `LOG`.
|
|
290
290
|
# @!attribute [rw] is_final_state
|
|
291
291
|
# @return [true, false]
|
|
292
292
|
# When true, indicates that this is a final result and the
|
|
@@ -312,12 +312,12 @@ module Google
|
|
|
312
312
|
#
|
|
313
313
|
# Error status indicates complete failure of the breakpoint.
|
|
314
314
|
#
|
|
315
|
-
# Example (non-final state):
|
|
315
|
+
# Example (non-final state): `Still loading symbols...`
|
|
316
316
|
#
|
|
317
317
|
# Examples (final state):
|
|
318
318
|
#
|
|
319
|
-
# *
|
|
320
|
-
# *
|
|
319
|
+
# * `Invalid line number` referring to location
|
|
320
|
+
# * `Field f not found in class C` referring to condition
|
|
321
321
|
# @!attribute [rw] stack_frames
|
|
322
322
|
# @return [Array<Google::Devtools::Clouddebugger::V2::StackFrame>]
|
|
323
323
|
# The stack at breakpoint time.
|
|
@@ -325,22 +325,22 @@ module Google
|
|
|
325
325
|
# @return [Array<Google::Devtools::Clouddebugger::V2::Variable>]
|
|
326
326
|
# Values of evaluated expressions at breakpoint time.
|
|
327
327
|
# The evaluated expressions appear in exactly the same order they
|
|
328
|
-
# are listed in the
|
|
329
|
-
# The
|
|
330
|
-
#
|
|
331
|
-
# If the expression cannot be evaluated, the
|
|
328
|
+
# are listed in the `expressions` field.
|
|
329
|
+
# The `name` field holds the original expression text, the `value` or
|
|
330
|
+
# `members` field holds the result of the evaluated expression.
|
|
331
|
+
# If the expression cannot be evaluated, the `status` inside the `Variable`
|
|
332
332
|
# will indicate an error and contain the error text.
|
|
333
333
|
# @!attribute [rw] variable_table
|
|
334
334
|
# @return [Array<Google::Devtools::Clouddebugger::V2::Variable>]
|
|
335
|
-
# The
|
|
335
|
+
# The `variable_table` exists to aid with computation, memory and network
|
|
336
336
|
# traffic optimization. It enables storing a variable once and reference
|
|
337
337
|
# it from multiple variables, including variables stored in the
|
|
338
|
-
#
|
|
339
|
-
# For example, the same
|
|
338
|
+
# `variable_table` itself.
|
|
339
|
+
# For example, the same `this` object, which may appear at many levels of
|
|
340
340
|
# the stack, can have all of its data stored once in this table. The
|
|
341
341
|
# stack frame variables then would hold only a reference to it.
|
|
342
342
|
#
|
|
343
|
-
# The variable
|
|
343
|
+
# The variable `var_table_index` field is an index into this repeated field.
|
|
344
344
|
# The stored objects are nameless and get their name from the referencing
|
|
345
345
|
# variable. The effective variable is a merge of the referencing variable
|
|
346
346
|
# and the referenced variable.
|
|
@@ -402,16 +402,16 @@ module Google
|
|
|
402
402
|
# information is recommended.
|
|
403
403
|
# @!attribute [rw] is_inactive
|
|
404
404
|
# @return [true, false]
|
|
405
|
-
# If set to
|
|
405
|
+
# If set to `true`, indicates that Controller service does not detect any
|
|
406
406
|
# activity from the debuggee agents and the application is possibly stopped.
|
|
407
407
|
# @!attribute [rw] agent_version
|
|
408
408
|
# @return [String]
|
|
409
409
|
# Version ID of the agent.
|
|
410
|
-
# Schema:
|
|
411
|
-
#
|
|
410
|
+
# Schema: `domain/language-platform/vmajor.minor` (for example
|
|
411
|
+
# `google.com/java-gcp/v1.1`).
|
|
412
412
|
# @!attribute [rw] is_disabled
|
|
413
413
|
# @return [true, false]
|
|
414
|
-
# If set to
|
|
414
|
+
# If set to `true`, indicates that the agent should disable itself and
|
|
415
415
|
# detach from the debuggee.
|
|
416
416
|
# @!attribute [rw] status
|
|
417
417
|
# @return [Google::Devtools::Clouddebugger::V2::StatusMessage]
|
|
@@ -24,18 +24,18 @@ module Google
|
|
|
24
24
|
# @!attribute [rw] breakpoint
|
|
25
25
|
# @return [Google::Devtools::Clouddebugger::V2::Breakpoint]
|
|
26
26
|
# Breakpoint specification to set.
|
|
27
|
-
# The field
|
|
27
|
+
# The field `location` of the breakpoint must be set.
|
|
28
28
|
# @!attribute [rw] client_version
|
|
29
29
|
# @return [String]
|
|
30
30
|
# The client version making the call.
|
|
31
|
-
# Schema:
|
|
31
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
32
32
|
class SetBreakpointRequest; end
|
|
33
33
|
|
|
34
34
|
# Response for setting a breakpoint.
|
|
35
35
|
# @!attribute [rw] breakpoint
|
|
36
36
|
# @return [Google::Devtools::Clouddebugger::V2::Breakpoint]
|
|
37
37
|
# Breakpoint resource.
|
|
38
|
-
# The field
|
|
38
|
+
# The field `id` is guaranteed to be set (in addition to the echoed fileds).
|
|
39
39
|
class SetBreakpointResponse; end
|
|
40
40
|
|
|
41
41
|
# Request to get breakpoint information.
|
|
@@ -48,14 +48,14 @@ module Google
|
|
|
48
48
|
# @!attribute [rw] client_version
|
|
49
49
|
# @return [String]
|
|
50
50
|
# The client version making the call.
|
|
51
|
-
# Schema:
|
|
51
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
52
52
|
class GetBreakpointRequest; end
|
|
53
53
|
|
|
54
54
|
# Response for getting breakpoint information.
|
|
55
55
|
# @!attribute [rw] breakpoint
|
|
56
56
|
# @return [Google::Devtools::Clouddebugger::V2::Breakpoint]
|
|
57
57
|
# Complete breakpoint state.
|
|
58
|
-
# The fields
|
|
58
|
+
# The fields `id` and `location` are guaranteed to be set.
|
|
59
59
|
class GetBreakpointResponse; end
|
|
60
60
|
|
|
61
61
|
# Request to delete a breakpoint.
|
|
@@ -68,7 +68,7 @@ module Google
|
|
|
68
68
|
# @!attribute [rw] client_version
|
|
69
69
|
# @return [String]
|
|
70
70
|
# The client version making the call.
|
|
71
|
-
# Schema:
|
|
71
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
72
72
|
class DeleteBreakpointRequest; end
|
|
73
73
|
|
|
74
74
|
# Request to list breakpoints.
|
|
@@ -77,11 +77,11 @@ module Google
|
|
|
77
77
|
# ID of the debuggee whose breakpoints to list.
|
|
78
78
|
# @!attribute [rw] include_all_users
|
|
79
79
|
# @return [true, false]
|
|
80
|
-
# When set to
|
|
80
|
+
# When set to `true`, the response includes the list of breakpoints set by
|
|
81
81
|
# any user. Otherwise, it includes only breakpoints set by the caller.
|
|
82
82
|
# @!attribute [rw] include_inactive
|
|
83
83
|
# @return [true, false]
|
|
84
|
-
# When set to
|
|
84
|
+
# When set to `true`, the response includes active and inactive
|
|
85
85
|
# breakpoints. Otherwise, it includes only active breakpoints.
|
|
86
86
|
# @!attribute [rw] action
|
|
87
87
|
# @return [Google::Devtools::Clouddebugger::V2::ListBreakpointsRequest::BreakpointActionValue]
|
|
@@ -89,20 +89,20 @@ module Google
|
|
|
89
89
|
# @!attribute [rw] strip_results
|
|
90
90
|
# @return [true, false]
|
|
91
91
|
# This field is deprecated. The following fields are always stripped out of
|
|
92
|
-
# the result:
|
|
92
|
+
# the result: `stack_frames`, `evaluated_expressions` and `variable_table`.
|
|
93
93
|
# @!attribute [rw] wait_token
|
|
94
94
|
# @return [String]
|
|
95
95
|
# A wait token that, if specified, blocks the call until the breakpoints
|
|
96
96
|
# list has changed, or a server selected timeout has expired. The value
|
|
97
97
|
# should be set from the last response. The error code
|
|
98
|
-
#
|
|
99
|
-
# should be called again with the same
|
|
98
|
+
# `google.rpc.Code.ABORTED` (RPC) is returned on wait timeout, which
|
|
99
|
+
# should be called again with the same `wait_token`.
|
|
100
100
|
# @!attribute [rw] client_version
|
|
101
101
|
# @return [String]
|
|
102
102
|
# The client version making the call.
|
|
103
|
-
# Schema:
|
|
103
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
104
104
|
class ListBreakpointsRequest
|
|
105
|
-
# Wrapper message for
|
|
105
|
+
# Wrapper message for `Breakpoint.Action`. Defines a filter on the action
|
|
106
106
|
# field of breakpoints.
|
|
107
107
|
# @!attribute [rw] value
|
|
108
108
|
# @return [Google::Devtools::Clouddebugger::V2::Breakpoint::Action]
|
|
@@ -114,13 +114,13 @@ module Google
|
|
|
114
114
|
# @!attribute [rw] breakpoints
|
|
115
115
|
# @return [Array<Google::Devtools::Clouddebugger::V2::Breakpoint>]
|
|
116
116
|
# List of breakpoints matching the request.
|
|
117
|
-
# The fields
|
|
118
|
-
# The fields:
|
|
117
|
+
# The fields `id` and `location` are guaranteed to be set on each breakpoint.
|
|
118
|
+
# The fields: `stack_frames`, `evaluated_expressions` and `variable_table`
|
|
119
119
|
# are cleared on each breakpoint regardless of its status.
|
|
120
120
|
# @!attribute [rw] next_wait_token
|
|
121
121
|
# @return [String]
|
|
122
|
-
# A wait token that can be used in the next call to
|
|
123
|
-
#
|
|
122
|
+
# A wait token that can be used in the next call to `list` (REST) or
|
|
123
|
+
# `ListBreakpoints` (RPC) to block until the list of breakpoints has changes.
|
|
124
124
|
class ListBreakpointsResponse; end
|
|
125
125
|
|
|
126
126
|
# Request to list debuggees.
|
|
@@ -129,20 +129,20 @@ module Google
|
|
|
129
129
|
# Project number of a Google Cloud project whose debuggees to list.
|
|
130
130
|
# @!attribute [rw] include_inactive
|
|
131
131
|
# @return [true, false]
|
|
132
|
-
# When set to
|
|
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
136
|
# The client version making the call.
|
|
137
|
-
# Schema:
|
|
137
|
+
# Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
|
|
138
138
|
class ListDebuggeesRequest; end
|
|
139
139
|
|
|
140
140
|
# Response for listing debuggees.
|
|
141
141
|
# @!attribute [rw] debuggees
|
|
142
142
|
# @return [Array<Google::Devtools::Clouddebugger::V2::Debuggee>]
|
|
143
143
|
# List of debuggees accessible to the calling user.
|
|
144
|
-
# The fields
|
|
145
|
-
# The
|
|
144
|
+
# The fields `debuggee.id` and `description` are guaranteed to be set.
|
|
145
|
+
# The `description` field is a human readable field provided by agents and
|
|
146
146
|
# can be displayed to users.
|
|
147
147
|
class ListDebuggeesResponse; end
|
|
148
148
|
end
|
|
@@ -23,7 +23,7 @@ module Google
|
|
|
23
23
|
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
|
|
24
24
|
# }
|
|
25
25
|
#
|
|
26
|
-
# The JSON representation for
|
|
26
|
+
# The JSON representation for `Empty` is empty JSON object `{}`.
|
|
27
27
|
class Empty; end
|
|
28
28
|
end
|
|
29
29
|
end
|
|
@@ -29,13 +29,13 @@ module Google
|
|
|
29
29
|
#
|
|
30
30
|
# = Examples
|
|
31
31
|
#
|
|
32
|
-
# Example 1: Compute Timestamp from POSIX
|
|
32
|
+
# Example 1: Compute Timestamp from POSIX `time()`.
|
|
33
33
|
#
|
|
34
34
|
# Timestamp timestamp;
|
|
35
35
|
# timestamp.set_seconds(time(NULL));
|
|
36
36
|
# timestamp.set_nanos(0);
|
|
37
37
|
#
|
|
38
|
-
# Example 2: Compute Timestamp from POSIX
|
|
38
|
+
# Example 2: Compute Timestamp from POSIX `gettimeofday()`.
|
|
39
39
|
#
|
|
40
40
|
# struct timeval tv;
|
|
41
41
|
# gettimeofday(&tv, NULL);
|
|
@@ -44,7 +44,7 @@ module Google
|
|
|
44
44
|
# timestamp.set_seconds(tv.tv_sec);
|
|
45
45
|
# timestamp.set_nanos(tv.tv_usec * 1000);
|
|
46
46
|
#
|
|
47
|
-
# Example 3: Compute Timestamp from Win32
|
|
47
|
+
# Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
|
|
48
48
|
#
|
|
49
49
|
# FILETIME ft;
|
|
50
50
|
# GetSystemTimeAsFileTime(&ft);
|
|
@@ -56,7 +56,7 @@ module Google
|
|
|
56
56
|
# timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
|
|
57
57
|
# timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
|
|
58
58
|
#
|
|
59
|
-
# Example 4: Compute Timestamp from Java
|
|
59
|
+
# Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
|
|
60
60
|
#
|
|
61
61
|
# long millis = System.currentTimeMillis();
|
|
62
62
|
#
|
|
@@ -87,10 +87,10 @@ module Google
|
|
|
87
87
|
#
|
|
88
88
|
# In JavaScript, one can convert a Date object to this format using the
|
|
89
89
|
# standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
|
|
90
|
-
# method. In Python, a standard
|
|
91
|
-
# to this format using [
|
|
90
|
+
# method. In Python, a standard `datetime.datetime` object can be converted
|
|
91
|
+
# to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
|
|
92
92
|
# with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
|
|
93
|
-
# can use the Joda Time's [
|
|
93
|
+
# can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
|
|
94
94
|
# http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
|
|
95
95
|
# ) to obtain a formatter capable of generating timestamps in this format.
|
|
96
96
|
# @!attribute [rw] seconds
|
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.32.
|
|
4
|
+
version: 0.32.5
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Heng Xiong
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2018-09-
|
|
11
|
+
date: 2018-09-21 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: binding_of_caller
|
|
@@ -331,7 +331,7 @@ files:
|
|
|
331
331
|
- lib/google/devtools/clouddebugger/v2/debugger_pb.rb
|
|
332
332
|
- lib/google/devtools/clouddebugger/v2/debugger_services_pb.rb
|
|
333
333
|
- lib/google/devtools/source/v1/source_context_pb.rb
|
|
334
|
-
homepage: https://github.com/
|
|
334
|
+
homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-debugger
|
|
335
335
|
licenses:
|
|
336
336
|
- Apache-2.0
|
|
337
337
|
metadata: {}
|