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

google-cloud-debugger 0.32.1 → 0.32.2

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