RubyGems - google-cloud-debugger - Versions diffs - 0.32.1 → 0.32.2 - Mend

google-cloud-debugger 0.32.1 → 0.32.2

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 (19) hide show

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b7ed1274bf5cea538b50035f9ce20d8dd442229cf891ab55feaac18af6e5bf0
-  data.tar.gz: a635a7b21556d84b9b1f4ce3809e0d6b4465ebb7a7d8371d38c62bb51479c800
+  metadata.gz: c284cd24cb8878c64aa43c984273d0e898fabe94611fd832a29df638ff3ce331
+  data.tar.gz: aeac4adb53d4421316d7b2b9bb46e23b7c37227c4fe0c08461115fff73316d15
 SHA512:
-  metadata.gz: df72382f398676edfc3703ac5294b21f1db461f8e80d104d9afe63cfa86aea1b686e94f5b9e9f8aaa14f826a0719c96d2618d6cc65560f56370d04cf9220c827
-  data.tar.gz: ab85c6aa805fb1b884b49a887ad3f2ffa3ed2ed7666cdff9e997de886e8b1a06e52dc4dcbee8c808e21bb8acf62c6f83f253835b327841c283bd9e6d72247dcd
+  metadata.gz: 330dddc3afa46c30eaab89bb51020588842105921a0d8a742b26b3c60b863382c69ace755087a2e334b6998090a91df0017d94af29c5f05159f2354cad027208
+  data.tar.gz: 96778f50ba64a4ac516180870534944fd30b217a721047d6415b9adb7583ad18bd3a195a36dc6221e63e5990fa085705022bb9cf2c8309d0932fc7e2193c420b

data/.yardopts CHANGED

@@ -1,7 +1,8 @@
 --no-private
 --title=Stackdriver Debugger
---exclude lib/google/devtools
+--exclude _pb\.rb$
 --markup markdown
+--markup-provider redcarpet
 ./lib/**/*.rb
 -

data/README.md CHANGED

@@ -246,14 +246,14 @@ end
 ## Supported Ruby Versions
-This library is supported on Ruby 2.2 or later.
-However, Ruby 2.3 or later is strongly recommended, as earlier releases have
-reached or are nearing end-of-life. After June 1, 2018, Google will provide
-official support only for Ruby versions that are considered current and
-supported by Ruby Core (that is, Ruby versions that are either in normal
-maintenance or in security maintenance).
-See https://www.ruby-lang.org/en/downloads/branches/ for further details.
+This library is supported on Ruby 2.3+.
+Google provides official support for Ruby versions that are actively supported
+by Ruby Core—that is, Ruby versions that are either in normal maintenance or
+in security maintenance, and not end of life. Currently, this means Ruby 2.3
+and later. Older versions of Ruby _may_ still work, but are unsupported and not
+recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
+about the Ruby support schedule.
 This library follows [Semantic Versioning](http://semver.org/). It is currently
 in major version zero (0.y.z), which means that anything may change at any time

data/lib/google/cloud/debugger/credentials.rb CHANGED

@@ -13,7 +13,7 @@
 # limitations under the License.
-require "googleauth"
+require "google/cloud/debugger/v2/credentials"
 require "google/cloud/logging/credentials"
 module Google
@@ -38,21 +38,9 @@ module Google
       #
       #   debugger.project_id #=> "my-project"
       #
-      class Credentials < Google::Auth::Credentials
-        SCOPE = (["https://www.googleapis.com/auth/cloud_debugger"] +
-                 Google::Cloud::Logging::Credentials::SCOPE).freeze
-        PATH_ENV_VARS = %w[DEBUGGER_CREDENTIALS
-                           GOOGLE_CLOUD_CREDENTIALS
-                           DEBUGGER_KEYFILE
-                           GOOGLE_CLOUD_KEYFILE
-                           GCLOUD_KEYFILE].freeze
-        JSON_ENV_VARS = %w[DEBUGGER_CREDENTIALS_JSON
-                           GOOGLE_CLOUD_CREDENTIALS_JSON
-                           DEBUGGER_KEYFILE_JSON
-                           GOOGLE_CLOUD_KEYFILE_JSON
-                           GCLOUD_KEYFILE_JSON].freeze
-        DEFAULT_PATHS = \
-          ["~/.config/gcloud/application_default_credentials.json"].freeze
+      class Credentials < Google::Cloud::Debugger::V2::Credentials
+        SCOPE = (Google::Cloud::Debugger::V2::Credentials::SCOPE +
+                 Google::Cloud::Logging::Credentials::SCOPE).uniq.freeze
       end
     end
   end

data/lib/google/cloud/debugger/v2.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -17,34 +17,60 @@ require "google/cloud/debugger/v2/controller2_client"
 module Google
   module Cloud
-    # rubocop:disable LineLength
-    ##
-    # # Ruby Client for Stackdriver Debugger API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
-    #
-    # [Stackdriver Debugger API][Product Documentation]:
-    # Examines the call stack and variables of a running application
-    # without stopping or slowing it down.
-    # - [Product Documentation][]
-    #
-    # ## Quick Start
-    # In order to use this library, you first need to go through the following
-    # steps:
-    #
-    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-    # 2. [Enable the Stackdriver Debugger API.](https://console.cloud.google.com/apis/api/debugger)
-    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-    #
-    # ### Next Steps
-    # - Read the [Stackdriver Debugger API Product documentation][Product Documentation]
-    #   to learn more about the product and see How-to Guides.
-    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
-    #   to see the full list of Cloud APIs that we cover.
-    #
-    # [Product Documentation]: https://cloud.google.com/debugger
-    #
-    #
     module Debugger
+      # rubocop:disable LineLength
+      ##
+      # # Ruby Client for Stackdriver Debugger API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+      #
+      # [Stackdriver Debugger API][Product Documentation]:
+      # Examines the call stack and variables of a running application
+      # without stopping or slowing it down.
+      # - [Product Documentation][]
+      #
+      # ## Quick Start
+      # In order to use this library, you first need to go through the following
+      # steps:
+      #
+      # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+      # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+      # 3. [Enable the Stackdriver Debugger API.](https://console.cloud.google.com/apis/library/clouddebugger.googleapis.com)
+      # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+      #
+      # ### Next Steps
+      # - Read the [Stackdriver Debugger API Product documentation][Product Documentation]
+      #   to learn more about the product and see How-to Guides.
+      # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+      #   to see the full list of Cloud APIs that we cover.
+      #
+      # [Product Documentation]: https://cloud.google.com/debugger
+      #
+      # ## Enabling Logging
+      #
+      # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+      # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+      # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+      # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+      # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+      #
+      # Configuring a Ruby stdlib logger:
+      #
+      # ```ruby
+      # require "logger"
+      #
+      # module MyLogger
+      #   LOGGER = Logger.new $stderr, level: Logger::WARN
+      #   def logger
+      #     LOGGER
+      #   end
+      # end
+      #
+      # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+      # module GRPC
+      #   extend MyLogger
+      # end
+      # ```
+      #
       module V2
         # rubocop:enable LineLength
@@ -87,28 +113,27 @@ module Google
           #   or the specified config is missing data points.
           # @param timeout [Numeric]
           #   The default timeout, in seconds, for calls made through this client.
+          # @param metadata [Hash]
+          #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param exception_transformer [Proc]
+          #   An optional proc that intercepts any exceptions raised during an API call to inject
+          #   custom error handling.
           def self.new \
-              service_path: nil,
-              port: nil,
-              channel: nil,
-              chan_creds: nil,
-              updater_proc: nil,
               credentials: nil,
               scopes: nil,
               client_config: nil,
               timeout: nil,
+              metadata: nil,
+              exception_transformer: nil,
               lib_name: nil,
               lib_version: nil
             kwargs = {
-              service_path: service_path,
-              port: port,
-              channel: channel,
-              chan_creds: chan_creds,
-              updater_proc: updater_proc,
               credentials: credentials,
               scopes: scopes,
               client_config: client_config,
               timeout: timeout,
+              metadata: metadata,
+              exception_transformer: exception_transformer,
               lib_name: lib_name,
               lib_version: lib_version
             }.select { |_, v| v != nil }
@@ -163,28 +188,27 @@ module Google
           #   or the specified config is missing data points.
           # @param timeout [Numeric]
           #   The default timeout, in seconds, for calls made through this client.
+          # @param metadata [Hash]
+          #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param exception_transformer [Proc]
+          #   An optional proc that intercepts any exceptions raised during an API call to inject
+          #   custom error handling.
           def self.new \
-              service_path: nil,
-              port: nil,
-              channel: nil,
-              chan_creds: nil,
-              updater_proc: nil,
               credentials: nil,
               scopes: nil,
               client_config: nil,
               timeout: nil,
+              metadata: nil,
+              exception_transformer: nil,
               lib_name: nil,
               lib_version: nil
             kwargs = {
-              service_path: service_path,
-              port: port,
-              channel: channel,
-              chan_creds: chan_creds,
-              updater_proc: updater_proc,
               credentials: credentials,
               scopes: scopes,
               client_config: client_config,
               timeout: timeout,
+              metadata: metadata,
+              exception_transformer: exception_transformer,
               lib_name: lib_name,
               lib_version: lib_version
             }.select { |_, v| v != nil }

data/lib/google/cloud/debugger/v2/controller2_client.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -18,9 +18,6 @@
 # and updates to that file get reflected here through a refresh process.
 # For the short term, the refresh process will only be runnable by Google
 # engineers.
-#
-# The only allowed edits are to method and file documentation. A 3-way
-# merge preserves those additions if the generated source changes.
 require "json"
 require "pathname"
@@ -28,7 +25,7 @@ require "pathname"
 require "google/gax"
 require "google/devtools/clouddebugger/v2/controller_pb"
-require "google/cloud/debugger/credentials"
+require "google/cloud/debugger/v2/credentials"
 module Google
   module Cloud
@@ -66,6 +63,9 @@ module Google
           # The default port of the service.
           DEFAULT_SERVICE_PORT = 443
+          # The default set of gRPC interceptors.
+          GRPC_INTERCEPTORS = []
           DEFAULT_TIMEOUT = 30
           # The scopes needed to make gRPC calls to all of the methods defined in
@@ -75,6 +75,7 @@ module Google
             "https://www.googleapis.com/auth/cloud_debugger"
           ].freeze
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -99,16 +100,18 @@ module Google
           #   or the specified config is missing data points.
           # @param timeout [Numeric]
           #   The default timeout, in seconds, for calls made through this client.
+          # @param metadata [Hash]
+          #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param exception_transformer [Proc]
+          #   An optional proc that intercepts any exceptions raised during an API call to inject
+          #   custom error handling.
           def initialize \
-              service_path: SERVICE_ADDRESS,
-              port: DEFAULT_SERVICE_PORT,
-              channel: nil,
-              chan_creds: nil,
-              updater_proc: nil,
               credentials: nil,
               scopes: ALL_SCOPES,
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
+              metadata: nil,
+              exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
             # These require statements are intentionally placed here to initialize
@@ -117,21 +120,10 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouddebugger/v2/controller_services_pb"
-            if channel || chan_creds || updater_proc
-              warn "The `channel`, `chan_creds`, and `updater_proc` parameters will be removed " \
-                "on 2017/09/08"
-              credentials ||= channel
-              credentials ||= chan_creds
-              credentials ||= updater_proc
-            end
-            if service_path != SERVICE_ADDRESS || port != DEFAULT_SERVICE_PORT
-              warn "`service_path` and `port` parameters are deprecated and will be removed"
-            end
-            credentials ||= Google::Cloud::Debugger::Credentials.default
+            credentials ||= Google::Cloud::Debugger::V2::Credentials.default
             if credentials.is_a?(String) || credentials.is_a?(Hash)
-              updater_proc = Google::Cloud::Debugger::Credentials.new(credentials).updater_proc
+              updater_proc = Google::Cloud::Debugger::V2::Credentials.new(credentials).updater_proc
             end
             if credentials.is_a?(GRPC::Core::Channel)
               channel = credentials
@@ -146,13 +138,16 @@ module Google
               updater_proc = credentials.updater_proc
             end
+            package_version = Gem.loaded_specs['google-cloud-debugger'].version.version
             google_api_client = "gl-ruby/#{RUBY_VERSION}"
             google_api_client << " #{lib_name}/#{lib_version}" if lib_name
-            google_api_client << " gapic/0.1.0 gax/#{Google::Gax::VERSION}"
+            google_api_client << " gapic/#{package_version} gax/#{Google::Gax::VERSION}"
             google_api_client << " grpc/#{GRPC::VERSION}"
             google_api_client.freeze
             headers = { :"x-goog-api-client" => google_api_client }
+            headers.merge!(metadata) unless metadata.nil?
             client_config_file = Pathname.new(__dir__).join(
               "controller2_client_config.json"
             )
@@ -164,9 +159,14 @@ module Google
                 Google::Gax::Grpc::STATUS_CODE_NAMES,
                 timeout,
                 errors: Google::Gax::Grpc::API_ERRORS,
-                kwargs: headers
+                metadata: headers
               )
             end
+            # Allow overriding the service path/port in subclasses.
+            service_path = self.class::SERVICE_ADDRESS
+            port = self.class::DEFAULT_SERVICE_PORT
+            interceptors = self.class::GRPC_INTERCEPTORS
             @controller2_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
@@ -174,20 +174,24 @@ module Google
               channel: channel,
               updater_proc: updater_proc,
               scopes: scopes,
+              interceptors: interceptors,
               &Google::Devtools::Clouddebugger::V2::Controller2::Stub.method(:new)
             )
             @register_debuggee = Google::Gax.create_api_call(
               @controller2_stub.method(:register_debuggee),
-              defaults["register_debuggee"]
+              defaults["register_debuggee"],
+              exception_transformer: exception_transformer
             )
             @list_active_breakpoints = Google::Gax.create_api_call(
               @controller2_stub.method(:list_active_breakpoints),
-              defaults["list_active_breakpoints"]
+              defaults["list_active_breakpoints"],
+              exception_transformer: exception_transformer
             )
             @update_active_breakpoint = Google::Gax.create_api_call(
               @controller2_stub.method(:update_active_breakpoint),
-              defaults["update_active_breakpoint"]
+              defaults["update_active_breakpoint"],
+              exception_transformer: exception_transformer
             )
           end
@@ -213,23 +217,29 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Devtools::Clouddebugger::V2::RegisterDebuggeeResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouddebugger::V2::RegisterDebuggeeResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   controller2_client = Google::Cloud::Debugger::V2::Controller2.new
+          #
+          #   # TODO: Initialize +debuggee+:
           #   debuggee = {}
           #   response = controller2_client.register_debuggee(debuggee)
           def register_debuggee \
               debuggee,
-              options: nil
+              options: nil,
+              &block
             req = {
               debuggee: debuggee
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::RegisterDebuggeeRequest)
-            @register_debuggee.call(req, options)
+            @register_debuggee.call(req, options, &block)
           end
           # Returns the list of all active breakpoints for the debuggee.
@@ -263,12 +273,17 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Devtools::Clouddebugger::V2::ListActiveBreakpointsResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouddebugger::V2::ListActiveBreakpointsResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   controller2_client = Google::Cloud::Debugger::V2::Controller2.new
+          #
+          #   # TODO: Initialize +debuggee_id+:
           #   debuggee_id = ''
           #   response = controller2_client.list_active_breakpoints(debuggee_id)
@@ -276,14 +291,15 @@ module Google
               debuggee_id,
               wait_token: nil,
               success_on_timeout: nil,
-              options: nil
+              options: nil,
+              &block
             req = {
               debuggee_id: debuggee_id,
               wait_token: wait_token,
               success_on_timeout: success_on_timeout
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::ListActiveBreakpointsRequest)
-            @list_active_breakpoints.call(req, options)
+            @list_active_breakpoints.call(req, options, &block)
           end
           # Updates the breakpoint state or mutable fields.
@@ -306,26 +322,34 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   controller2_client = Google::Cloud::Debugger::V2::Controller2.new
+          #
+          #   # TODO: Initialize +debuggee_id+:
           #   debuggee_id = ''
+          #
+          #   # TODO: Initialize +breakpoint+:
           #   breakpoint = {}
           #   response = controller2_client.update_active_breakpoint(debuggee_id, breakpoint)
           def update_active_breakpoint \
               debuggee_id,
               breakpoint,
-              options: nil
+              options: nil,
+              &block
             req = {
               debuggee_id: debuggee_id,
               breakpoint: breakpoint
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::UpdateActiveBreakpointRequest)
-            @update_active_breakpoint.call(req, options)
+            @update_active_breakpoint.call(req, options, &block)
           end
         end
       end

data/lib/google/cloud/debugger/v2/credentials.rb ADDED

@@ -0,0 +1,41 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+require "googleauth"
+module Google
+  module Cloud
+    module Debugger
+      module V2
+        class Credentials < Google::Auth::Credentials
+          SCOPE = [
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/cloud_debugger"
+          ].freeze
+          PATH_ENV_VARS = %w(DEBUGGER_CREDENTIALS
+                             DEBUGGER_KEYFILE
+                             GOOGLE_CLOUD_CREDENTIALS
+                             GOOGLE_CLOUD_KEYFILE
+                             GCLOUD_KEYFILE)
+          JSON_ENV_VARS = %w(DEBUGGER_CREDENTIALS_JSON
+                             DEBUGGER_KEYFILE_JSON
+                             GOOGLE_CLOUD_CREDENTIALS_JSON
+                             GOOGLE_CLOUD_KEYFILE_JSON
+                             GCLOUD_KEYFILE_JSON)
+          DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/debugger/v2/debugger2_client.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -18,9 +18,6 @@
 # and updates to that file get reflected here through a refresh process.
 # For the short term, the refresh process will only be runnable by Google
 # engineers.
-#
-# The only allowed edits are to method and file documentation. A 3-way
-# merge preserves those additions if the generated source changes.
 require "json"
 require "pathname"
@@ -28,7 +25,7 @@ require "pathname"
 require "google/gax"
 require "google/devtools/clouddebugger/v2/debugger_pb"
-require "google/cloud/debugger/credentials"
+require "google/cloud/debugger/v2/credentials"
 module Google
   module Cloud
@@ -58,6 +55,9 @@ module Google
           # The default port of the service.
           DEFAULT_SERVICE_PORT = 443
+          # The default set of gRPC interceptors.
+          GRPC_INTERCEPTORS = []
           DEFAULT_TIMEOUT = 30
           # The scopes needed to make gRPC calls to all of the methods defined in
@@ -67,6 +67,7 @@ module Google
             "https://www.googleapis.com/auth/cloud_debugger"
           ].freeze
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -91,16 +92,18 @@ module Google
           #   or the specified config is missing data points.
           # @param timeout [Numeric]
           #   The default timeout, in seconds, for calls made through this client.
+          # @param metadata [Hash]
+          #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param exception_transformer [Proc]
+          #   An optional proc that intercepts any exceptions raised during an API call to inject
+          #   custom error handling.
           def initialize \
-              service_path: SERVICE_ADDRESS,
-              port: DEFAULT_SERVICE_PORT,
-              channel: nil,
-              chan_creds: nil,
-              updater_proc: nil,
               credentials: nil,
               scopes: ALL_SCOPES,
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
+              metadata: nil,
+              exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
             # These require statements are intentionally placed here to initialize
@@ -109,21 +112,10 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouddebugger/v2/debugger_services_pb"
-            if channel || chan_creds || updater_proc
-              warn "The `channel`, `chan_creds`, and `updater_proc` parameters will be removed " \
-                "on 2017/09/08"
-              credentials ||= channel
-              credentials ||= chan_creds
-              credentials ||= updater_proc
-            end
-            if service_path != SERVICE_ADDRESS || port != DEFAULT_SERVICE_PORT
-              warn "`service_path` and `port` parameters are deprecated and will be removed"
-            end
-            credentials ||= Google::Cloud::Debugger::Credentials.default
+            credentials ||= Google::Cloud::Debugger::V2::Credentials.default
             if credentials.is_a?(String) || credentials.is_a?(Hash)
-              updater_proc = Google::Cloud::Debugger::Credentials.new(credentials).updater_proc
+              updater_proc = Google::Cloud::Debugger::V2::Credentials.new(credentials).updater_proc
             end
             if credentials.is_a?(GRPC::Core::Channel)
               channel = credentials
@@ -138,13 +130,16 @@ module Google
               updater_proc = credentials.updater_proc
             end
+            package_version = Gem.loaded_specs['google-cloud-debugger'].version.version
             google_api_client = "gl-ruby/#{RUBY_VERSION}"
             google_api_client << " #{lib_name}/#{lib_version}" if lib_name
-            google_api_client << " gapic/0.1.0 gax/#{Google::Gax::VERSION}"
+            google_api_client << " gapic/#{package_version} gax/#{Google::Gax::VERSION}"
             google_api_client << " grpc/#{GRPC::VERSION}"
             google_api_client.freeze
             headers = { :"x-goog-api-client" => google_api_client }
+            headers.merge!(metadata) unless metadata.nil?
             client_config_file = Pathname.new(__dir__).join(
               "debugger2_client_config.json"
             )
@@ -156,9 +151,14 @@ module Google
                 Google::Gax::Grpc::STATUS_CODE_NAMES,
                 timeout,
                 errors: Google::Gax::Grpc::API_ERRORS,
-                kwargs: headers
+                metadata: headers
               )
             end
+            # Allow overriding the service path/port in subclasses.
+            service_path = self.class::SERVICE_ADDRESS
+            port = self.class::DEFAULT_SERVICE_PORT
+            interceptors = self.class::GRPC_INTERCEPTORS
             @debugger2_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
@@ -166,28 +166,34 @@ module Google
               channel: channel,
               updater_proc: updater_proc,
               scopes: scopes,
+              interceptors: interceptors,
               &Google::Devtools::Clouddebugger::V2::Debugger2::Stub.method(:new)
             )
             @set_breakpoint = Google::Gax.create_api_call(
               @debugger2_stub.method(:set_breakpoint),
-              defaults["set_breakpoint"]
+              defaults["set_breakpoint"],
+              exception_transformer: exception_transformer
             )
             @get_breakpoint = Google::Gax.create_api_call(
               @debugger2_stub.method(:get_breakpoint),
-              defaults["get_breakpoint"]
+              defaults["get_breakpoint"],
+              exception_transformer: exception_transformer
             )
             @delete_breakpoint = Google::Gax.create_api_call(
               @debugger2_stub.method(:delete_breakpoint),
-              defaults["delete_breakpoint"]
+              defaults["delete_breakpoint"],
+              exception_transformer: exception_transformer
             )
             @list_breakpoints = Google::Gax.create_api_call(
               @debugger2_stub.method(:list_breakpoints),
-              defaults["list_breakpoints"]
+              defaults["list_breakpoints"],
+              exception_transformer: exception_transformer
             )
             @list_debuggees = Google::Gax.create_api_call(
               @debugger2_stub.method(:list_debuggees),
-              defaults["list_debuggees"]
+              defaults["list_debuggees"],
+              exception_transformer: exception_transformer
             )
           end
@@ -208,14 +214,23 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Devtools::Clouddebugger::V2::SetBreakpointResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouddebugger::V2::SetBreakpointResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
+          #
+          #   # TODO: Initialize +debuggee_id+:
           #   debuggee_id = ''
+          #
+          #   # TODO: Initialize +breakpoint+:
           #   breakpoint = {}
+          #
+          #   # TODO: Initialize +client_version+:
           #   client_version = ''
           #   response = debugger2_client.set_breakpoint(debuggee_id, breakpoint, client_version)
@@ -223,14 +238,15 @@ module Google
               debuggee_id,
               breakpoint,
               client_version,
-              options: nil
+              options: nil,
+              &block
             req = {
               debuggee_id: debuggee_id,
               breakpoint: breakpoint,
               client_version: client_version
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::SetBreakpointRequest)
-            @set_breakpoint.call(req, options)
+            @set_breakpoint.call(req, options, &block)
           end
           # Gets breakpoint information.
@@ -245,14 +261,23 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Devtools::Clouddebugger::V2::GetBreakpointResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouddebugger::V2::GetBreakpointResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
+          #
+          #   # TODO: Initialize +debuggee_id+:
           #   debuggee_id = ''
+          #
+          #   # TODO: Initialize +breakpoint_id+:
           #   breakpoint_id = ''
+          #
+          #   # TODO: Initialize +client_version+:
           #   client_version = ''
           #   response = debugger2_client.get_breakpoint(debuggee_id, breakpoint_id, client_version)
@@ -260,14 +285,15 @@ module Google
               debuggee_id,
               breakpoint_id,
               client_version,
-              options: nil
+              options: nil,
+              &block
             req = {
               debuggee_id: debuggee_id,
               breakpoint_id: breakpoint_id,
               client_version: client_version
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::GetBreakpointRequest)
-            @get_breakpoint.call(req, options)
+            @get_breakpoint.call(req, options, &block)
           end
           # Deletes the breakpoint from the debuggee.
@@ -282,13 +308,22 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result []
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
+          #
+          #   # TODO: Initialize +debuggee_id+:
           #   debuggee_id = ''
+          #
+          #   # TODO: Initialize +breakpoint_id+:
           #   breakpoint_id = ''
+          #
+          #   # TODO: Initialize +client_version+:
           #   client_version = ''
           #   debugger2_client.delete_breakpoint(debuggee_id, breakpoint_id, client_version)
@@ -296,14 +331,15 @@ module Google
               debuggee_id,
               breakpoint_id,
               client_version,
-              options: nil
+              options: nil,
+              &block
             req = {
               debuggee_id: debuggee_id,
               breakpoint_id: breakpoint_id,
               client_version: client_version
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::DeleteBreakpointRequest)
-            @delete_breakpoint.call(req, options)
+            @delete_breakpoint.call(req, options, &block)
             nil
           end
@@ -336,13 +372,20 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Devtools::Clouddebugger::V2::ListBreakpointsResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouddebugger::V2::ListBreakpointsResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
+          #
+          #   # TODO: Initialize +debuggee_id+:
           #   debuggee_id = ''
+          #
+          #   # TODO: Initialize +client_version+:
           #   client_version = ''
           #   response = debugger2_client.list_breakpoints(debuggee_id, client_version)
@@ -354,7 +397,8 @@ module Google
               action: nil,
               strip_results: nil,
               wait_token: nil,
-              options: nil
+              options: nil,
+              &block
             req = {
               debuggee_id: debuggee_id,
               client_version: client_version,
@@ -365,7 +409,7 @@ module Google
               wait_token: wait_token
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::ListBreakpointsRequest)
-            @list_breakpoints.call(req, options)
+            @list_breakpoints.call(req, options, &block)
           end
           # Lists all the debuggees that the user has access to.
@@ -381,13 +425,20 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Devtools::Clouddebugger::V2::ListDebuggeesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouddebugger::V2::ListDebuggeesResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/debugger/v2"
           #
           #   debugger2_client = Google::Cloud::Debugger::V2::Debugger2.new
+          #
+          #   # TODO: Initialize +project+:
           #   project = ''
+          #
+          #   # TODO: Initialize +client_version+:
           #   client_version = ''
           #   response = debugger2_client.list_debuggees(project, client_version)
@@ -395,14 +446,15 @@ module Google
               project,
               client_version,
               include_inactive: nil,
-              options: nil
+              options: nil,
+              &block
             req = {
               project: project,
               client_version: client_version,
               include_inactive: include_inactive
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouddebugger::V2::ListDebuggeesRequest)
-            @list_debuggees.call(req, options)
+            @list_debuggees.call(req, options, &block)
           end
         end
       end

data/lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/controller.rb ADDED

@@ -0,0 +1,90 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+module Google
+  module Devtools
+    module Clouddebugger
+      module V2
+        # Request to register a debuggee.
+        # @!attribute [rw] debuggee
+        #   @return [Google::Devtools::Clouddebugger::V2::Debuggee]
+        #     Debuggee information to register.
+        #     The fields +project+, +uniquifier+, +description+ and +agent_version+
+        #     of the debuggee must be set.
+        class RegisterDebuggeeRequest; end
+        # Response for registering a debuggee.
+        # @!attribute [rw] debuggee
+        #   @return [Google::Devtools::Clouddebugger::V2::Debuggee]
+        #     Debuggee resource.
+        #     The field +id+ is guranteed to be set (in addition to the echoed fields).
+        #     If the field +is_disabled+ is set to +true+, the agent should disable
+        #     itself by removing all breakpoints and detaching from the application.
+        #     It should however continue to poll +RegisterDebuggee+ until reenabled.
+        class RegisterDebuggeeResponse; end
+        # Request to list active breakpoints.
+        # @!attribute [rw] debuggee_id
+        #   @return [String]
+        #     Identifies the debuggee.
+        # @!attribute [rw] wait_token
+        #   @return [String]
+        #     A token that, if specified, blocks the method call until the list
+        #     of active breakpoints has changed, or a server-selected timeout has
+        #     expired. The value should be set from the +next_wait_token+ field in
+        #     the last response. The initial value should be set to +"init"+.
+        # @!attribute [rw] success_on_timeout
+        #   @return [true, false]
+        #     If set to +true+ (recommended), returns +google.rpc.Code.OK+ status and
+        #     sets the +wait_expired+ response field to +true+ when the server-selected
+        #     timeout has expired.
+        #
+        #     If set to +false+ (deprecated), returns +google.rpc.Code.ABORTED+ status
+        #     when the server-selected timeout has expired.
+        class ListActiveBreakpointsRequest; end
+        # Response for listing active breakpoints.
+        # @!attribute [rw] breakpoints
+        #   @return [Array<Google::Devtools::Clouddebugger::V2::Breakpoint>]
+        #     List of all active breakpoints.
+        #     The fields +id+ and +location+ are guaranteed to be set on each breakpoint.
+        # @!attribute [rw] next_wait_token
+        #   @return [String]
+        #     A token that can be used in the next method call to block until
+        #     the list of breakpoints changes.
+        # @!attribute [rw] wait_expired
+        #   @return [true, false]
+        #     If set to +true+, indicates that there is no change to the
+        #     list of active breakpoints and the server-selected timeout has expired.
+        #     The +breakpoints+ field would be empty and should be ignored.
+        class ListActiveBreakpointsResponse; end
+        # Request to update an active breakpoint.
+        # @!attribute [rw] debuggee_id
+        #   @return [String]
+        #     Identifies the debuggee being debugged.
+        # @!attribute [rw] breakpoint
+        #   @return [Google::Devtools::Clouddebugger::V2::Breakpoint]
+        #     Updated breakpoint information.
+        #     The field +id+ must be set.
+        #     The agent must echo all Breakpoint specification fields in the update.
+        class UpdateActiveBreakpointRequest; end
+        # Response for updating an active breakpoint.
+        # The message is defined to allow future extensions.
+        class UpdateActiveBreakpointResponse; end
+      end
+    end
+  end
+end

data/lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/data.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/debugger.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,19 +15,6 @@
 module Google
   module Devtools
     module Clouddebugger
-      ##
-      # # Stackdriver Debugger API Contents
-      #
-      # | Class | Description |
-      # | ----- | ----------- |
-      # | [Debugger2Client][] | Examines the call stack and variables of a running application without stopping or slowing it down. |
-      # | [Controller2Client][] | Examines the call stack and variables of a running application without stopping or slowing it down. |
-      # | [Data Types][] | Data types for Google::Cloud::Debugger::V2 |
-      #
-      # [Debugger2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-debugger/latest/google/devtools/clouddebugger/v2/debugger2client
-      # [Controller2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-debugger/latest/google/devtools/clouddebugger/v2/controller2client
-      # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-debugger/latest/google/devtools/clouddebugger/v2/datatypes
-      #
       module V2
         # Request to set a breakpoint
         # @!attribute [rw] debuggee_id

data/lib/google/cloud/debugger/v2/doc/google/devtools/source/v1/source_context.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/debugger/v2/doc/google/protobuf/empty.rb ADDED

@@ -0,0 +1,28 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+module Google
+  module Protobuf
+    # A generic empty message that you can re-use to avoid defining duplicated
+    # empty messages in your APIs. A typical example is to use it as the request
+    # or the response type of an API method. For instance:
+    #
+    #     service Foo {
+    #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+    #     }
+    #
+    # The JSON representation for +Empty+ is empty JSON object +{}+.
+    class Empty; end
+  end
+end

data/lib/google/cloud/debugger/v2/doc/google/protobuf/timestamp.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/debugger/version.rb CHANGED

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Debugger
-      VERSION = "0.32.1".freeze
+      VERSION = "0.32.2".freeze
     end
   end
 end

data/lib/google/devtools/clouddebugger/v2/controller_services_pb.rb CHANGED

@@ -7,7 +7,7 @@
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,

data/lib/google/devtools/clouddebugger/v2/debugger_services_pb.rb CHANGED

@@ -7,7 +7,7 @@
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,

metadata CHANGED

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-debugger
 version: !ruby/object:Gem::Version
-  version: 0.32.1
+  version: 0.32.2
 platform: ruby
 authors:
 - Heng Xiong
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-07-05 00:00:00.000000000 Z
+date: 2018-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: binding_of_caller
@@ -150,6 +150,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -294,13 +308,15 @@ files:
 - lib/google/cloud/debugger/v2.rb
 - lib/google/cloud/debugger/v2/controller2_client.rb
 - lib/google/cloud/debugger/v2/controller2_client_config.json
+- lib/google/cloud/debugger/v2/credentials.rb
 - lib/google/cloud/debugger/v2/debugger2_client.rb
 - lib/google/cloud/debugger/v2/debugger2_client_config.json
+- lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/controller.rb
 - lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/data.rb
 - lib/google/cloud/debugger/v2/doc/google/devtools/clouddebugger/v2/debugger.rb
 - lib/google/cloud/debugger/v2/doc/google/devtools/source/v1/source_context.rb
+- lib/google/cloud/debugger/v2/doc/google/protobuf/empty.rb
 - lib/google/cloud/debugger/v2/doc/google/protobuf/timestamp.rb
-- lib/google/cloud/debugger/v2/doc/overview.rb
 - lib/google/cloud/debugger/version.rb
 - lib/google/devtools/clouddebugger/v2/controller_pb.rb
 - lib/google/devtools/clouddebugger/v2/controller_services_pb.rb

data/lib/google/cloud/debugger/v2/doc/overview.rb DELETED

@@ -1,54 +0,0 @@
-# Copyright 2017 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-module Google
-  module Cloud
-    # rubocop:disable LineLength
-    ##
-    # # Ruby Client for Stackdriver Debugger API ([Beta](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
-    #
-    # [Stackdriver Debugger API][Product Documentation]:
-    # Examines the call stack and variables of a running application
-    # without stopping or slowing it down.
-    # - [Product Documentation][]
-    #
-    # ## Quick Start
-    # In order to use this library, you first need to go through the following
-    # steps:
-    #
-    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-    # 2. [Enable the Stackdriver Debugger API.](https://console.cloud.google.com/apis/api/debugger)
-    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-    #
-    # ### Installation
-    # ```
-    # $ gem install google-cloud-debugger
-    # ```
-    #
-    # ### Next Steps
-    # - Read the [Stackdriver Debugger API Product documentation][Product Documentation]
-    #   to learn more about the product and see How-to Guides.
-    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
-    #   to see the full list of Cloud APIs that we cover.
-    #
-    # [Product Documentation]: https://cloud.google.com/debugger
-    #
-    #
-    module Debugger
-      module V2
-      end
-    end
-  end
-end