google-api-client 0.9.20 → 0.9.21

Sign up to get free protection for your applications and to get access to all the features.
Files changed (159) hide show
  1. checksums.yaml +4 -4
  2. data/.travis.yml +8 -4
  3. data/api_names.yaml +33179 -1058
  4. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  5. data/generated/google/apis/adexchangebuyer_v1_4.rb +1 -1
  6. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +24 -6
  7. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +2 -0
  8. data/generated/google/apis/admin_directory_v1.rb +1 -1
  9. data/generated/google/apis/admin_directory_v1/classes.rb +14 -0
  10. data/generated/google/apis/admin_directory_v1/representations.rb +2 -0
  11. data/generated/google/apis/adsense_v1_4.rb +1 -1
  12. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  13. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  14. data/generated/google/apis/analyticsreporting_v4/classes.rb +7 -0
  15. data/generated/google/apis/analyticsreporting_v4/representations.rb +1 -0
  16. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  17. data/generated/google/apis/androidenterprise_v1/classes.rb +96 -156
  18. data/generated/google/apis/androidenterprise_v1/representations.rb +18 -47
  19. data/generated/google/apis/androidenterprise_v1/service.rb +15 -459
  20. data/generated/google/apis/androidpublisher_v2.rb +1 -1
  21. data/generated/google/apis/androidpublisher_v2/classes.rb +176 -0
  22. data/generated/google/apis/androidpublisher_v2/representations.rb +62 -0
  23. data/generated/google/apis/androidpublisher_v2/service.rb +60 -2
  24. data/generated/google/apis/appengine_v1beta5.rb +1 -1
  25. data/generated/google/apis/appengine_v1beta5/classes.rb +300 -198
  26. data/generated/google/apis/appengine_v1beta5/representations.rb +36 -0
  27. data/generated/google/apis/appengine_v1beta5/service.rb +54 -49
  28. data/generated/google/apis/appsactivity_v1.rb +1 -1
  29. data/generated/google/apis/appstate_v1.rb +1 -1
  30. data/generated/google/apis/bigquery_v2.rb +1 -1
  31. data/generated/google/apis/bigquery_v2/classes.rb +50 -6
  32. data/generated/google/apis/bigquery_v2/representations.rb +5 -0
  33. data/generated/google/apis/books_v1.rb +1 -1
  34. data/generated/google/apis/books_v1/classes.rb +7 -2
  35. data/generated/google/apis/books_v1/representations.rb +1 -0
  36. data/generated/google/apis/calendar_v3.rb +1 -1
  37. data/generated/google/apis/classroom_v1.rb +1 -1
  38. data/generated/google/apis/classroom_v1/classes.rb +74 -74
  39. data/generated/google/apis/classroom_v1/representations.rb +29 -29
  40. data/generated/google/apis/classroom_v1/service.rb +132 -28
  41. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  42. data/generated/google/apis/cloudbuild_v1/classes.rb +47 -27
  43. data/generated/google/apis/cloudbuild_v1/representations.rb +20 -7
  44. data/generated/google/apis/cloudbuild_v1/service.rb +42 -0
  45. data/generated/google/apis/clouddebugger_v2.rb +1 -1
  46. data/generated/google/apis/clouddebugger_v2/classes.rb +648 -578
  47. data/generated/google/apis/clouddebugger_v2/representations.rb +140 -140
  48. data/generated/google/apis/clouddebugger_v2/service.rb +161 -155
  49. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  50. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +563 -423
  51. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +116 -76
  52. data/generated/google/apis/cloudresourcemanager_v1/service.rb +318 -249
  53. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  54. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +396 -331
  55. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +79 -79
  56. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +317 -281
  57. data/generated/google/apis/compute_beta.rb +1 -1
  58. data/generated/google/apis/compute_beta/classes.rb +352 -80
  59. data/generated/google/apis/compute_beta/representations.rb +132 -19
  60. data/generated/google/apis/compute_beta/service.rb +214 -0
  61. data/generated/google/apis/compute_v1.rb +1 -1
  62. data/generated/google/apis/compute_v1/classes.rb +673 -73
  63. data/generated/google/apis/compute_v1/representations.rb +274 -9
  64. data/generated/google/apis/compute_v1/service.rb +1574 -2
  65. data/generated/google/apis/content_v2.rb +1 -1
  66. data/generated/google/apis/content_v2/classes.rb +7 -8
  67. data/generated/google/apis/content_v2/service.rb +125 -54
  68. data/generated/google/apis/dataflow_v1b3.rb +2 -3
  69. data/generated/google/apis/dataflow_v1b3/classes.rb +286 -114
  70. data/generated/google/apis/dataflow_v1b3/representations.rb +73 -0
  71. data/generated/google/apis/dataflow_v1b3/service.rb +37 -38
  72. data/generated/google/apis/datastore_v1.rb +1 -1
  73. data/generated/google/apis/datastore_v1/classes.rb +5 -0
  74. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  75. data/generated/google/apis/deploymentmanager_v2/classes.rb +37 -5
  76. data/generated/google/apis/deploymentmanager_v2/representations.rb +16 -0
  77. data/generated/google/apis/deploymentmanager_v2/service.rb +4 -1
  78. data/generated/google/apis/dns_v1.rb +1 -1
  79. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  80. data/generated/google/apis/drive_v2.rb +1 -1
  81. data/generated/google/apis/drive_v2/classes.rb +55 -21
  82. data/generated/google/apis/drive_v2/representations.rb +2 -0
  83. data/generated/google/apis/drive_v3.rb +1 -1
  84. data/generated/google/apis/drive_v3/classes.rb +41 -12
  85. data/generated/google/apis/drive_v3/representations.rb +2 -0
  86. data/generated/google/apis/fitness_v1.rb +31 -1
  87. data/generated/google/apis/fitness_v1/classes.rb +1 -1
  88. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  89. data/generated/google/apis/games_management_v1management.rb +1 -1
  90. data/generated/google/apis/games_v1.rb +1 -1
  91. data/generated/google/apis/gmail_v1.rb +1 -1
  92. data/generated/google/apis/gmail_v1/classes.rb +32 -1
  93. data/generated/google/apis/gmail_v1/representations.rb +15 -0
  94. data/generated/google/apis/gmail_v1/service.rb +41 -2
  95. data/generated/google/apis/identitytoolkit_v3.rb +4 -1
  96. data/generated/google/apis/identitytoolkit_v3/classes.rb +7 -0
  97. data/generated/google/apis/identitytoolkit_v3/representations.rb +1 -0
  98. data/generated/google/apis/kgsearch_v1.rb +2 -3
  99. data/generated/google/apis/kgsearch_v1/classes.rb +10 -10
  100. data/generated/google/apis/kgsearch_v1/representations.rb +2 -2
  101. data/generated/google/apis/kgsearch_v1/service.rb +28 -26
  102. data/generated/google/apis/language_v1beta1.rb +1 -1
  103. data/generated/google/apis/language_v1beta1/classes.rb +166 -8
  104. data/generated/google/apis/language_v1beta1/representations.rb +50 -0
  105. data/generated/google/apis/language_v1beta1/service.rb +32 -0
  106. data/generated/google/apis/logging_v2beta1.rb +6 -6
  107. data/generated/google/apis/logging_v2beta1/classes.rb +868 -789
  108. data/generated/google/apis/logging_v2beta1/representations.rb +179 -147
  109. data/generated/google/apis/logging_v2beta1/service.rb +378 -211
  110. data/generated/google/apis/monitoring_v3.rb +1 -1
  111. data/generated/google/apis/monitoring_v3/classes.rb +110 -112
  112. data/generated/google/apis/monitoring_v3/service.rb +68 -73
  113. data/generated/google/apis/pagespeedonline_v2.rb +1 -1
  114. data/generated/google/apis/plus_domains_v1.rb +1 -1
  115. data/generated/google/apis/plus_v1.rb +1 -1
  116. data/generated/google/apis/pubsub_v1.rb +1 -1
  117. data/generated/google/apis/pubsub_v1/classes.rb +380 -327
  118. data/generated/google/apis/pubsub_v1/representations.rb +79 -79
  119. data/generated/google/apis/pubsub_v1/service.rb +424 -396
  120. data/generated/google/apis/sheets_v4.rb +1 -1
  121. data/generated/google/apis/sheets_v4/classes.rb +175 -53
  122. data/generated/google/apis/sheets_v4/representations.rb +48 -13
  123. data/generated/google/apis/site_verification_v1.rb +1 -1
  124. data/generated/google/apis/slides_v1.rb +1 -1
  125. data/generated/google/apis/slides_v1/classes.rb +149 -31
  126. data/generated/google/apis/slides_v1/representations.rb +52 -9
  127. data/generated/google/apis/slides_v1/service.rb +5 -5
  128. data/generated/google/apis/speech_v1beta1.rb +1 -1
  129. data/generated/google/apis/speech_v1beta1/service.rb +3 -1
  130. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  131. data/generated/google/apis/sqladmin_v1beta4/classes.rb +54 -2
  132. data/generated/google/apis/sqladmin_v1beta4/representations.rb +29 -0
  133. data/generated/google/apis/sqladmin_v1beta4/service.rb +41 -0
  134. data/generated/google/apis/storage_v1.rb +1 -1
  135. data/generated/google/apis/storage_v1/classes.rb +7 -0
  136. data/generated/google/apis/storage_v1/representations.rb +2 -0
  137. data/generated/google/apis/tagmanager_v1.rb +5 -5
  138. data/generated/google/apis/vision_v1.rb +1 -1
  139. data/generated/google/apis/vision_v1/classes.rb +63 -59
  140. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  141. data/generated/google/apis/youtube_analytics_v1/classes.rb +0 -209
  142. data/generated/google/apis/youtube_analytics_v1/representations.rb +0 -99
  143. data/generated/google/apis/youtube_analytics_v1/service.rb +0 -76
  144. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  145. data/generated/google/apis/youtube_partner_v1/classes.rb +71 -0
  146. data/generated/google/apis/youtube_partner_v1/representations.rb +33 -0
  147. data/generated/google/apis/youtube_partner_v1/service.rb +52 -0
  148. data/generated/google/apis/youtube_v3.rb +1 -1
  149. data/generated/google/apis/youtube_v3/classes.rb +15 -2
  150. data/generated/google/apis/youtube_v3/representations.rb +3 -0
  151. data/generated/google/apis/youtube_v3/service.rb +4 -4
  152. data/generated/google/apis/youtubereporting_v1.rb +4 -4
  153. data/generated/google/apis/youtubereporting_v1/classes.rb +146 -137
  154. data/generated/google/apis/youtubereporting_v1/representations.rb +33 -33
  155. data/generated/google/apis/youtubereporting_v1/service.rb +149 -145
  156. data/lib/google/apis/version.rb +1 -1
  157. data/samples/cli/lib/samples/calendar.rb +1 -1
  158. data/samples/cli/lib/samples/gmail.rb +74 -0
  159. metadata +29 -29
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://cloud.google.com/container-builder/docs/
26
26
  module CloudbuildV1
27
27
  VERSION = 'V1'
28
- REVISION = '20161108'
28
+ REVISION = '20170119'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -415,6 +415,19 @@ module Google
415
415
  end
416
416
  end
417
417
 
418
+ # The request message for Operations.CancelOperation.
419
+ class CancelOperationRequest
420
+ include Google::Apis::Core::Hashable
421
+
422
+ def initialize(**args)
423
+ update!(**args)
424
+ end
425
+
426
+ # Update properties of this object
427
+ def update!(**args)
428
+ end
429
+ end
430
+
418
431
  # StorageSource describes the location of the source in an archive file in
419
432
  # Google Cloud Storage.
420
433
  class StorageSource
@@ -523,6 +536,8 @@ module Google
523
536
  attr_accessor :options
524
537
 
525
538
  # Time at which execution of the build was finished.
539
+ # The difference between finish_time and start_time is the duration of the
540
+ # build's execution.
526
541
  # @OutputOnly
527
542
  # Corresponds to the JSON property `finishTime`
528
543
  # @return [String]
@@ -547,7 +562,7 @@ module Google
547
562
  # @return [Google::Apis::CloudbuildV1::Source]
548
563
  attr_accessor :source
549
564
 
550
- # Time at which the build was created.
565
+ # Time at which the request to create the build was received.
551
566
  # @OutputOnly
552
567
  # Corresponds to the JSON property `createTime`
553
568
  # @return [String]
@@ -567,8 +582,7 @@ module Google
567
582
 
568
583
  # A list of images to be pushed upon the successful completion of all build
569
584
  # steps.
570
- # The images will be pushed using the builder
571
- # service account's credentials.
585
+ # The images will be pushed using the builder service account's credentials.
572
586
  # The digests of the pushed images will be stored in the Build resource's
573
587
  # results field.
574
588
  # If any of the images fail to be pushed, the build is marked FAILURE.
@@ -662,26 +676,6 @@ module Google
662
676
  end
663
677
  end
664
678
 
665
- # Container message for hashes of byte content of files, used in
666
- # SourceProvenance messages to verify integrity of source input to the build.
667
- class FileHashes
668
- include Google::Apis::Core::Hashable
669
-
670
- # Collection of file hashes.
671
- # Corresponds to the JSON property `fileHash`
672
- # @return [Array<Google::Apis::CloudbuildV1::HashProp>]
673
- attr_accessor :file_hash
674
-
675
- def initialize(**args)
676
- update!(**args)
677
- end
678
-
679
- # Update properties of this object
680
- def update!(**args)
681
- @file_hash = args[:file_hash] if args.key?(:file_hash)
682
- end
683
- end
684
-
685
679
  # The response message for Operations.ListOperations.
686
680
  class ListOperationsResponse
687
681
  include Google::Apis::Core::Hashable
@@ -707,6 +701,26 @@ module Google
707
701
  end
708
702
  end
709
703
 
704
+ # Container message for hashes of byte content of files, used in
705
+ # SourceProvenance messages to verify integrity of source input to the build.
706
+ class FileHashes
707
+ include Google::Apis::Core::Hashable
708
+
709
+ # Collection of file hashes.
710
+ # Corresponds to the JSON property `fileHash`
711
+ # @return [Array<Google::Apis::CloudbuildV1::HashProp>]
712
+ attr_accessor :file_hash
713
+
714
+ def initialize(**args)
715
+ update!(**args)
716
+ end
717
+
718
+ # Update properties of this object
719
+ def update!(**args)
720
+ @file_hash = args[:file_hash] if args.key?(:file_hash)
721
+ end
722
+ end
723
+
710
724
  # RepoSource describes the location of the source in a Google Cloud Source
711
725
  # Repository.
712
726
  class RepoSource
@@ -787,11 +801,16 @@ module Google
787
801
  # @return [Array<String>]
788
802
  attr_accessor :args
789
803
 
804
+ # Optional entrypoint to be used instead of the build step image's default
805
+ # If unset, the image's default will be used.
806
+ # Corresponds to the JSON property `entrypoint`
807
+ # @return [String]
808
+ attr_accessor :entrypoint
809
+
790
810
  # The name of the container image that will run this particular build step.
791
- # If the image is already available in the host's
792
- # Docker daemon's cache, it will be run directly. If not, the host will
793
- # attempt to pull the image first, using the builder service account's
794
- # credentials if necessary.
811
+ # If the image is already available in the host's Docker daemon's cache, it
812
+ # will be run directly. If not, the host will attempt to pull the image
813
+ # first, using the builder service account's credentials if necessary.
795
814
  # The Docker daemon's cache will already have the latest versions of all of
796
815
  # the officially supported build steps
797
816
  # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
@@ -821,6 +840,7 @@ module Google
821
840
  @env = args[:env] if args.key?(:env)
822
841
  @wait_for = args[:wait_for] if args.key?(:wait_for)
823
842
  @args = args[:args] if args.key?(:args)
843
+ @entrypoint = args[:entrypoint] if args.key?(:entrypoint)
824
844
  @name = args[:name] if args.key?(:name)
825
845
  @dir = args[:dir] if args.key?(:dir)
826
846
  end
@@ -70,6 +70,12 @@ module Google
70
70
  include Google::Apis::Core::JsonObjectSupport
71
71
  end
72
72
 
73
+ class CancelOperationRequest
74
+ class Representation < Google::Apis::Core::JsonRepresentation; end
75
+
76
+ include Google::Apis::Core::JsonObjectSupport
77
+ end
78
+
73
79
  class StorageSource
74
80
  class Representation < Google::Apis::Core::JsonRepresentation; end
75
81
 
@@ -100,13 +106,13 @@ module Google
100
106
  include Google::Apis::Core::JsonObjectSupport
101
107
  end
102
108
 
103
- class FileHashes
109
+ class ListOperationsResponse
104
110
  class Representation < Google::Apis::Core::JsonRepresentation; end
105
111
 
106
112
  include Google::Apis::Core::JsonObjectSupport
107
113
  end
108
114
 
109
- class ListOperationsResponse
115
+ class FileHashes
110
116
  class Representation < Google::Apis::Core::JsonRepresentation; end
111
117
 
112
118
  include Google::Apis::Core::JsonObjectSupport
@@ -224,6 +230,12 @@ module Google
224
230
  end
225
231
  end
226
232
 
233
+ class CancelOperationRequest
234
+ # @private
235
+ class Representation < Google::Apis::Core::JsonRepresentation
236
+ end
237
+ end
238
+
227
239
  class StorageSource
228
240
  # @private
229
241
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -284,19 +296,19 @@ module Google
284
296
  end
285
297
  end
286
298
 
287
- class FileHashes
299
+ class ListOperationsResponse
288
300
  # @private
289
301
  class Representation < Google::Apis::Core::JsonRepresentation
290
- collection :file_hash, as: 'fileHash', class: Google::Apis::CloudbuildV1::HashProp, decorator: Google::Apis::CloudbuildV1::HashProp::Representation
302
+ property :next_page_token, as: 'nextPageToken'
303
+ collection :operations, as: 'operations', class: Google::Apis::CloudbuildV1::Operation, decorator: Google::Apis::CloudbuildV1::Operation::Representation
291
304
 
292
305
  end
293
306
  end
294
307
 
295
- class ListOperationsResponse
308
+ class FileHashes
296
309
  # @private
297
310
  class Representation < Google::Apis::Core::JsonRepresentation
298
- property :next_page_token, as: 'nextPageToken'
299
- collection :operations, as: 'operations', class: Google::Apis::CloudbuildV1::Operation, decorator: Google::Apis::CloudbuildV1::Operation::Representation
311
+ collection :file_hash, as: 'fileHash', class: Google::Apis::CloudbuildV1::HashProp, decorator: Google::Apis::CloudbuildV1::HashProp::Representation
300
312
 
301
313
  end
302
314
  end
@@ -319,6 +331,7 @@ module Google
319
331
  collection :env, as: 'env'
320
332
  collection :wait_for, as: 'waitFor'
321
333
  collection :args, as: 'args'
334
+ property :entrypoint, as: 'entrypoint'
322
335
  property :name, as: 'name'
323
336
  property :dir, as: 'dir'
324
337
  end
@@ -437,6 +437,48 @@ module Google
437
437
  command.query['fields'] = fields unless fields.nil?
438
438
  execute_or_queue_command(command, &block)
439
439
  end
440
+
441
+ # Starts asynchronous cancellation on a long-running operation. The server
442
+ # makes a best effort to cancel the operation, but success is not
443
+ # guaranteed. If the server doesn't support this method, it returns
444
+ # `google.rpc.Code.UNIMPLEMENTED`. Clients can use
445
+ # Operations.GetOperation or
446
+ # other methods to check whether the cancellation succeeded or whether the
447
+ # operation completed despite cancellation. On successful cancellation,
448
+ # the operation is not deleted; instead, it becomes an operation with
449
+ # an Operation.error value with a google.rpc.Status.code of 1,
450
+ # corresponding to `Code.CANCELLED`.
451
+ # @param [String] name
452
+ # The name of the operation resource to be cancelled.
453
+ # @param [Google::Apis::CloudbuildV1::CancelOperationRequest] cancel_operation_request_object
454
+ # @param [String] quota_user
455
+ # Available to use for quota purposes for server-side applications. Can be any
456
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
457
+ # @param [String] fields
458
+ # Selector specifying which fields to include in a partial response.
459
+ # @param [Google::Apis::RequestOptions] options
460
+ # Request-specific options
461
+ #
462
+ # @yield [result, err] Result & error if block supplied
463
+ # @yieldparam result [Google::Apis::CloudbuildV1::Empty] parsed result object
464
+ # @yieldparam err [StandardError] error object if request failed
465
+ #
466
+ # @return [Google::Apis::CloudbuildV1::Empty]
467
+ #
468
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
469
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
470
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
471
+ def cancel_operation(name, cancel_operation_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
472
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
473
+ command.request_representation = Google::Apis::CloudbuildV1::CancelOperationRequest::Representation
474
+ command.request_object = cancel_operation_request_object
475
+ command.response_representation = Google::Apis::CloudbuildV1::Empty::Representation
476
+ command.response_class = Google::Apis::CloudbuildV1::Empty
477
+ command.params['name'] = name unless name.nil?
478
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
479
+ command.query['fields'] = fields unless fields.nil?
480
+ execute_or_queue_command(command, &block)
481
+ end
440
482
 
441
483
  protected
442
484
 
@@ -26,7 +26,7 @@ module Google
26
26
  # @see http://cloud.google.com/debugger
27
27
  module ClouddebuggerV2
28
28
  VERSION = 'V2'
29
- REVISION = '20160810'
29
+ REVISION = '20170117'
30
30
 
31
31
  # View and manage your data across Google Cloud Platform services
32
32
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -22,34 +22,11 @@ module Google
22
22
  module Apis
23
23
  module ClouddebuggerV2
24
24
 
25
- # Request to register a debuggee.
26
- class RegisterDebuggeeRequest
27
- include Google::Apis::Core::Hashable
28
-
29
- # Represents the application to debug. The application may include one or more
30
- # replicated processes executing the same code. Each of these processes is
31
- # attached with a debugger agent, carrying out the debugging commands. The
32
- # agents attached to the same debuggee are identified by using exactly the same
33
- # field values when registering.
34
- # Corresponds to the JSON property `debuggee`
35
- # @return [Google::Apis::ClouddebuggerV2::Debuggee]
36
- attr_accessor :debuggee
37
-
38
- def initialize(**args)
39
- update!(**args)
40
- end
41
-
42
- # Update properties of this object
43
- def update!(**args)
44
- @debuggee = args[:debuggee] if args.key?(:debuggee)
45
- end
46
- end
47
-
48
25
  # Represents the application to debug. The application may include one or more
49
26
  # replicated processes executing the same code. Each of these processes is
50
- # attached with a debugger agent, carrying out the debugging commands. The
51
- # agents attached to the same debuggee are identified by using exactly the same
52
- # field values when registering.
27
+ # attached with a debugger agent, carrying out the debugging commands.
28
+ # The agents attached to the same debuggee are identified by using exactly the
29
+ # same field values when registering.
53
30
  class Debuggee
54
31
  include Google::Apis::Core::Hashable
55
32
 
@@ -58,75 +35,80 @@ module Google
58
35
  # @return [String]
59
36
  attr_accessor :id
60
37
 
61
- # Project the debuggee is associated with. Use the project number when
62
- # registering a Google Cloud Platform project.
38
+ # Project the debuggee is associated with.
39
+ # Use the project number when registering a Google Cloud Platform project.
63
40
  # Corresponds to the JSON property `project`
64
41
  # @return [String]
65
42
  attr_accessor :project
66
43
 
67
- # Debuggee uniquifier within the project. Any string that identifies the
68
- # application within the project can be used. Including environment and version
69
- # or build IDs is recommended.
70
- # Corresponds to the JSON property `uniquifier`
71
- # @return [String]
72
- attr_accessor :uniquifier
44
+ # References to the locations and revisions of the source code used in the
45
+ # deployed application.
46
+ # Contexts describing a remote repo related to the source code
47
+ # have a `category` label of `remote_repo`. Source snapshot source
48
+ # contexts have a `category` of `snapshot`.
49
+ # Corresponds to the JSON property `extSourceContexts`
50
+ # @return [Array<Google::Apis::ClouddebuggerV2::ExtendedSourceContext>]
51
+ attr_accessor :ext_source_contexts
73
52
 
74
- # Human readable description of the debuggee. Including a human-readable project
75
- # name, environment name and version information is recommended.
53
+ # Human readable description of the debuggee.
54
+ # Including a human-readable project name, environment name and version
55
+ # information is recommended.
76
56
  # Corresponds to the JSON property `description`
77
57
  # @return [String]
78
58
  attr_accessor :description
79
59
 
80
- # If set to `true`, indicates that the debuggee is considered as inactive by the
81
- # Controller service.
60
+ # If set to `true`, indicates that the agent should disable itself and
61
+ # detach from the debuggee.
62
+ # Corresponds to the JSON property `isDisabled`
63
+ # @return [Boolean]
64
+ attr_accessor :is_disabled
65
+ alias_method :is_disabled?, :is_disabled
66
+
67
+ # Represents a contextual status message.
68
+ # The message can indicate an error or informational status, and refer to
69
+ # specific parts of the containing object.
70
+ # For example, the `Breakpoint.status` field can indicate an error referring
71
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
72
+ # Corresponds to the JSON property `status`
73
+ # @return [Google::Apis::ClouddebuggerV2::StatusMessage]
74
+ attr_accessor :status
75
+
76
+ # If set to `true`, indicates that the debuggee is considered as inactive by
77
+ # the Controller service.
82
78
  # Corresponds to the JSON property `isInactive`
83
79
  # @return [Boolean]
84
80
  attr_accessor :is_inactive
85
81
  alias_method :is_inactive?, :is_inactive
86
82
 
87
- # Version ID of the agent release. The version ID is structured as following: `
88
- # domain/type/vmajor.minor` (for example `google.com/gcp-java/v1.1`).
83
+ # Version ID of the agent release. The version ID is structured as
84
+ # following: `domain/type/vmajor.minor` (for example
85
+ # `google.com/gcp-java/v1.1`).
89
86
  # Corresponds to the JSON property `agentVersion`
90
87
  # @return [String]
91
88
  attr_accessor :agent_version
92
89
 
93
- # If set to `true`, indicates that the agent should disable itself and detach
94
- # from the debuggee.
95
- # Corresponds to the JSON property `isDisabled`
96
- # @return [Boolean]
97
- attr_accessor :is_disabled
98
- alias_method :is_disabled?, :is_disabled
90
+ # A set of custom debuggee properties, populated by the agent, to be
91
+ # displayed to the user.
92
+ # Corresponds to the JSON property `labels`
93
+ # @return [Hash<String,String>]
94
+ attr_accessor :labels
99
95
 
100
- # Represents a contextual status message. The message can indicate an error or
101
- # informational status, and refer to specific parts of the containing object.
102
- # For example, the `Breakpoint.status` field can indicate an error referring to
103
- # the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
104
- # Corresponds to the JSON property `status`
105
- # @return [Google::Apis::ClouddebuggerV2::StatusMessage]
106
- attr_accessor :status
96
+ # Debuggee uniquifier within the project.
97
+ # Any string that identifies the application within the project can be used.
98
+ # Including environment and version or build IDs is recommended.
99
+ # Corresponds to the JSON property `uniquifier`
100
+ # @return [String]
101
+ attr_accessor :uniquifier
107
102
 
108
103
  # References to the locations and revisions of the source code used in the
109
- # deployed application. NOTE: This field is deprecated. Consumers should use `
110
- # ext_source_contexts` if it is not empty. Debug agents should populate both
111
- # this field and `ext_source_contexts`.
104
+ # deployed application.
105
+ # NOTE: This field is deprecated. Consumers should use
106
+ # `ext_source_contexts` if it is not empty. Debug agents should populate
107
+ # both this field and `ext_source_contexts`.
112
108
  # Corresponds to the JSON property `sourceContexts`
113
109
  # @return [Array<Google::Apis::ClouddebuggerV2::SourceContext>]
114
110
  attr_accessor :source_contexts
115
111
 
116
- # References to the locations and revisions of the source code used in the
117
- # deployed application. Contexts describing a remote repo related to the source
118
- # code have a `category` label of `remote_repo`. Source snapshot source contexts
119
- # have a `category` of `snapshot`.
120
- # Corresponds to the JSON property `extSourceContexts`
121
- # @return [Array<Google::Apis::ClouddebuggerV2::ExtendedSourceContext>]
122
- attr_accessor :ext_source_contexts
123
-
124
- # A set of custom debuggee properties, populated by the agent, to be displayed
125
- # to the user.
126
- # Corresponds to the JSON property `labels`
127
- # @return [Hash<String,String>]
128
- attr_accessor :labels
129
-
130
112
  def initialize(**args)
131
113
  update!(**args)
132
114
  end
@@ -135,40 +117,43 @@ module Google
135
117
  def update!(**args)
136
118
  @id = args[:id] if args.key?(:id)
137
119
  @project = args[:project] if args.key?(:project)
138
- @uniquifier = args[:uniquifier] if args.key?(:uniquifier)
120
+ @ext_source_contexts = args[:ext_source_contexts] if args.key?(:ext_source_contexts)
139
121
  @description = args[:description] if args.key?(:description)
140
- @is_inactive = args[:is_inactive] if args.key?(:is_inactive)
141
- @agent_version = args[:agent_version] if args.key?(:agent_version)
142
122
  @is_disabled = args[:is_disabled] if args.key?(:is_disabled)
143
123
  @status = args[:status] if args.key?(:status)
144
- @source_contexts = args[:source_contexts] if args.key?(:source_contexts)
145
- @ext_source_contexts = args[:ext_source_contexts] if args.key?(:ext_source_contexts)
124
+ @is_inactive = args[:is_inactive] if args.key?(:is_inactive)
125
+ @agent_version = args[:agent_version] if args.key?(:agent_version)
146
126
  @labels = args[:labels] if args.key?(:labels)
127
+ @uniquifier = args[:uniquifier] if args.key?(:uniquifier)
128
+ @source_contexts = args[:source_contexts] if args.key?(:source_contexts)
147
129
  end
148
130
  end
149
131
 
150
- # Represents a contextual status message. The message can indicate an error or
151
- # informational status, and refer to specific parts of the containing object.
152
- # For example, the `Breakpoint.status` field can indicate an error referring to
153
- # the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
154
- class StatusMessage
132
+ # Represents a stack frame context.
133
+ class StackFrame
155
134
  include Google::Apis::Core::Hashable
156
135
 
157
- # Distinguishes errors from informational messages.
158
- # Corresponds to the JSON property `isError`
159
- # @return [Boolean]
160
- attr_accessor :is_error
161
- alias_method :is_error?, :is_error
136
+ # Set of local variables at the stack frame location.
137
+ # Note that this might not be populated for all stack frames.
138
+ # Corresponds to the JSON property `locals`
139
+ # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
140
+ attr_accessor :locals
162
141
 
163
- # Reference to which the message applies.
164
- # Corresponds to the JSON property `refersTo`
142
+ # Demangled function name at the call site.
143
+ # Corresponds to the JSON property `function`
165
144
  # @return [String]
166
- attr_accessor :refers_to
145
+ attr_accessor :function
167
146
 
168
- # Represents a message with parameters.
169
- # Corresponds to the JSON property `description`
170
- # @return [Google::Apis::ClouddebuggerV2::FormatMessage]
171
- attr_accessor :description
147
+ # Represents a location in the source code.
148
+ # Corresponds to the JSON property `location`
149
+ # @return [Google::Apis::ClouddebuggerV2::SourceLocation]
150
+ attr_accessor :location
151
+
152
+ # Set of arguments passed to this function.
153
+ # Note that this might not be populated for all stack frames.
154
+ # Corresponds to the JSON property `arguments`
155
+ # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
156
+ attr_accessor :arguments
172
157
 
173
158
  def initialize(**args)
174
159
  update!(**args)
@@ -176,29 +161,30 @@ module Google
176
161
 
177
162
  # Update properties of this object
178
163
  def update!(**args)
179
- @is_error = args[:is_error] if args.key?(:is_error)
180
- @refers_to = args[:refers_to] if args.key?(:refers_to)
181
- @description = args[:description] if args.key?(:description)
164
+ @locals = args[:locals] if args.key?(:locals)
165
+ @function = args[:function] if args.key?(:function)
166
+ @location = args[:location] if args.key?(:location)
167
+ @arguments = args[:arguments] if args.key?(:arguments)
182
168
  end
183
169
  end
184
170
 
185
- # Represents a message with parameters.
186
- class FormatMessage
171
+ # Response for listing breakpoints.
172
+ class ListBreakpointsResponse
187
173
  include Google::Apis::Core::Hashable
188
174
 
189
- # Format template for the message. The `format` uses placeholders `$0`, `$1`,
190
- # etc. to reference parameters. `$$` can be used to denote the `$` character.
191
- # Examples: * `Failed to load '$0' which helps debug $1 the first time it is
192
- # loaded. Again, $0 is very important.` * `Please pay $$10 to use $0 instead of $
193
- # 1.`
194
- # Corresponds to the JSON property `format`
195
- # @return [String]
196
- attr_accessor :format
175
+ # List of breakpoints matching the request.
176
+ # The fields `id` and `location` are guaranteed to be set on each breakpoint.
177
+ # The fields: `stack_frames`, `evaluated_expressions` and `variable_table`
178
+ # are cleared on each breakpoint regardless of it's status.
179
+ # Corresponds to the JSON property `breakpoints`
180
+ # @return [Array<Google::Apis::ClouddebuggerV2::Breakpoint>]
181
+ attr_accessor :breakpoints
197
182
 
198
- # Optional parameters to be embedded into the message.
199
- # Corresponds to the JSON property `parameters`
200
- # @return [Array<String>]
201
- attr_accessor :parameters
183
+ # A wait token that can be used in the next call to `list` (REST) or
184
+ # `ListBreakpoints` (RPC) to block until the list of breakpoints has changes.
185
+ # Corresponds to the JSON property `nextWaitToken`
186
+ # @return [String]
187
+ attr_accessor :next_wait_token
202
188
 
203
189
  def initialize(**args)
204
190
  update!(**args)
@@ -206,37 +192,134 @@ module Google
206
192
 
207
193
  # Update properties of this object
208
194
  def update!(**args)
209
- @format = args[:format] if args.key?(:format)
210
- @parameters = args[:parameters] if args.key?(:parameters)
195
+ @breakpoints = args[:breakpoints] if args.key?(:breakpoints)
196
+ @next_wait_token = args[:next_wait_token] if args.key?(:next_wait_token)
211
197
  end
212
198
  end
213
199
 
214
- # A SourceContext is a reference to a tree of files. A SourceContext together
215
- # with a path point to a unique revision of a single file or directory.
216
- class SourceContext
200
+ # Represents a variable or an argument possibly of a compound object type.
201
+ # Note how the following variables are represented:
202
+ # 1) A simple variable:
203
+ # int x = 5
204
+ # ` name: "x", value: "5", type: "int" ` // Captured variable
205
+ # 2) A compound object:
206
+ # struct T `
207
+ # int m1;
208
+ # int m2;
209
+ # `;
210
+ # T x = ` 3, 7 `;
211
+ # ` // Captured variable
212
+ # name: "x",
213
+ # type: "T",
214
+ # members ` name: "m1", value: "3", type: "int" `,
215
+ # members ` name: "m2", value: "7", type: "int" `
216
+ # `
217
+ # 3) A pointer where the pointee was captured:
218
+ # T x = ` 3, 7 `;
219
+ # T* p = &x;
220
+ # ` // Captured variable
221
+ # name: "p",
222
+ # type: "T*",
223
+ # value: "0x00500500",
224
+ # members ` name: "m1", value: "3", type: "int" `,
225
+ # members ` name: "m2", value: "7", type: "int" `
226
+ # `
227
+ # 4) A pointer where the pointee was not captured:
228
+ # T* p = new T;
229
+ # ` // Captured variable
230
+ # name: "p",
231
+ # type: "T*",
232
+ # value: "0x00400400"
233
+ # status ` is_error: true, description ` format: "unavailable" ` `
234
+ # `
235
+ # The status should describe the reason for the missing value,
236
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
237
+ # Note that a null pointer should not have members.
238
+ # 5) An unnamed value:
239
+ # int* p = new int(7);
240
+ # ` // Captured variable
241
+ # name: "p",
242
+ # value: "0x00500500",
243
+ # type: "int*",
244
+ # members ` value: "7", type: "int" ` `
245
+ # 6) An unnamed pointer where the pointee was not captured:
246
+ # int* p = new int(7);
247
+ # int** pp = &p;
248
+ # ` // Captured variable
249
+ # name: "pp",
250
+ # value: "0x00500500",
251
+ # type: "int**",
252
+ # members `
253
+ # value: "0x00400400",
254
+ # type: "int*"
255
+ # status `
256
+ # is_error: true,
257
+ # description: ` format: "unavailable" ` `
258
+ # `
259
+ # `
260
+ # `
261
+ # To optimize computation, memory and network traffic, variables that
262
+ # repeat in the output multiple times can be stored once in a shared
263
+ # variable table and be referenced using the `var_table_index` field. The
264
+ # variables stored in the shared table are nameless and are essentially
265
+ # a partition of the complete variable. To reconstruct the complete
266
+ # variable, merge the referencing variable with the referenced variable.
267
+ # When using the shared variable table, the following variables:
268
+ # T x = ` 3, 7 `;
269
+ # T* p = &x;
270
+ # T& r = x;
271
+ # ` name: "x", var_table_index: 3, type: "T" ` // Captured variables
272
+ # ` name: "p", value "0x00500500", type="T*", var_table_index: 3 `
273
+ # ` name: "r", type="T&", var_table_index: 3 `
274
+ # ` // Shared variable table entry #3:
275
+ # members ` name: "m1", value: "3", type: "int" `,
276
+ # members ` name: "m2", value: "7", type: "int" `
277
+ # `
278
+ # Note that the pointer address is stored with the referencing variable
279
+ # and not with the referenced variable. This allows the referenced variable
280
+ # to be shared between pointers and references.
281
+ # The type field is optional. The debugger agent may or may not support it.
282
+ class Variable
217
283
  include Google::Apis::Core::Hashable
218
284
 
219
- # A CloudRepoSourceContext denotes a particular revision in a cloud repo (a repo
220
- # hosted by the Google Cloud Platform).
221
- # Corresponds to the JSON property `cloudRepo`
222
- # @return [Google::Apis::ClouddebuggerV2::CloudRepoSourceContext]
223
- attr_accessor :cloud_repo
285
+ # Reference to a variable in the shared variable table. More than
286
+ # one variable can reference the same variable in the table. The
287
+ # `var_table_index` field is an index into `variable_table` in Breakpoint.
288
+ # Corresponds to the JSON property `varTableIndex`
289
+ # @return [Fixnum]
290
+ attr_accessor :var_table_index
224
291
 
225
- # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot.
226
- # Corresponds to the JSON property `cloudWorkspace`
227
- # @return [Google::Apis::ClouddebuggerV2::CloudWorkspaceSourceContext]
228
- attr_accessor :cloud_workspace
292
+ # Represents a contextual status message.
293
+ # The message can indicate an error or informational status, and refer to
294
+ # specific parts of the containing object.
295
+ # For example, the `Breakpoint.status` field can indicate an error referring
296
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
297
+ # Corresponds to the JSON property `status`
298
+ # @return [Google::Apis::ClouddebuggerV2::StatusMessage]
299
+ attr_accessor :status
229
300
 
230
- # A SourceContext referring to a Gerrit project.
231
- # Corresponds to the JSON property `gerrit`
232
- # @return [Google::Apis::ClouddebuggerV2::GerritSourceContext]
233
- attr_accessor :gerrit
301
+ # Members contained or pointed to by the variable.
302
+ # Corresponds to the JSON property `members`
303
+ # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
304
+ attr_accessor :members
234
305
 
235
- # A GitSourceContext denotes a particular revision in a third party Git
236
- # repository (e.g. GitHub).
237
- # Corresponds to the JSON property `git`
238
- # @return [Google::Apis::ClouddebuggerV2::GitSourceContext]
239
- attr_accessor :git
306
+ # Name of the variable, if any.
307
+ # Corresponds to the JSON property `name`
308
+ # @return [String]
309
+ attr_accessor :name
310
+
311
+ # Simple value of the variable.
312
+ # Corresponds to the JSON property `value`
313
+ # @return [String]
314
+ attr_accessor :value
315
+
316
+ # Variable type (e.g. `MyClass`). If the variable is split with
317
+ # `var_table_index`, `type` goes next to `value`. The interpretation of
318
+ # a type is agent specific. It is recommended to include the dynamic type
319
+ # rather than a static type of an object.
320
+ # Corresponds to the JSON property `type`
321
+ # @return [String]
322
+ attr_accessor :type
240
323
 
241
324
  def initialize(**args)
242
325
  update!(**args)
@@ -244,27 +327,48 @@ module Google
244
327
 
245
328
  # Update properties of this object
246
329
  def update!(**args)
247
- @cloud_repo = args[:cloud_repo] if args.key?(:cloud_repo)
248
- @cloud_workspace = args[:cloud_workspace] if args.key?(:cloud_workspace)
249
- @gerrit = args[:gerrit] if args.key?(:gerrit)
250
- @git = args[:git] if args.key?(:git)
330
+ @var_table_index = args[:var_table_index] if args.key?(:var_table_index)
331
+ @status = args[:status] if args.key?(:status)
332
+ @members = args[:members] if args.key?(:members)
333
+ @name = args[:name] if args.key?(:name)
334
+ @value = args[:value] if args.key?(:value)
335
+ @type = args[:type] if args.key?(:type)
251
336
  end
252
337
  end
253
338
 
254
- # A CloudRepoSourceContext denotes a particular revision in a cloud repo (a repo
255
- # hosted by the Google Cloud Platform).
256
- class CloudRepoSourceContext
339
+ # Represents a location in the source code.
340
+ class SourceLocation
257
341
  include Google::Apis::Core::Hashable
258
342
 
259
- # A unique identifier for a cloud repo.
260
- # Corresponds to the JSON property `repoId`
261
- # @return [Google::Apis::ClouddebuggerV2::RepoId]
262
- attr_accessor :repo_id
343
+ # Path to the source file within the source context of the target binary.
344
+ # Corresponds to the JSON property `path`
345
+ # @return [String]
346
+ attr_accessor :path
263
347
 
264
- # A revision ID.
265
- # Corresponds to the JSON property `revisionId`
348
+ # Line inside the file. The first line in the file has the value `1`.
349
+ # Corresponds to the JSON property `line`
350
+ # @return [Fixnum]
351
+ attr_accessor :line
352
+
353
+ def initialize(**args)
354
+ update!(**args)
355
+ end
356
+
357
+ # Update properties of this object
358
+ def update!(**args)
359
+ @path = args[:path] if args.key?(:path)
360
+ @line = args[:line] if args.key?(:line)
361
+ end
362
+ end
363
+
364
+ # A SourceContext referring to a Gerrit project.
365
+ class GerritSourceContext
366
+ include Google::Apis::Core::Hashable
367
+
368
+ # The URI of a running Gerrit instance.
369
+ # Corresponds to the JSON property `hostUri`
266
370
  # @return [String]
267
- attr_accessor :revision_id
371
+ attr_accessor :host_uri
268
372
 
269
373
  # The name of an alias (branch, tag, etc.).
270
374
  # Corresponds to the JSON property `aliasName`
@@ -276,33 +380,51 @@ module Google
276
380
  # @return [Google::Apis::ClouddebuggerV2::AliasContext]
277
381
  attr_accessor :alias_context
278
382
 
383
+ # The full project name within the host. Projects may be nested, so
384
+ # "project/subproject" is a valid project name.
385
+ # The "repo name" is hostURI/project.
386
+ # Corresponds to the JSON property `gerritProject`
387
+ # @return [String]
388
+ attr_accessor :gerrit_project
389
+
390
+ # A revision (commit) ID.
391
+ # Corresponds to the JSON property `revisionId`
392
+ # @return [String]
393
+ attr_accessor :revision_id
394
+
279
395
  def initialize(**args)
280
396
  update!(**args)
281
397
  end
282
398
 
283
399
  # Update properties of this object
284
400
  def update!(**args)
285
- @repo_id = args[:repo_id] if args.key?(:repo_id)
286
- @revision_id = args[:revision_id] if args.key?(:revision_id)
401
+ @host_uri = args[:host_uri] if args.key?(:host_uri)
287
402
  @alias_name = args[:alias_name] if args.key?(:alias_name)
288
403
  @alias_context = args[:alias_context] if args.key?(:alias_context)
404
+ @gerrit_project = args[:gerrit_project] if args.key?(:gerrit_project)
405
+ @revision_id = args[:revision_id] if args.key?(:revision_id)
289
406
  end
290
407
  end
291
408
 
292
- # A unique identifier for a cloud repo.
293
- class RepoId
409
+ # Represents a message with parameters.
410
+ class FormatMessage
294
411
  include Google::Apis::Core::Hashable
295
412
 
296
- # Selects a repo using a Google Cloud Platform project ID (e.g. winged-cargo-31)
297
- # and a repo name within that project.
298
- # Corresponds to the JSON property `projectRepoId`
299
- # @return [Google::Apis::ClouddebuggerV2::ProjectRepoId]
300
- attr_accessor :project_repo_id
413
+ # Optional parameters to be embedded into the message.
414
+ # Corresponds to the JSON property `parameters`
415
+ # @return [Array<String>]
416
+ attr_accessor :parameters
301
417
 
302
- # A server-assigned, globally unique identifier.
303
- # Corresponds to the JSON property `uid`
418
+ # Format template for the message. The `format` uses placeholders `$0`,
419
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
420
+ # character.
421
+ # Examples:
422
+ # * `Failed to load '$0' which helps debug $1 the first time it
423
+ # is loaded. Again, $0 is very important.`
424
+ # * `Please pay $$10 to use $0 instead of $1.`
425
+ # Corresponds to the JSON property `format`
304
426
  # @return [String]
305
- attr_accessor :uid
427
+ attr_accessor :format
306
428
 
307
429
  def initialize(**args)
308
430
  update!(**args)
@@ -310,25 +432,23 @@ module Google
310
432
 
311
433
  # Update properties of this object
312
434
  def update!(**args)
313
- @project_repo_id = args[:project_repo_id] if args.key?(:project_repo_id)
314
- @uid = args[:uid] if args.key?(:uid)
435
+ @parameters = args[:parameters] if args.key?(:parameters)
436
+ @format = args[:format] if args.key?(:format)
315
437
  end
316
438
  end
317
439
 
318
- # Selects a repo using a Google Cloud Platform project ID (e.g. winged-cargo-31)
319
- # and a repo name within that project.
320
- class ProjectRepoId
440
+ # Response for registering a debuggee.
441
+ class RegisterDebuggeeResponse
321
442
  include Google::Apis::Core::Hashable
322
443
 
323
- # The ID of the project.
324
- # Corresponds to the JSON property `projectId`
325
- # @return [String]
326
- attr_accessor :project_id
327
-
328
- # The name of the repo. Leave empty for the default repo.
329
- # Corresponds to the JSON property `repoName`
330
- # @return [String]
331
- attr_accessor :repo_name
444
+ # Represents the application to debug. The application may include one or more
445
+ # replicated processes executing the same code. Each of these processes is
446
+ # attached with a debugger agent, carrying out the debugging commands.
447
+ # The agents attached to the same debuggee are identified by using exactly the
448
+ # same field values when registering.
449
+ # Corresponds to the JSON property `debuggee`
450
+ # @return [Google::Apis::ClouddebuggerV2::Debuggee]
451
+ attr_accessor :debuggee
332
452
 
333
453
  def initialize(**args)
334
454
  update!(**args)
@@ -336,24 +456,18 @@ module Google
336
456
 
337
457
  # Update properties of this object
338
458
  def update!(**args)
339
- @project_id = args[:project_id] if args.key?(:project_id)
340
- @repo_name = args[:repo_name] if args.key?(:repo_name)
459
+ @debuggee = args[:debuggee] if args.key?(:debuggee)
341
460
  end
342
461
  end
343
462
 
344
- # An alias to a repo revision.
345
- class AliasContext
463
+ # Response for getting breakpoint information.
464
+ class GetBreakpointResponse
346
465
  include Google::Apis::Core::Hashable
347
466
 
348
- # The alias kind.
349
- # Corresponds to the JSON property `kind`
350
- # @return [String]
351
- attr_accessor :kind
352
-
353
- # The alias name.
354
- # Corresponds to the JSON property `name`
355
- # @return [String]
356
- attr_accessor :name
467
+ # Represents the breakpoint specification, status and results.
468
+ # Corresponds to the JSON property `breakpoint`
469
+ # @return [Google::Apis::ClouddebuggerV2::Breakpoint]
470
+ attr_accessor :breakpoint
357
471
 
358
472
  def initialize(**args)
359
473
  update!(**args)
@@ -361,27 +475,23 @@ module Google
361
475
 
362
476
  # Update properties of this object
363
477
  def update!(**args)
364
- @kind = args[:kind] if args.key?(:kind)
365
- @name = args[:name] if args.key?(:name)
478
+ @breakpoint = args[:breakpoint] if args.key?(:breakpoint)
366
479
  end
367
480
  end
368
481
 
369
- # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot.
370
- class CloudWorkspaceSourceContext
482
+ # An alias to a repo revision.
483
+ class AliasContext
371
484
  include Google::Apis::Core::Hashable
372
485
 
373
- # A CloudWorkspaceId is a unique identifier for a cloud workspace. A cloud
374
- # workspace is a place associated with a repo where modified files can be stored
375
- # before they are committed.
376
- # Corresponds to the JSON property `workspaceId`
377
- # @return [Google::Apis::ClouddebuggerV2::CloudWorkspaceId]
378
- attr_accessor :workspace_id
486
+ # The alias kind.
487
+ # Corresponds to the JSON property `kind`
488
+ # @return [String]
489
+ attr_accessor :kind
379
490
 
380
- # The ID of the snapshot. An empty snapshot_id refers to the most recent
381
- # snapshot.
382
- # Corresponds to the JSON property `snapshotId`
491
+ # The alias name.
492
+ # Corresponds to the JSON property `name`
383
493
  # @return [String]
384
- attr_accessor :snapshot_id
494
+ attr_accessor :name
385
495
 
386
496
  def initialize(**args)
387
497
  update!(**args)
@@ -389,14 +499,14 @@ module Google
389
499
 
390
500
  # Update properties of this object
391
501
  def update!(**args)
392
- @workspace_id = args[:workspace_id] if args.key?(:workspace_id)
393
- @snapshot_id = args[:snapshot_id] if args.key?(:snapshot_id)
502
+ @kind = args[:kind] if args.key?(:kind)
503
+ @name = args[:name] if args.key?(:name)
394
504
  end
395
505
  end
396
506
 
397
- # A CloudWorkspaceId is a unique identifier for a cloud workspace. A cloud
398
- # workspace is a place associated with a repo where modified files can be stored
399
- # before they are committed.
507
+ # A CloudWorkspaceId is a unique identifier for a cloud workspace.
508
+ # A cloud workspace is a place associated with a repo where modified files
509
+ # can be stored before they are committed.
400
510
  class CloudWorkspaceId
401
511
  include Google::Apis::Core::Hashable
402
512
 
@@ -405,8 +515,8 @@ module Google
405
515
  # @return [Google::Apis::ClouddebuggerV2::RepoId]
406
516
  attr_accessor :repo_id
407
517
 
408
- # The unique name of the workspace within the repo. This is the name chosen by
409
- # the client in the Source API's CreateWorkspace method.
518
+ # The unique name of the workspace within the repo. This is the name
519
+ # chosen by the client in the Source API's CreateWorkspace method.
410
520
  # Corresponds to the JSON property `name`
411
521
  # @return [String]
412
522
  attr_accessor :name
@@ -422,91 +532,125 @@ module Google
422
532
  end
423
533
  end
424
534
 
425
- # A SourceContext referring to a Gerrit project.
426
- class GerritSourceContext
535
+ # Represents the breakpoint specification, status and results.
536
+ class Breakpoint
427
537
  include Google::Apis::Core::Hashable
428
538
 
429
- # The URI of a running Gerrit instance.
430
- # Corresponds to the JSON property `hostUri`
539
+ # Breakpoint identifier, unique in the scope of the debuggee.
540
+ # Corresponds to the JSON property `id`
431
541
  # @return [String]
432
- attr_accessor :host_uri
542
+ attr_accessor :id
433
543
 
434
- # The full project name within the host. Projects may be nested, so "project/
435
- # subproject" is a valid project name. The "repo name" is hostURI/project.
436
- # Corresponds to the JSON property `gerritProject`
437
- # @return [String]
438
- attr_accessor :gerrit_project
544
+ # The stack at breakpoint time.
545
+ # Corresponds to the JSON property `stackFrames`
546
+ # @return [Array<Google::Apis::ClouddebuggerV2::StackFrame>]
547
+ attr_accessor :stack_frames
439
548
 
440
- # A revision (commit) ID.
441
- # Corresponds to the JSON property `revisionId`
442
- # @return [String]
443
- attr_accessor :revision_id
549
+ # Represents a location in the source code.
550
+ # Corresponds to the JSON property `location`
551
+ # @return [Google::Apis::ClouddebuggerV2::SourceLocation]
552
+ attr_accessor :location
444
553
 
445
- # The name of an alias (branch, tag, etc.).
446
- # Corresponds to the JSON property `aliasName`
554
+ # Represents a contextual status message.
555
+ # The message can indicate an error or informational status, and refer to
556
+ # specific parts of the containing object.
557
+ # For example, the `Breakpoint.status` field can indicate an error referring
558
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
559
+ # Corresponds to the JSON property `status`
560
+ # @return [Google::Apis::ClouddebuggerV2::StatusMessage]
561
+ attr_accessor :status
562
+
563
+ # E-mail address of the user that created this breakpoint
564
+ # Corresponds to the JSON property `userEmail`
447
565
  # @return [String]
448
- attr_accessor :alias_name
566
+ attr_accessor :user_email
449
567
 
450
- # An alias to a repo revision.
451
- # Corresponds to the JSON property `aliasContext`
452
- # @return [Google::Apis::ClouddebuggerV2::AliasContext]
453
- attr_accessor :alias_context
568
+ # Condition that triggers the breakpoint.
569
+ # The condition is a compound boolean expression composed using expressions
570
+ # in a programming language at the source location.
571
+ # Corresponds to the JSON property `condition`
572
+ # @return [String]
573
+ attr_accessor :condition
454
574
 
455
- def initialize(**args)
456
- update!(**args)
457
- end
575
+ # Time this breakpoint was finalized as seen by the server in seconds
576
+ # resolution.
577
+ # Corresponds to the JSON property `finalTime`
578
+ # @return [String]
579
+ attr_accessor :final_time
458
580
 
459
- # Update properties of this object
460
- def update!(**args)
461
- @host_uri = args[:host_uri] if args.key?(:host_uri)
462
- @gerrit_project = args[:gerrit_project] if args.key?(:gerrit_project)
463
- @revision_id = args[:revision_id] if args.key?(:revision_id)
464
- @alias_name = args[:alias_name] if args.key?(:alias_name)
465
- @alias_context = args[:alias_context] if args.key?(:alias_context)
466
- end
467
- end
581
+ # Action that the agent should perform when the code at the
582
+ # breakpoint location is hit.
583
+ # Corresponds to the JSON property `action`
584
+ # @return [String]
585
+ attr_accessor :action
468
586
 
469
- # A GitSourceContext denotes a particular revision in a third party Git
470
- # repository (e.g. GitHub).
471
- class GitSourceContext
472
- include Google::Apis::Core::Hashable
587
+ # A set of custom breakpoint properties, populated by the agent, to be
588
+ # displayed to the user.
589
+ # Corresponds to the JSON property `labels`
590
+ # @return [Hash<String,String>]
591
+ attr_accessor :labels
473
592
 
474
- # Git repository URL.
475
- # Corresponds to the JSON property `url`
593
+ # Only relevant when action is `LOG`. Defines the message to log when
594
+ # the breakpoint hits. The message may include parameter placeholders `$0`,
595
+ # `$1`, etc. These placeholders are replaced with the evaluated value
596
+ # of the appropriate expression. Expressions not referenced in
597
+ # `log_message_format` are not logged.
598
+ # Example: `Message received, id = $0, count = $1` with
599
+ # `expressions` = `[ message.id, message.count ]`.
600
+ # Corresponds to the JSON property `logMessageFormat`
476
601
  # @return [String]
477
- attr_accessor :url
602
+ attr_accessor :log_message_format
478
603
 
479
- # Git commit hash. required.
480
- # Corresponds to the JSON property `revisionId`
604
+ # Time this breakpoint was created by the server in seconds resolution.
605
+ # Corresponds to the JSON property `createTime`
481
606
  # @return [String]
482
- attr_accessor :revision_id
607
+ attr_accessor :create_time
483
608
 
484
- def initialize(**args)
485
- update!(**args)
486
- end
609
+ # Indicates the severity of the log. Only relevant when action is `LOG`.
610
+ # Corresponds to the JSON property `logLevel`
611
+ # @return [String]
612
+ attr_accessor :log_level
487
613
 
488
- # Update properties of this object
489
- def update!(**args)
490
- @url = args[:url] if args.key?(:url)
491
- @revision_id = args[:revision_id] if args.key?(:revision_id)
492
- end
493
- end
614
+ # Values of evaluated expressions at breakpoint time.
615
+ # The evaluated expressions appear in exactly the same order they
616
+ # are listed in the `expressions` field.
617
+ # The `name` field holds the original expression text, the `value` or
618
+ # `members` field holds the result of the evaluated expression.
619
+ # If the expression cannot be evaluated, the `status` inside the `Variable`
620
+ # will indicate an error and contain the error text.
621
+ # Corresponds to the JSON property `evaluatedExpressions`
622
+ # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
623
+ attr_accessor :evaluated_expressions
494
624
 
495
- # An ExtendedSourceContext is a SourceContext combined with additional details
496
- # describing the context.
497
- class ExtendedSourceContext
498
- include Google::Apis::Core::Hashable
625
+ # When true, indicates that this is a final result and the
626
+ # breakpoint state will not change from here on.
627
+ # Corresponds to the JSON property `isFinalState`
628
+ # @return [Boolean]
629
+ attr_accessor :is_final_state
630
+ alias_method :is_final_state?, :is_final_state
499
631
 
500
- # A SourceContext is a reference to a tree of files. A SourceContext together
501
- # with a path point to a unique revision of a single file or directory.
502
- # Corresponds to the JSON property `context`
503
- # @return [Google::Apis::ClouddebuggerV2::SourceContext]
504
- attr_accessor :context
632
+ # List of read-only expressions to evaluate at the breakpoint location.
633
+ # The expressions are composed using expressions in the programming language
634
+ # at the source location. If the breakpoint action is `LOG`, the evaluated
635
+ # expressions are included in log statements.
636
+ # Corresponds to the JSON property `expressions`
637
+ # @return [Array<String>]
638
+ attr_accessor :expressions
505
639
 
506
- # Labels with user defined metadata.
507
- # Corresponds to the JSON property `labels`
508
- # @return [Hash<String,String>]
509
- attr_accessor :labels
640
+ # The `variable_table` exists to aid with computation, memory and network
641
+ # traffic optimization. It enables storing a variable once and reference
642
+ # it from multiple variables, including variables stored in the
643
+ # `variable_table` itself.
644
+ # For example, the same `this` object, which may appear at many levels of
645
+ # the stack, can have all of its data stored once in this table. The
646
+ # stack frame variables then would hold only a reference to it.
647
+ # The variable `var_table_index` field is an index into this repeated field.
648
+ # The stored objects are nameless and get their name from the referencing
649
+ # variable. The effective variable is a merge of the referencing variable
650
+ # and the referenced variable.
651
+ # Corresponds to the JSON property `variableTable`
652
+ # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
653
+ attr_accessor :variable_table
510
654
 
511
655
  def initialize(**args)
512
656
  update!(**args)
@@ -514,23 +658,33 @@ module Google
514
658
 
515
659
  # Update properties of this object
516
660
  def update!(**args)
517
- @context = args[:context] if args.key?(:context)
661
+ @id = args[:id] if args.key?(:id)
662
+ @stack_frames = args[:stack_frames] if args.key?(:stack_frames)
663
+ @location = args[:location] if args.key?(:location)
664
+ @status = args[:status] if args.key?(:status)
665
+ @user_email = args[:user_email] if args.key?(:user_email)
666
+ @condition = args[:condition] if args.key?(:condition)
667
+ @final_time = args[:final_time] if args.key?(:final_time)
668
+ @action = args[:action] if args.key?(:action)
518
669
  @labels = args[:labels] if args.key?(:labels)
670
+ @log_message_format = args[:log_message_format] if args.key?(:log_message_format)
671
+ @create_time = args[:create_time] if args.key?(:create_time)
672
+ @log_level = args[:log_level] if args.key?(:log_level)
673
+ @evaluated_expressions = args[:evaluated_expressions] if args.key?(:evaluated_expressions)
674
+ @is_final_state = args[:is_final_state] if args.key?(:is_final_state)
675
+ @expressions = args[:expressions] if args.key?(:expressions)
676
+ @variable_table = args[:variable_table] if args.key?(:variable_table)
519
677
  end
520
678
  end
521
679
 
522
- # Response for registering a debuggee.
523
- class RegisterDebuggeeResponse
680
+ # Response for setting a breakpoint.
681
+ class SetBreakpointResponse
524
682
  include Google::Apis::Core::Hashable
525
683
 
526
- # Represents the application to debug. The application may include one or more
527
- # replicated processes executing the same code. Each of these processes is
528
- # attached with a debugger agent, carrying out the debugging commands. The
529
- # agents attached to the same debuggee are identified by using exactly the same
530
- # field values when registering.
531
- # Corresponds to the JSON property `debuggee`
532
- # @return [Google::Apis::ClouddebuggerV2::Debuggee]
533
- attr_accessor :debuggee
684
+ # Represents the breakpoint specification, status and results.
685
+ # Corresponds to the JSON property `breakpoint`
686
+ # @return [Google::Apis::ClouddebuggerV2::Breakpoint]
687
+ attr_accessor :breakpoint
534
688
 
535
689
  def initialize(**args)
536
690
  update!(**args)
@@ -538,7 +692,7 @@ module Google
538
692
 
539
693
  # Update properties of this object
540
694
  def update!(**args)
541
- @debuggee = args[:debuggee] if args.key?(:debuggee)
695
+ @breakpoint = args[:breakpoint] if args.key?(:breakpoint)
542
696
  end
543
697
  end
544
698
 
@@ -546,151 +700,76 @@ module Google
546
700
  class ListActiveBreakpointsResponse
547
701
  include Google::Apis::Core::Hashable
548
702
 
549
- # List of all active breakpoints. The fields `id` and `location` are guaranteed
550
- # to be set on each breakpoint.
703
+ # The `wait_expired` field is set to true by the server when the
704
+ # request times out and the field `success_on_timeout` is set to true.
705
+ # Corresponds to the JSON property `waitExpired`
706
+ # @return [Boolean]
707
+ attr_accessor :wait_expired
708
+ alias_method :wait_expired?, :wait_expired
709
+
710
+ # List of all active breakpoints.
711
+ # The fields `id` and `location` are guaranteed to be set on each breakpoint.
551
712
  # Corresponds to the JSON property `breakpoints`
552
713
  # @return [Array<Google::Apis::ClouddebuggerV2::Breakpoint>]
553
714
  attr_accessor :breakpoints
554
715
 
555
- # A wait token that can be used in the next method call to block until the list
556
- # of breakpoints changes.
716
+ # A wait token that can be used in the next method call to block until
717
+ # the list of breakpoints changes.
557
718
  # Corresponds to the JSON property `nextWaitToken`
558
719
  # @return [String]
559
720
  attr_accessor :next_wait_token
560
721
 
561
- # The `wait_expired` field is set to true by the server when the request times
562
- # out and the field `success_on_timeout` is set to true.
563
- # Corresponds to the JSON property `waitExpired`
564
- # @return [Boolean]
565
- attr_accessor :wait_expired
566
- alias_method :wait_expired?, :wait_expired
567
-
568
722
  def initialize(**args)
569
723
  update!(**args)
570
724
  end
571
725
 
572
726
  # Update properties of this object
573
727
  def update!(**args)
728
+ @wait_expired = args[:wait_expired] if args.key?(:wait_expired)
574
729
  @breakpoints = args[:breakpoints] if args.key?(:breakpoints)
575
730
  @next_wait_token = args[:next_wait_token] if args.key?(:next_wait_token)
576
- @wait_expired = args[:wait_expired] if args.key?(:wait_expired)
577
731
  end
578
732
  end
579
733
 
580
- # Represents the breakpoint specification, status and results.
581
- class Breakpoint
734
+ # An ExtendedSourceContext is a SourceContext combined with additional
735
+ # details describing the context.
736
+ class ExtendedSourceContext
582
737
  include Google::Apis::Core::Hashable
583
738
 
584
- # Breakpoint identifier, unique in the scope of the debuggee.
585
- # Corresponds to the JSON property `id`
586
- # @return [String]
587
- attr_accessor :id
588
-
589
- # Action that the agent should perform when the code at the breakpoint location
590
- # is hit.
591
- # Corresponds to the JSON property `action`
592
- # @return [String]
593
- attr_accessor :action
594
-
595
- # Represents a location in the source code.
596
- # Corresponds to the JSON property `location`
597
- # @return [Google::Apis::ClouddebuggerV2::SourceLocation]
598
- attr_accessor :location
599
-
600
- # Condition that triggers the breakpoint. The condition is a compound boolean
601
- # expression composed using expressions in a programming language at the source
602
- # location.
603
- # Corresponds to the JSON property `condition`
604
- # @return [String]
605
- attr_accessor :condition
606
-
607
- # List of read-only expressions to evaluate at the breakpoint location. The
608
- # expressions are composed using expressions in the programming language at the
609
- # source location. If the breakpoint action is `LOG`, the evaluated expressions
610
- # are included in log statements.
611
- # Corresponds to the JSON property `expressions`
612
- # @return [Array<String>]
613
- attr_accessor :expressions
614
-
615
- # Only relevant when action is `LOG`. Defines the message to log when the
616
- # breakpoint hits. The message may include parameter placeholders `$0`, `$1`,
617
- # etc. These placeholders are replaced with the evaluated value of the
618
- # appropriate expression. Expressions not referenced in `log_message_format` are
619
- # not logged. Example: `Message received, id = $0, count = $1` with `expressions`
620
- # = `[ message.id, message.count ]`.
621
- # Corresponds to the JSON property `logMessageFormat`
622
- # @return [String]
623
- attr_accessor :log_message_format
624
-
625
- # Indicates the severity of the log. Only relevant when action is `LOG`.
626
- # Corresponds to the JSON property `logLevel`
627
- # @return [String]
628
- attr_accessor :log_level
629
-
630
- # When true, indicates that this is a final result and the breakpoint state will
631
- # not change from here on.
632
- # Corresponds to the JSON property `isFinalState`
633
- # @return [Boolean]
634
- attr_accessor :is_final_state
635
- alias_method :is_final_state?, :is_final_state
636
-
637
- # Time this breakpoint was created by the server in seconds resolution.
638
- # Corresponds to the JSON property `createTime`
639
- # @return [String]
640
- attr_accessor :create_time
641
-
642
- # Time this breakpoint was finalized as seen by the server in seconds resolution.
643
- # Corresponds to the JSON property `finalTime`
644
- # @return [String]
645
- attr_accessor :final_time
646
-
647
- # E-mail address of the user that created this breakpoint
648
- # Corresponds to the JSON property `userEmail`
649
- # @return [String]
650
- attr_accessor :user_email
651
-
652
- # Represents a contextual status message. The message can indicate an error or
653
- # informational status, and refer to specific parts of the containing object.
654
- # For example, the `Breakpoint.status` field can indicate an error referring to
655
- # the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
656
- # Corresponds to the JSON property `status`
657
- # @return [Google::Apis::ClouddebuggerV2::StatusMessage]
658
- attr_accessor :status
739
+ # Labels with user defined metadata.
740
+ # Corresponds to the JSON property `labels`
741
+ # @return [Hash<String,String>]
742
+ attr_accessor :labels
659
743
 
660
- # The stack at breakpoint time.
661
- # Corresponds to the JSON property `stackFrames`
662
- # @return [Array<Google::Apis::ClouddebuggerV2::StackFrame>]
663
- attr_accessor :stack_frames
744
+ # A SourceContext is a reference to a tree of files. A SourceContext together
745
+ # with a path point to a unique revision of a single file or directory.
746
+ # Corresponds to the JSON property `context`
747
+ # @return [Google::Apis::ClouddebuggerV2::SourceContext]
748
+ attr_accessor :context
664
749
 
665
- # Values of evaluated expressions at breakpoint time. The evaluated expressions
666
- # appear in exactly the same order they are listed in the `expressions` field.
667
- # The `name` field holds the original expression text, the `value` or `members`
668
- # field holds the result of the evaluated expression. If the expression cannot
669
- # be evaluated, the `status` inside the `Variable` will indicate an error and
670
- # contain the error text.
671
- # Corresponds to the JSON property `evaluatedExpressions`
672
- # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
673
- attr_accessor :evaluated_expressions
750
+ def initialize(**args)
751
+ update!(**args)
752
+ end
674
753
 
675
- # The `variable_table` exists to aid with computation, memory and network
676
- # traffic optimization. It enables storing a variable once and reference it from
677
- # multiple variables, including variables stored in the `variable_table` itself.
678
- # For example, the same `this` object, which may appear at many levels of the
679
- # stack, can have all of its data stored once in this table. The stack frame
680
- # variables then would hold only a reference to it. The variable `
681
- # var_table_index` field is an index into this repeated field. The stored
682
- # objects are nameless and get their name from the referencing variable. The
683
- # effective variable is a merge of the referencing variable and the referenced
684
- # variable.
685
- # Corresponds to the JSON property `variableTable`
686
- # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
687
- attr_accessor :variable_table
754
+ # Update properties of this object
755
+ def update!(**args)
756
+ @labels = args[:labels] if args.key?(:labels)
757
+ @context = args[:context] if args.key?(:context)
758
+ end
759
+ end
688
760
 
689
- # A set of custom breakpoint properties, populated by the agent, to be displayed
690
- # to the user.
691
- # Corresponds to the JSON property `labels`
692
- # @return [Hash<String,String>]
693
- attr_accessor :labels
761
+ # Request to register a debuggee.
762
+ class RegisterDebuggeeRequest
763
+ include Google::Apis::Core::Hashable
764
+
765
+ # Represents the application to debug. The application may include one or more
766
+ # replicated processes executing the same code. Each of these processes is
767
+ # attached with a debugger agent, carrying out the debugging commands.
768
+ # The agents attached to the same debuggee are identified by using exactly the
769
+ # same field values when registering.
770
+ # Corresponds to the JSON property `debuggee`
771
+ # @return [Google::Apis::ClouddebuggerV2::Debuggee]
772
+ attr_accessor :debuggee
694
773
 
695
774
  def initialize(**args)
696
775
  update!(**args)
@@ -698,38 +777,24 @@ module Google
698
777
 
699
778
  # Update properties of this object
700
779
  def update!(**args)
701
- @id = args[:id] if args.key?(:id)
702
- @action = args[:action] if args.key?(:action)
703
- @location = args[:location] if args.key?(:location)
704
- @condition = args[:condition] if args.key?(:condition)
705
- @expressions = args[:expressions] if args.key?(:expressions)
706
- @log_message_format = args[:log_message_format] if args.key?(:log_message_format)
707
- @log_level = args[:log_level] if args.key?(:log_level)
708
- @is_final_state = args[:is_final_state] if args.key?(:is_final_state)
709
- @create_time = args[:create_time] if args.key?(:create_time)
710
- @final_time = args[:final_time] if args.key?(:final_time)
711
- @user_email = args[:user_email] if args.key?(:user_email)
712
- @status = args[:status] if args.key?(:status)
713
- @stack_frames = args[:stack_frames] if args.key?(:stack_frames)
714
- @evaluated_expressions = args[:evaluated_expressions] if args.key?(:evaluated_expressions)
715
- @variable_table = args[:variable_table] if args.key?(:variable_table)
716
- @labels = args[:labels] if args.key?(:labels)
780
+ @debuggee = args[:debuggee] if args.key?(:debuggee)
717
781
  end
718
782
  end
719
783
 
720
- # Represents a location in the source code.
721
- class SourceLocation
784
+ # A unique identifier for a cloud repo.
785
+ class RepoId
722
786
  include Google::Apis::Core::Hashable
723
787
 
724
- # Path to the source file within the source context of the target binary.
725
- # Corresponds to the JSON property `path`
726
- # @return [String]
727
- attr_accessor :path
788
+ # Selects a repo using a Google Cloud Platform project ID
789
+ # (e.g. winged-cargo-31) and a repo name within that project.
790
+ # Corresponds to the JSON property `projectRepoId`
791
+ # @return [Google::Apis::ClouddebuggerV2::ProjectRepoId]
792
+ attr_accessor :project_repo_id
728
793
 
729
- # Line inside the file. The first line in the file has the value `1`.
730
- # Corresponds to the JSON property `line`
731
- # @return [Fixnum]
732
- attr_accessor :line
794
+ # A server-assigned, globally unique identifier.
795
+ # Corresponds to the JSON property `uid`
796
+ # @return [String]
797
+ attr_accessor :uid
733
798
 
734
799
  def initialize(**args)
735
800
  update!(**args)
@@ -737,36 +802,25 @@ module Google
737
802
 
738
803
  # Update properties of this object
739
804
  def update!(**args)
740
- @path = args[:path] if args.key?(:path)
741
- @line = args[:line] if args.key?(:line)
805
+ @project_repo_id = args[:project_repo_id] if args.key?(:project_repo_id)
806
+ @uid = args[:uid] if args.key?(:uid)
742
807
  end
743
808
  end
744
809
 
745
- # Represents a stack frame context.
746
- class StackFrame
810
+ # Selects a repo using a Google Cloud Platform project ID
811
+ # (e.g. winged-cargo-31) and a repo name within that project.
812
+ class ProjectRepoId
747
813
  include Google::Apis::Core::Hashable
748
814
 
749
- # Demangled function name at the call site.
750
- # Corresponds to the JSON property `function`
815
+ # The name of the repo. Leave empty for the default repo.
816
+ # Corresponds to the JSON property `repoName`
751
817
  # @return [String]
752
- attr_accessor :function
753
-
754
- # Represents a location in the source code.
755
- # Corresponds to the JSON property `location`
756
- # @return [Google::Apis::ClouddebuggerV2::SourceLocation]
757
- attr_accessor :location
758
-
759
- # Set of arguments passed to this function. Note that this might not be
760
- # populated for all stack frames.
761
- # Corresponds to the JSON property `arguments`
762
- # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
763
- attr_accessor :arguments
818
+ attr_accessor :repo_name
764
819
 
765
- # Set of local variables at the stack frame location. Note that this might not
766
- # be populated for all stack frames.
767
- # Corresponds to the JSON property `locals`
768
- # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
769
- attr_accessor :locals
820
+ # The ID of the project.
821
+ # Corresponds to the JSON property `projectId`
822
+ # @return [String]
823
+ attr_accessor :project_id
770
824
 
771
825
  def initialize(**args)
772
826
  update!(**args)
@@ -774,86 +828,27 @@ module Google
774
828
 
775
829
  # Update properties of this object
776
830
  def update!(**args)
777
- @function = args[:function] if args.key?(:function)
778
- @location = args[:location] if args.key?(:location)
779
- @arguments = args[:arguments] if args.key?(:arguments)
780
- @locals = args[:locals] if args.key?(:locals)
831
+ @repo_name = args[:repo_name] if args.key?(:repo_name)
832
+ @project_id = args[:project_id] if args.key?(:project_id)
781
833
  end
782
834
  end
783
835
 
784
- # Represents a variable or an argument possibly of a compound object type. Note
785
- # how the following variables are represented: 1) A simple variable: int x = 5 `
786
- # name: "x", value: "5", type: "int" ` // Captured variable 2) A compound object:
787
- # struct T ` int m1; int m2; `; T x = ` 3, 7 `; ` // Captured variable name: "x"
788
- # , type: "T", members ` name: "m1", value: "3", type: "int" `, members ` name: "
789
- # m2", value: "7", type: "int" ` ` 3) A pointer where the pointee was captured:
790
- # T x = ` 3, 7 `; T* p = &x; ` // Captured variable name: "p", type: "T*", value:
791
- # "0x00500500", members ` name: "m1", value: "3", type: "int" `, members ` name:
792
- # "m2", value: "7", type: "int" ` ` 4) A pointer where the pointee was not
793
- # captured: T* p = new T; ` // Captured variable name: "p", type: "T*", value: "
794
- # 0x00400400" status ` is_error: true, description ` format: "unavailable" ` ` `
795
- # The status should describe the reason for the missing value, such as ``, ``, `
796
- # `. Note that a null pointer should not have members. 5) An unnamed value: int*
797
- # p = new int(7); ` // Captured variable name: "p", value: "0x00500500", type: "
798
- # int*", members ` value: "7", type: "int" ` ` 6) An unnamed pointer where the
799
- # pointee was not captured: int* p = new int(7); int** pp = &p; ` // Captured
800
- # variable name: "pp", value: "0x00500500", type: "int**", members ` value: "
801
- # 0x00400400", type: "int*" status ` is_error: true, description: ` format: "
802
- # unavailable" ` ` ` ` ` To optimize computation, memory and network traffic,
803
- # variables that repeat in the output multiple times can be stored once in a
804
- # shared variable table and be referenced using the `var_table_index` field. The
805
- # variables stored in the shared table are nameless and are essentially a
806
- # partition of the complete variable. To reconstruct the complete variable,
807
- # merge the referencing variable with the referenced variable. When using the
808
- # shared variable table, the following variables: T x = ` 3, 7 `; T* p = &x; T&
809
- # r = x; ` name: "x", var_table_index: 3, type: "T" ` // Captured variables `
810
- # name: "p", value "0x00500500", type="T*", var_table_index: 3 ` ` name: "r",
811
- # type="T&", var_table_index: 3 ` ` // Shared variable table entry #3: members `
812
- # name: "m1", value: "3", type: "int" `, members ` name: "m2", value: "7", type:
813
- # "int" ` ` Note that the pointer address is stored with the referencing
814
- # variable and not with the referenced variable. This allows the referenced
815
- # variable to be shared between pointers and references. The type field is
816
- # optional. The debugger agent may or may not support it.
817
- class Variable
836
+ # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot.
837
+ class CloudWorkspaceSourceContext
818
838
  include Google::Apis::Core::Hashable
819
839
 
820
- # Name of the variable, if any.
821
- # Corresponds to the JSON property `name`
822
- # @return [String]
823
- attr_accessor :name
824
-
825
- # Simple value of the variable.
826
- # Corresponds to the JSON property `value`
827
- # @return [String]
828
- attr_accessor :value
829
-
830
- # Variable type (e.g. `MyClass`). If the variable is split with `var_table_index`
831
- # , `type` goes next to `value`. The interpretation of a type is agent specific.
832
- # It is recommended to include the dynamic type rather than a static type of an
833
- # object.
834
- # Corresponds to the JSON property `type`
840
+ # The ID of the snapshot.
841
+ # An empty snapshot_id refers to the most recent snapshot.
842
+ # Corresponds to the JSON property `snapshotId`
835
843
  # @return [String]
836
- attr_accessor :type
837
-
838
- # Members contained or pointed to by the variable.
839
- # Corresponds to the JSON property `members`
840
- # @return [Array<Google::Apis::ClouddebuggerV2::Variable>]
841
- attr_accessor :members
842
-
843
- # Reference to a variable in the shared variable table. More than one variable
844
- # can reference the same variable in the table. The `var_table_index` field is
845
- # an index into `variable_table` in Breakpoint.
846
- # Corresponds to the JSON property `varTableIndex`
847
- # @return [Fixnum]
848
- attr_accessor :var_table_index
844
+ attr_accessor :snapshot_id
849
845
 
850
- # Represents a contextual status message. The message can indicate an error or
851
- # informational status, and refer to specific parts of the containing object.
852
- # For example, the `Breakpoint.status` field can indicate an error referring to
853
- # the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
854
- # Corresponds to the JSON property `status`
855
- # @return [Google::Apis::ClouddebuggerV2::StatusMessage]
856
- attr_accessor :status
846
+ # A CloudWorkspaceId is a unique identifier for a cloud workspace.
847
+ # A cloud workspace is a place associated with a repo where modified files
848
+ # can be stored before they are committed.
849
+ # Corresponds to the JSON property `workspaceId`
850
+ # @return [Google::Apis::ClouddebuggerV2::CloudWorkspaceId]
851
+ attr_accessor :workspace_id
857
852
 
858
853
  def initialize(**args)
859
854
  update!(**args)
@@ -861,23 +856,23 @@ module Google
861
856
 
862
857
  # Update properties of this object
863
858
  def update!(**args)
864
- @name = args[:name] if args.key?(:name)
865
- @value = args[:value] if args.key?(:value)
866
- @type = args[:type] if args.key?(:type)
867
- @members = args[:members] if args.key?(:members)
868
- @var_table_index = args[:var_table_index] if args.key?(:var_table_index)
869
- @status = args[:status] if args.key?(:status)
859
+ @snapshot_id = args[:snapshot_id] if args.key?(:snapshot_id)
860
+ @workspace_id = args[:workspace_id] if args.key?(:workspace_id)
870
861
  end
871
862
  end
872
863
 
873
- # Request to update an active breakpoint.
874
- class UpdateActiveBreakpointRequest
864
+ # Response for listing debuggees.
865
+ class ListDebuggeesResponse
875
866
  include Google::Apis::Core::Hashable
876
867
 
877
- # Represents the breakpoint specification, status and results.
878
- # Corresponds to the JSON property `breakpoint`
879
- # @return [Google::Apis::ClouddebuggerV2::Breakpoint]
880
- attr_accessor :breakpoint
868
+ # List of debuggees accessible to the calling user.
869
+ # Note that the `description` field is the only human readable field
870
+ # that should be displayed to the user.
871
+ # The fields `debuggee.id` and `description` fields are guaranteed to be
872
+ # set on each debuggee.
873
+ # Corresponds to the JSON property `debuggees`
874
+ # @return [Array<Google::Apis::ClouddebuggerV2::Debuggee>]
875
+ attr_accessor :debuggees
881
876
 
882
877
  def initialize(**args)
883
878
  update!(**args)
@@ -885,26 +880,50 @@ module Google
885
880
 
886
881
  # Update properties of this object
887
882
  def update!(**args)
888
- @breakpoint = args[:breakpoint] if args.key?(:breakpoint)
883
+ @debuggees = args[:debuggees] if args.key?(:debuggees)
889
884
  end
890
885
  end
891
886
 
892
- # Response for updating an active breakpoint. The message is defined to allow
893
- # future extensions.
894
- class UpdateActiveBreakpointResponse
887
+ # A CloudRepoSourceContext denotes a particular revision in a cloud
888
+ # repo (a repo hosted by the Google Cloud Platform).
889
+ class CloudRepoSourceContext
895
890
  include Google::Apis::Core::Hashable
896
891
 
892
+ # The name of an alias (branch, tag, etc.).
893
+ # Corresponds to the JSON property `aliasName`
894
+ # @return [String]
895
+ attr_accessor :alias_name
896
+
897
+ # An alias to a repo revision.
898
+ # Corresponds to the JSON property `aliasContext`
899
+ # @return [Google::Apis::ClouddebuggerV2::AliasContext]
900
+ attr_accessor :alias_context
901
+
902
+ # A unique identifier for a cloud repo.
903
+ # Corresponds to the JSON property `repoId`
904
+ # @return [Google::Apis::ClouddebuggerV2::RepoId]
905
+ attr_accessor :repo_id
906
+
907
+ # A revision ID.
908
+ # Corresponds to the JSON property `revisionId`
909
+ # @return [String]
910
+ attr_accessor :revision_id
911
+
897
912
  def initialize(**args)
898
913
  update!(**args)
899
914
  end
900
915
 
901
916
  # Update properties of this object
902
917
  def update!(**args)
918
+ @alias_name = args[:alias_name] if args.key?(:alias_name)
919
+ @alias_context = args[:alias_context] if args.key?(:alias_context)
920
+ @repo_id = args[:repo_id] if args.key?(:repo_id)
921
+ @revision_id = args[:revision_id] if args.key?(:revision_id)
903
922
  end
904
923
  end
905
924
 
906
- # Response for setting a breakpoint.
907
- class SetBreakpointResponse
925
+ # Request to update an active breakpoint.
926
+ class UpdateActiveBreakpointRequest
908
927
  include Google::Apis::Core::Hashable
909
928
 
910
929
  # Represents the breakpoint specification, status and results.
@@ -922,14 +941,32 @@ module Google
922
941
  end
923
942
  end
924
943
 
925
- # Response for getting breakpoint information.
926
- class GetBreakpointResponse
944
+ # A SourceContext is a reference to a tree of files. A SourceContext together
945
+ # with a path point to a unique revision of a single file or directory.
946
+ class SourceContext
927
947
  include Google::Apis::Core::Hashable
928
948
 
929
- # Represents the breakpoint specification, status and results.
930
- # Corresponds to the JSON property `breakpoint`
931
- # @return [Google::Apis::ClouddebuggerV2::Breakpoint]
932
- attr_accessor :breakpoint
949
+ # A CloudRepoSourceContext denotes a particular revision in a cloud
950
+ # repo (a repo hosted by the Google Cloud Platform).
951
+ # Corresponds to the JSON property `cloudRepo`
952
+ # @return [Google::Apis::ClouddebuggerV2::CloudRepoSourceContext]
953
+ attr_accessor :cloud_repo
954
+
955
+ # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot.
956
+ # Corresponds to the JSON property `cloudWorkspace`
957
+ # @return [Google::Apis::ClouddebuggerV2::CloudWorkspaceSourceContext]
958
+ attr_accessor :cloud_workspace
959
+
960
+ # A GitSourceContext denotes a particular revision in a third party Git
961
+ # repository (e.g. GitHub).
962
+ # Corresponds to the JSON property `git`
963
+ # @return [Google::Apis::ClouddebuggerV2::GitSourceContext]
964
+ attr_accessor :git
965
+
966
+ # A SourceContext referring to a Gerrit project.
967
+ # Corresponds to the JSON property `gerrit`
968
+ # @return [Google::Apis::ClouddebuggerV2::GerritSourceContext]
969
+ attr_accessor :gerrit
933
970
 
934
971
  def initialize(**args)
935
972
  update!(**args)
@@ -937,15 +974,20 @@ module Google
937
974
 
938
975
  # Update properties of this object
939
976
  def update!(**args)
940
- @breakpoint = args[:breakpoint] if args.key?(:breakpoint)
977
+ @cloud_repo = args[:cloud_repo] if args.key?(:cloud_repo)
978
+ @cloud_workspace = args[:cloud_workspace] if args.key?(:cloud_workspace)
979
+ @git = args[:git] if args.key?(:git)
980
+ @gerrit = args[:gerrit] if args.key?(:gerrit)
941
981
  end
942
982
  end
943
983
 
944
- # A generic empty message that you can re-use to avoid defining duplicated empty
945
- # messages in your APIs. A typical example is to use it as the request or the
946
- # response type of an API method. For instance: service Foo ` rpc Bar(google.
947
- # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
948
- # `Empty` is empty JSON object ````.
984
+ # A generic empty message that you can re-use to avoid defining duplicated
985
+ # empty messages in your APIs. A typical example is to use it as the request
986
+ # or the response type of an API method. For instance:
987
+ # service Foo `
988
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
989
+ # `
990
+ # The JSON representation for `Empty` is empty JSON object ````.
949
991
  class Empty
950
992
  include Google::Apis::Core::Hashable
951
993
 
@@ -958,21 +1000,21 @@ module Google
958
1000
  end
959
1001
  end
960
1002
 
961
- # Response for listing breakpoints.
962
- class ListBreakpointsResponse
1003
+ # A GitSourceContext denotes a particular revision in a third party Git
1004
+ # repository (e.g. GitHub).
1005
+ class GitSourceContext
963
1006
  include Google::Apis::Core::Hashable
964
1007
 
965
- # List of all breakpoints with complete state. The fields `id` and `location`
966
- # are guaranteed to be set on each breakpoint.
967
- # Corresponds to the JSON property `breakpoints`
968
- # @return [Array<Google::Apis::ClouddebuggerV2::Breakpoint>]
969
- attr_accessor :breakpoints
1008
+ # Git repository URL.
1009
+ # Corresponds to the JSON property `url`
1010
+ # @return [String]
1011
+ attr_accessor :url
970
1012
 
971
- # A wait token that can be used in the next call to `list` (REST) or `
972
- # ListBreakpoints` (RPC) to block until the list of breakpoints has changes.
973
- # Corresponds to the JSON property `nextWaitToken`
1013
+ # Git commit hash.
1014
+ # required.
1015
+ # Corresponds to the JSON property `revisionId`
974
1016
  # @return [String]
975
- attr_accessor :next_wait_token
1017
+ attr_accessor :revision_id
976
1018
 
977
1019
  def initialize(**args)
978
1020
  update!(**args)
@@ -980,22 +1022,51 @@ module Google
980
1022
 
981
1023
  # Update properties of this object
982
1024
  def update!(**args)
983
- @breakpoints = args[:breakpoints] if args.key?(:breakpoints)
984
- @next_wait_token = args[:next_wait_token] if args.key?(:next_wait_token)
1025
+ @url = args[:url] if args.key?(:url)
1026
+ @revision_id = args[:revision_id] if args.key?(:revision_id)
985
1027
  end
986
1028
  end
987
1029
 
988
- # Response for listing debuggees.
989
- class ListDebuggeesResponse
1030
+ # Represents a contextual status message.
1031
+ # The message can indicate an error or informational status, and refer to
1032
+ # specific parts of the containing object.
1033
+ # For example, the `Breakpoint.status` field can indicate an error referring
1034
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
1035
+ class StatusMessage
990
1036
  include Google::Apis::Core::Hashable
991
1037
 
992
- # List of debuggees accessible to the calling user. Note that the `description`
993
- # field is the only human readable field that should be displayed to the user.
994
- # The fields `debuggee.id` and `description` fields are guaranteed to be set on
995
- # each debuggee.
996
- # Corresponds to the JSON property `debuggees`
997
- # @return [Array<Google::Apis::ClouddebuggerV2::Debuggee>]
998
- attr_accessor :debuggees
1038
+ # Distinguishes errors from informational messages.
1039
+ # Corresponds to the JSON property `isError`
1040
+ # @return [Boolean]
1041
+ attr_accessor :is_error
1042
+ alias_method :is_error?, :is_error
1043
+
1044
+ # Represents a message with parameters.
1045
+ # Corresponds to the JSON property `description`
1046
+ # @return [Google::Apis::ClouddebuggerV2::FormatMessage]
1047
+ attr_accessor :description
1048
+
1049
+ # Reference to which the message applies.
1050
+ # Corresponds to the JSON property `refersTo`
1051
+ # @return [String]
1052
+ attr_accessor :refers_to
1053
+
1054
+ def initialize(**args)
1055
+ update!(**args)
1056
+ end
1057
+
1058
+ # Update properties of this object
1059
+ def update!(**args)
1060
+ @is_error = args[:is_error] if args.key?(:is_error)
1061
+ @description = args[:description] if args.key?(:description)
1062
+ @refers_to = args[:refers_to] if args.key?(:refers_to)
1063
+ end
1064
+ end
1065
+
1066
+ # Response for updating an active breakpoint.
1067
+ # The message is defined to allow future extensions.
1068
+ class UpdateActiveBreakpointResponse
1069
+ include Google::Apis::Core::Hashable
999
1070
 
1000
1071
  def initialize(**args)
1001
1072
  update!(**args)
@@ -1003,7 +1074,6 @@ module Google
1003
1074
 
1004
1075
  # Update properties of this object
1005
1076
  def update!(**args)
1006
- @debuggees = args[:debuggees] if args.key?(:debuggees)
1007
1077
  end
1008
1078
  end
1009
1079
  end