google-api-client 0.9.20 → 0.9.21

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