google-cloud-debugger 0.35.2 → 0.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d3ec1053f9e75324201bf1d4416c847a9be07d0f8fcffb0d46c3f6e80c4898a
-  data.tar.gz: cfeae8ae152ed23cad068ea6dc8f7742b65e2d6d4130e669a0dac54dbe227525
+  metadata.gz: 1b4ce08aa3118de8cc2a1afe7874ca26f6d97a7922f84471caef85fe0aed3640
+  data.tar.gz: a6bc54a758686120fe5898e69179994e3325e72adf5c9e3b8ef4b0b010a5c9d6
 SHA512:
-  metadata.gz: 7789a4d3ba27e63bbd3c49b2f9ffab523d0178ebdbea97d106ecf98808f4f7b37ac2f26cbdcd6530cb755e33a20658177049f2c557940da240cd6422b731d5ac
-  data.tar.gz: 06307c070f9e122853533e16389c0868276b643ab0886999f1a76eb41d6a68cb1c73feca884e7d55f37cf11d155a33057d344868fb8d205ae6c932f1b65d8169
+  metadata.gz: 150edcd3b7d9c16480900ac16d22925eaf08c1629ac40c601d308da5e3db74237dbacd6510c9357861650d8fe519239c53c361448e3f6d005058313c1e442909
+  data.tar.gz: ce89d0b2545e87b7587b8887a6eafe1dead96614616437ce2709f60a83780a38607990687caf74398a219093d019f68bcd615aac469e1b35efec732c71141508

data/AUTHENTICATION.md

@@ -76,7 +76,8 @@ The environment variables that google-cloud-debugger checks for project ID are:
 1. `DEBUGGER_PROJECT`
 2. `GOOGLE_CLOUD_PROJECT`
 
-The environment variables that google-cloud-debugger checks for credentials are configured on {Google::Cloud::Debugger::V2::Credentials}:
+The environment variables that google-cloud-debugger checks for credentials are
+configured on `Google::Cloud::Debugger::V2::Debugger::Credentials`:
 
 1. `DEBUGGER_CREDENTIALS` - Path to JSON file, or JSON contents
 2. `DEBUGGER_KEYFILE` - Path to JSON file, or JSON contents

data/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Release History
 
+### 0.40.0 / 2020-07-21
+
+This is a major update that removes the "low-level" client interface code, and
+instead adds the new `google-cloud-debugger-v2` gem as a dependency.
+The new dependency is a rewritten low-level client, produced by a next-
+generation client code generator, with improved performance and stability.
+
+This change should have no effect on the high-level interface that most users
+will use. The one exception is that the (mostly undocumented) `client_config`
+argument, for adjusting low-level parameters such as RPC retry settings on
+client objects, has been removed. If you need to adjust these parameters, use
+the configuration interface in `google-cloud-debugger-v2`.
+
+Substantial changes have been made in the low-level interfaces, however. If you
+are using the low-level classes under the `Google::Cloud::Debugger::V2` module,
+please review the docs for the new `google-cloud-debugger-v2` gem. In
+particular:
+
+* Some classes have been renamed, notably the client class itself.
+* The client constructor takes a configuration block instead of configuration
+  keyword arguments.
+* All RPC method arguments are now keyword arguments.
+
+### 0.36.3 / 2020-07-06
+
+#### Bug Fixes
+
+* Fix segfaults on Ruby 2.7
+
+### 0.36.2 / 2020-05-28
+
+#### Documentation
+
+* Fix a few broken links
+
+### 0.36.1 / 2020-05-19
+
+#### Bug Fixes
+
+* Adjusted some default timeout and retry settings
+
+### 0.36.0 / 2020-03-11
+
+#### Features
+
+* Support separate project setting for quota/billing
+
 ### 0.35.2 / 2020-01-23
 
 #### Documentation

data/OVERVIEW.md

@@ -147,12 +147,9 @@ For further information on the Debugger API, see
 ```ruby
 require "google/cloud/debugger/v2"
 
-Controller2Client = Google::Cloud::Debugger::V2::Controller2Client
-Debuggee = Google::Devtools::Clouddebugger::V2::Debuggee
-
-controller2_client = Controller2Client.new
-debuggee = Debuggee.new
-response = controller2_client.register_debuggee(debuggee)
+controller_client = Google::Cloud::Debugger::V2::Controller::Client.new
+debuggee = Google::Cloud::Debugger::V2::Debuggee.new
+response = controller_client.register_debuggee debuggee: debuggee
 debuggee_id = response.debuggee.id
 ```
 See [Stackdriver Debugger Debuggee
@@ -163,23 +160,18 @@ Upon successful registration, the response debuggee object will contain a
 debuggee_id that's later needed to interact with the other Stackdriver Debugger
 API.
 
-See {Google::Cloud::Debugger::V2::Controller2Client} for details.
-
 ### List Active Breakpoints
 
 ```ruby
 require "google/cloud/debugger/v2"
 
-Controller2Client = Google::Cloud::Debugger::V2::Controller2Client
-controller2_client = Controller2Client.new
+controller_client = Google::Cloud::Debugger::V2::Controller::Client.new
 
 debuggee_id = ''
-response = controller2_client.list_active_breakpoints(debuggee_id)
+response = controller_client.list_active_breakpoints debuggee_id: debuggee_id
 breakpoints = response.breakpoints
 ```
 
-See {Google::Cloud::Debugger::V2::Controller2Client} for details.
-
 ### Update Active Breakpoint
 
 Users can send custom snapshots for active breakpoints using this API.
@@ -187,110 +179,87 @@ Users can send custom snapshots for active breakpoints using this API.
 ```ruby
 require "google/cloud/debugger/v2"
 
-Breakpoint = Google::Devtools::Clouddebugger::V2::Breakpoint
-Controller2Client = Google::Cloud::Debugger::V2::Controller2Client
-
-controller2_client = Controller2Client.new
+controller_client = Google::Cloud::Debugger::V2::Controller::Client.new
 debuggee_id = ''
-breakpoint = Breakpoint.new
-response =
-  controller2_client.update_active_breakpoint(debuggee_id, breakpoint)
+breakpoint = Google::Cloud::Debugger::V2::Breakpoint.new
+response = controller_client.update_active_breakpoint(
+  debuggee_id: debuggee_id, breakpoint: breakpoint)
 ```
 
 See [Stackdriver Debugger Breakpoint
 doc](https://cloud.google.com/debugger/api/reference/rpc/google.devtools.clouddebugger.v2#google.devtools.clouddebugger.v2.Breakpoint)
 for all available fields for breakpoint.
 
-See {Google::Cloud::Debugger::V2::Controller2Client} for details.
-
 ### Set Breakpoint
 
 ```ruby
 require "google/cloud/debugger/v2"
 
-Breakpoint = Google::Devtools::Clouddebugger::V2::Breakpoint
-Debugger2Client = Google::Cloud::Debugger::V2::Debugger2Client
-
-debugger2_client = Debugger2Client.new
+debugger_client = Google::Cloud::Debugger::V2::Debugger::Client.new
 debuggee_id = ''
-breakpoint = Breakpoint.new
+breakpoint = Google::Cloud::Debugger::V2::Breakpoint.new
 client_version = ''
-response = debugger2_client.set_breakpoint(
-             debuggee_id, breakpoint, client_version)
+response = debugger_client.set_breakpoint(
+  debuggee_id: debuggee_id, breakpoint: breakpoint,
+  client_version: client_version)
 ```
 
 See [Stackdriver Debugger Breakpoint
 doc](https://cloud.google.com/debugger/api/reference/rpc/google.devtools.clouddebugger.v2#google.devtools.clouddebugger.v2.Breakpoint)
 for fields needed to specify breakpoint location.
 
-See {Google::Cloud::Debugger::V2::Debugger2Client} for details.
-
 ### Get Breakpoint
 
 ```ruby
 require "google/cloud/debugger/v2"
 
-Debugger2Client = Google::Cloud::Debugger::V2::Debugger2Client
-
-debugger2_client = Debugger2Client.new
+debugger_client = Google::Cloud::Debugger::V2::Debugger::Client.new
 debuggee_id = ''
 breakpoint_id = ''
 client_version = ''
-response = debugger2_client.get_breakpoint(
-             debuggee_id, breakpoint_id, client_version)
+response = debugger_client.get_breakpoint(
+  debuggee_id: debuggee_id, breakpoint_id: breakpoint_id,
+  client_version: client_version)
 ```
 
-See {Google::Cloud::Debugger::V2::Debugger2Client} for details.
-
 ### Delete Breakpoint
 
 ```ruby
 require "google/cloud/debugger/v2"
 
-Debugger2Client = Google::Cloud::Debugger::V2::Debugger2Client
-
-debugger2_client = Debugger2Client.new
+debugger_client = Google::Cloud::Debugger::V2::Debugger::Client.new
 debuggee_id = ''
 breakpoint_id = ''
 client_version = ''
-debugger2_client.delete_breakpoint(
-  debuggee_id, breakpoint_id, client_version)
+debugger_client.delete_breakpoint(
+  debuggee_id: debuggee_id, breakpoint_id: breakpoint_id,
+  client_version: client_version)
 ```
 
-See {Google::Cloud::Debugger::V2::Debugger2Client} for details.
-
 ### List Breakpoints
 
 ```ruby
 require "google/cloud/debugger/v2"
 
-Debugger2Client = Google::Cloud::Debugger::V2::Debugger2Client
-
-Debugger2Client = Google::Cloud::Debugger::V2::Debugger2Client
-
-debugger2_client = Debugger2Client.new
+debugger_client = Google::Cloud::Debugger::V2::Debugger::Client.new
 debuggee_id = ''
 client_version = ''
-response = debugger2_client.list_breakpoints(debuggee_id, client_version)
+response = debugger_client.list_breakpoints(
+  debuggee_id: debuggee_id, client_version: client_version)
 ```
 
-See {Google::Cloud::Debugger::V2::Debugger2Client} for details.
-
 ### List Debuggees
 
 ```ruby
 require "google/cloud/debugger/v2"
 
-Debugger2Client = Google::Cloud::Debugger::V2::Debugger2Client
-
-debugger2_client = Debugger2Client.new
+debugger_client = Google::Cloud::Debugger::V2::Debugger::Client.new
 project = ''
 client_version = ''
-response = debugger2_client.list_debuggees(project, client_version)
+response = debugger_client.list_debuggees(
+  project: project, client_version: client_version)
 ```
 
-See {Google::Cloud::Debugger::V2::Debugger2Client} for details.
-
 ## Additional information
 
 Stackdriver Debugger can be configured to use gRPC's logging. To learn more, see

data/TROUBLESHOOTING.md

@@ -24,14 +24,8 @@ improved, *please* create a new issue on GitHub so we can talk about it.
 
   - [New issue][gh-ruby]
 
-Or, you can ask questions on the [Google Cloud Platform Slack][slack-ruby]. You
-can use the "ruby" channel for general Ruby questions, or use the
-"google-cloud-ruby" channel if you have questions about this gem in particular.
-
 [so-ruby]: http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby+debugger
 
-[gh-search-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues?q=label%3A%22api%3A+debugger%22
-
-[gh-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues/new
+[gh-search-ruby]: https://github.com/googleapis/google-cloud-ruby/issues?q=label%3A%22api%3A+debugger%22
 
-[slack-ruby]: https://gcp-slack.appspot.com/
+[gh-ruby]: https://github.com/googleapis/google-cloud-ruby/issues/new

data/ext/google/cloud/debugger/debugger_c/tracer.c

@@ -208,25 +208,19 @@ line_trace_callback(rb_event_flag_t event, VALUE data, VALUE obj, ID mid, VALUE
 static VALUE
 disable_line_trace_for_thread(VALUE thread)
 {
-    VALUE thread_variables_hash;
     VALUE line_trace_set;
-    ID locals_id;
     ID line_trace_thread_id;
-    VALUE line_trace_thread_flag;
 
-    CONST_ID(locals_id, "locals");
     CONST_ID(line_trace_thread_id, "gcloud_line_trace_set");
-    line_trace_thread_flag = ID2SYM(line_trace_thread_id);
 
     if (!RTEST(thread)) {
         thread = rb_thread_current();
     }
-    thread_variables_hash = rb_ivar_get(thread, locals_id);
-    line_trace_set = rb_hash_aref(thread_variables_hash, line_trace_thread_flag);
+    line_trace_set = rb_ivar_get(thread, line_trace_thread_id);
 
     if (RTEST(line_trace_set)) {
         rb_thread_remove_event_hook(thread, line_trace_callback);
-        rb_hash_aset(thread_variables_hash, line_trace_thread_flag, Qfalse);
+        rb_ivar_set(thread, line_trace_thread_id, Qfalse);
     }
 
     return Qnil;
@@ -241,23 +235,17 @@ static VALUE
 enable_line_trace_for_thread(VALUE self)
 {
     VALUE current_thread;
-    VALUE thread_variables_hash;
     VALUE line_trace_set;
-    ID locals_id;
     ID line_trace_thread_id;
-    VALUE line_trace_thread_flag;
 
-    CONST_ID(locals_id, "locals");
     CONST_ID(line_trace_thread_id, "gcloud_line_trace_set");
-    line_trace_thread_flag = ID2SYM(line_trace_thread_id);
 
     current_thread = rb_thread_current();
-    thread_variables_hash = rb_ivar_get(current_thread, locals_id);
-    line_trace_set = rb_hash_aref(thread_variables_hash, line_trace_thread_flag);
+    line_trace_set = rb_ivar_get(current_thread, line_trace_thread_id);
 
     if (!RTEST(line_trace_set)) {
         rb_thread_add_event_hook(current_thread, line_trace_callback, RUBY_EVENT_LINE, self);
-        rb_hash_aset(thread_variables_hash, line_trace_thread_flag, Qtrue);
+        rb_ivar_set(current_thread, line_trace_thread_id, Qtrue);
     }
 
     return Qnil;
@@ -331,25 +319,19 @@ return_trace_callback(void *data, rb_trace_arg_t *trace_arg)
 static VALUE
 disable_return_trace_for_thread(VALUE thread)
 {
-    VALUE thread_variables_hash;
     VALUE return_trace_set;
-    ID locals_id;
     ID return_trace_thread_id;
-    VALUE return_trace_thread_flag;
 
-    CONST_ID(locals_id, "locals");
     CONST_ID(return_trace_thread_id, "gcloud_return_trace_set");
-    return_trace_thread_flag = ID2SYM(return_trace_thread_id);
 
     if (!RTEST(thread)) {
         thread = rb_thread_current();
     }
-    thread_variables_hash = rb_ivar_get(thread, locals_id);
-    return_trace_set = rb_hash_aref(thread_variables_hash, return_trace_thread_flag);
+    return_trace_set = rb_ivar_get(thread, return_trace_thread_id);
 
     if (RTEST(return_trace_set)) {
         rb_thread_remove_event_hook(thread, (rb_event_hook_func_t)return_trace_callback);
-        rb_hash_aset(thread_variables_hash, return_trace_thread_flag, Qfalse);
+        rb_ivar_set(thread, return_trace_thread_id, Qfalse);
     }
 
     return Qnil;
@@ -364,24 +346,17 @@ static VALUE
 enable_return_trace_for_thread(VALUE self)
 {
     VALUE current_thread;
-    VALUE thread_variables_hash;
     VALUE return_trace_set;
-
-    ID locals_id;
     ID return_trace_thread_id;
-    VALUE return_trace_thread_flag;
 
-    CONST_ID(locals_id, "locals");
     CONST_ID(return_trace_thread_id, "gcloud_return_trace_set");
-    return_trace_thread_flag = ID2SYM(return_trace_thread_id);
 
     current_thread = rb_thread_current();
-    thread_variables_hash = rb_ivar_get(current_thread, locals_id);
-    return_trace_set = rb_hash_aref(thread_variables_hash, return_trace_thread_flag);
+    return_trace_set = rb_ivar_get(current_thread, return_trace_thread_id);
 
     if (!RTEST(return_trace_set)) {
         rb_thread_add_event_hook2(current_thread, (rb_event_hook_func_t)return_trace_callback, RETURN_TRACEPOINT_EVENTS, self, RUBY_EVENT_HOOK_FLAG_RAW_ARG | RUBY_EVENT_HOOK_FLAG_SAFE);
-        rb_hash_aset(thread_variables_hash, return_trace_thread_flag, Qtrue);
+        rb_ivar_set(current_thread, return_trace_thread_id, Qtrue);
     }
 
     return Qnil;

data/lib/google-cloud-debugger.rb

@@ -48,8 +48,6 @@ module Google
     #   * `https://www.googleapis.com/auth/logging.admin`
     #
     # @param [Integer] timeout Default timeout to use in requests. Optional.
-    # @param [Hash] client_config A hash of values to override the default
-    #   behavior of the API client. Optional.
     #
     # @return [Google::Cloud::Debugger::Project]
     #
@@ -68,14 +66,12 @@ module Google
     #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
     #   debugger = gcloud.debugger scope: platform_scope
     #
-    def debugger service_name: nil, service_version: nil, scope: nil,
-                 timeout: nil, client_config: nil
+    def debugger service_name: nil, service_version: nil, scope: nil, timeout: nil
       Google::Cloud.debugger @project, @keyfile,
                              service_name: service_name,
                              service_version: service_version,
                              scope: scope,
-                             timeout: (timeout || @timeout),
-                             client_config: client_config
+                             timeout: (timeout || @timeout)
     end
 
     ##
@@ -105,8 +101,6 @@ module Google
     #   * `https://www.googleapis.com/auth/logging.admin`
     #
     # @param [Integer] timeout Default timeout to use in requests. Optional.
-    # @param [Hash] client_config A hash of values to override the default
-    #   behavior of the API client. Optional.
     #
     # @return [Google::Cloud::Debugger::Project]
     #
@@ -118,15 +112,13 @@ module Google
     #   debugger.start
     #
     def self.debugger project_id = nil, credentials = nil, service_name: nil,
-                      service_version: nil, scope: nil, timeout: nil,
-                      client_config: nil
+                      service_version: nil, scope: nil, timeout: nil
       require "google/cloud/debugger"
       Google::Cloud::Debugger.new project_id: project_id,
                                   credentials: credentials,
                                   service_name: service_name,
                                   service_version: service_version,
-                                  scope: scope, timeout: timeout,
-                                  client_config: client_config
+                                  scope: scope, timeout: timeout
     end
   end
 end
@@ -160,6 +152,13 @@ Google::Cloud.configure.add_config! :debugger do |config|
   default_version = Google::Cloud::Config.deferred do
     ENV["DEBUGGER_SERVICE_VERSION"]
   end
+  default_scopes = [
+    "https://www.googleapis.com/auth/cloud-platform",
+    "https://www.googleapis.com/auth/cloud_debugger",
+    "https://www.googleapis.com/auth/logging.admin",
+    "https://www.googleapis.com/auth/logging.read",
+    "https://www.googleapis.com/auth/logging.write"
+  ]
 
   config.add_field! :project_id, default_project, match: String, allow_nil: true
   config.add_alias! :project, :project_id
@@ -173,10 +172,9 @@ Google::Cloud.configure.add_config! :debugger do |config|
                     match: String, allow_nil: true
   config.add_field! :app_root, nil, match: String
   config.add_field! :root, nil, match: String
-  config.add_field! :scope, nil, match: [String, Array]
+  config.add_field! :scope, default_scopes, match: [String, Array]
   config.add_field! :timeout, nil, match: Integer
-  config.add_field! :client_config, nil, match: Hash
-  config.add_field! :endpoint, nil, match: String
+  config.add_field! :endpoint, "clouddebugger.googleapis.com", match: String
   config.add_field! :allow_mutating_methods, false
   config.add_field! :evaluation_time_limit, 0.05, match: Numeric
   config.add_field! :on_error, nil, match: Proc