google-cloud-error_reporting 0.30.1 → 0.30.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4803dd3ca8f339200e8644cff9d6cd1ff614d6938252f9ef482a1fdbfebcacf1
-  data.tar.gz: 38de25dcb58db7bfea2070f908c2a1d051ad37aeb2d4a0d2c5cb7a76354022c6
+  metadata.gz: 526e937032f341fd3733119a12bfb2a15947a6fc207e21bd4c8fdf15770250fc
+  data.tar.gz: c674653c23005c38d607b5ea1c9e48315ee1dd8cf0f951356ee325bc66b8bdd3
 SHA512:
-  metadata.gz: 9831d8f4ec9210ee09540126be7e9043ec9dd40d3c9740c37b11850fac7ed48743da98f213a58d4de3de9e5f33636b060828d6978309c2d7dcb96b025e45ce10
-  data.tar.gz: 5653c450fb8c1ef7697f2a2f613d2bb35c280897a338f14044db9aabc38a252f76bb5eb95802c12573c8376e2420380830df84d244f9b86fa5d477de92954712
+  metadata.gz: e7936f6d9cd7f89a7f905010cdcacd0b1b14f6040e5726676505aa8ace1b421f7c954a01625e2faad21fd4be9d88297bc26ddfb4ddb3760ee2acc0c0ed2d7973
+  data.tar.gz: 163f7d329c7ca17d4cef9447d2a9428a553223d7daf182eba5f352bb19657b358758bd0879e0daa567af4e988a0bdeb77620b47f6b05ba8df0033f8b3af487f6

data/.yardopts

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

data/README.md

@@ -202,14 +202,14 @@ end
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.0+.
-
-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.
 
 ## Versioning
 

data/lib/google/cloud/error_reporting/credentials.rb

@@ -13,7 +13,7 @@
 # limitations under the License.
 
 
-require "googleauth"
+require "google/cloud/error_reporting/v1beta1/credentials"
 
 module Google
   module Cloud
@@ -37,20 +37,7 @@ module Google
       #
       #   error_reporting.project_id #=> "my-project"
       #
-      class Credentials < Google::Auth::Credentials
-        SCOPE = ["https://www.googleapis.com/auth/cloud-platform"].freeze
-        PATH_ENV_VARS = %w[ERROR_REPORTING_CREDENTIALS
-                           GOOGLE_CLOUD_CREDENTIALS
-                           ERROR_REPORTING_KEYFILE
-                           GOOGLE_CLOUD_KEYFILE
-                           GCLOUD_KEYFILE].freeze
-        JSON_ENV_VARS = %w[ERROR_REPORTING_CREDENTIALS_JSON
-                           GOOGLE_CLOUD_CREDENTIALS_JSON
-                           ERROR_REPORTING_KEYFILE_JSON
-                           GOOGLE_CLOUD_KEYFILE_JSON
-                           GCLOUD_KEYFILE_JSON].freeze
-        DEFAULT_PATHS = \
-          ["~/.config/gcloud/application_default_credentials.json"].freeze
+      class Credentials < Google::Cloud::ErrorReporting::V1beta1::Credentials
       end
     end
   end

data/lib/google/cloud/error_reporting/v1beta1/credentials.rb

@@ -0,0 +1,40 @@
+# 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 ErrorReporting
+      module V1beta1
+        class Credentials < Google::Auth::Credentials
+          SCOPE = [
+            "https://www.googleapis.com/auth/cloud-platform"
+          ].freeze
+          PATH_ENV_VARS = %w(ERROR_REPORTING_CREDENTIALS
+                             ERROR_REPORTING_KEYFILE
+                             GOOGLE_CLOUD_CREDENTIALS
+                             GOOGLE_CLOUD_KEYFILE
+                             GCLOUD_KEYFILE)
+          JSON_ENV_VARS = %w(ERROR_REPORTING_CREDENTIALS_JSON
+                             ERROR_REPORTING_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/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/common.rb

@@ -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/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_group_service.rb

@@ -0,0 +1,40 @@
+# 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 Clouderrorreporting
+      module V1beta1
+        # A request to return an individual group.
+        # @!attribute [rw] group_name
+        #   @return [String]
+        #     [Required] The group resource name. Written as
+        #     <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
+        #     Call
+        #     <a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
+        #     <code>groupStats.list</code></a> to return a list of groups belonging to
+        #     this project.
+        #
+        #     Example: <code>projects/my-project-123/groups/my-group</code>
+        class GetGroupRequest; end
+
+        # A request to replace the existing data for the given group.
+        # @!attribute [rw] group
+        #   @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup]
+        #     [Required] The group which replaces the resource on the server.
+        class UpdateGroupRequest; end
+      end
+    end
+  end
+end

data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_stats_service.rb

@@ -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,21 +15,6 @@
 module Google
   module Devtools
     module Clouderrorreporting
-      ##
-      # # Stackdriver Error Reporting API Contents
-      #
-      # | Class | Description |
-      # | ----- | ----------- |
-      # | [ErrorGroupServiceClient][] | Stackdriver Error Reporting groups and counts similar errors from cloud services. The Stackdriver Error Reporting API provides a way to report new errors and read access to error groups and their associated errors. |
-      # | [ErrorStatsServiceClient][] | Stackdriver Error Reporting groups and counts similar errors from cloud services. The Stackdriver Error Reporting API provides a way to report new errors and read access to error groups and their associated errors. |
-      # | [ReportErrorsServiceClient][] | Stackdriver Error Reporting groups and counts similar errors from cloud services. The Stackdriver Error Reporting API provides a way to report new errors and read access to error groups and their associated errors. |
-      # | [Data Types][] | Data types for Google::Cloud::ErrorReporting::V1beta1 |
-      #
-      # [ErrorGroupServiceClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/errorgroupserviceclient
-      # [ErrorStatsServiceClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/errorstatsserviceclient
-      # [ReportErrorsServiceClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/reporterrorsserviceclient
-      # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/datatypes
-      #
       module V1beta1
         # Specifies a set of +ErrorGroupStats+ to return.
         # @!attribute [rw] project_name

data/lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb

@@ -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,21 +15,6 @@
 module Google
   module Devtools
     module Clouderrorreporting
-      ##
-      # # Stackdriver Error Reporting API Contents
-      #
-      # | Class | Description |
-      # | ----- | ----------- |
-      # | [ErrorGroupServiceClient][] | Stackdriver Error Reporting groups and counts similar errors from cloud services. The Stackdriver Error Reporting API provides a way to report new errors and read access to error groups and their associated errors. |
-      # | [ErrorStatsServiceClient][] | Stackdriver Error Reporting groups and counts similar errors from cloud services. The Stackdriver Error Reporting API provides a way to report new errors and read access to error groups and their associated errors. |
-      # | [ReportErrorsServiceClient][] | Stackdriver Error Reporting groups and counts similar errors from cloud services. The Stackdriver Error Reporting API provides a way to report new errors and read access to error groups and their associated errors. |
-      # | [Data Types][] | Data types for Google::Cloud::ErrorReporting::V1beta1 |
-      #
-      # [ErrorGroupServiceClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/errorgroupserviceclient
-      # [ErrorStatsServiceClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/errorstatsserviceclient
-      # [ReportErrorsServiceClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/reporterrorsserviceclient
-      # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/google/devtools/clouderrorreporting/v1beta1/datatypes
-      #
       module V1beta1
         # A request for reporting an individual error event.
         # @!attribute [rw] project_name

data/lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/duration.rb

@@ -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/error_reporting/v1beta1/doc/google/protobuf/timestamp.rb

@@ -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/error_reporting/v1beta1/error_group_service_client.rb

@@ -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/clouderrorreporting/v1beta1/error_group_service_pb"
-require "google/cloud/error_reporting/credentials"
+require "google/cloud/error_reporting/v1beta1/credentials"
 
 module Google
   module Cloud
@@ -47,6 +44,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
@@ -55,6 +55,7 @@ module Google
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
 
+
           GROUP_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/groups/{group}"
           )
@@ -96,16 +97,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
@@ -114,21 +117,10 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouderrorreporting/v1beta1/error_group_service_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::ErrorReporting::Credentials.default
+            credentials ||= Google::Cloud::ErrorReporting::V1beta1::Credentials.default
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
-              updater_proc = Google::Cloud::ErrorReporting::Credentials.new(credentials).updater_proc
+              updater_proc = Google::Cloud::ErrorReporting::V1beta1::Credentials.new(credentials).updater_proc
             end
             if credentials.is_a?(GRPC::Core::Channel)
               channel = credentials
@@ -143,13 +135,16 @@ module Google
               updater_proc = credentials.updater_proc
             end
 
+            package_version = Gem.loaded_specs['google-cloud-error_reporting'].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(
               "error_group_service_client_config.json"
             )
@@ -161,9 +156,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
             @error_group_service_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
@@ -171,16 +171,19 @@ module Google
               channel: channel,
               updater_proc: updater_proc,
               scopes: scopes,
+              interceptors: interceptors,
               &Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupService::Stub.method(:new)
             )
 
             @get_group = Google::Gax.create_api_call(
               @error_group_service_stub.method(:get_group),
-              defaults["get_group"]
+              defaults["get_group"],
+              exception_transformer: exception_transformer
             )
             @update_group = Google::Gax.create_api_call(
               @error_group_service_stub.method(:update_group),
-              defaults["update_group"]
+              defaults["update_group"],
+              exception_transformer: exception_transformer
             )
           end
 
@@ -200,23 +203,27 @@ 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::Clouderrorreporting::V1beta1::ErrorGroup]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1"
+          #   require "google/cloud/error_reporting"
           #
-          #   error_group_service_client = Google::Cloud::ErrorReporting::V1beta1::ErrorGroup.new
+          #   error_group_service_client = Google::Cloud::ErrorReporting::ErrorGroup.new(version: :v1beta1)
           #   formatted_group_name = Google::Cloud::ErrorReporting::V1beta1::ErrorGroupServiceClient.group_path("[PROJECT]", "[GROUP]")
           #   response = error_group_service_client.get_group(formatted_group_name)
 
           def get_group \
               group_name,
-              options: nil
+              options: nil,
+              &block
             req = {
               group_name: group_name
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouderrorreporting::V1beta1::GetGroupRequest)
-            @get_group.call(req, options)
+            @get_group.call(req, options, &block)
           end
 
           # Replace the data for the specified group.
@@ -229,23 +236,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::Clouderrorreporting::V1beta1::ErrorGroup]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroup]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1"
+          #   require "google/cloud/error_reporting"
+          #
+          #   error_group_service_client = Google::Cloud::ErrorReporting::ErrorGroup.new(version: :v1beta1)
           #
-          #   error_group_service_client = Google::Cloud::ErrorReporting::V1beta1::ErrorGroup.new
+          #   # TODO: Initialize +group+:
           #   group = {}
           #   response = error_group_service_client.update_group(group)
 
           def update_group \
               group,
-              options: nil
+              options: nil,
+              &block
             req = {
               group: group
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouderrorreporting::V1beta1::UpdateGroupRequest)
-            @update_group.call(req, options)
+            @update_group.call(req, options, &block)
           end
         end
       end

data/lib/google/cloud/error_reporting/v1beta1/error_stats_service_client.rb

@@ -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/clouderrorreporting/v1beta1/error_stats_service_pb"
-require "google/cloud/error_reporting/credentials"
+require "google/cloud/error_reporting/v1beta1/credentials"
 
 module Google
   module Cloud
@@ -48,6 +45,9 @@ module Google
           # The default port of the service.
           DEFAULT_SERVICE_PORT = 443
 
+          # The default set of gRPC interceptors.
+          GRPC_INTERCEPTORS = []
+
           DEFAULT_TIMEOUT = 30
 
           PAGE_DESCRIPTORS = {
@@ -69,6 +69,7 @@ module Google
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
 
+
           PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}"
           )
@@ -108,16 +109,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
@@ -126,21 +129,10 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouderrorreporting/v1beta1/error_stats_service_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::ErrorReporting::Credentials.default
+            credentials ||= Google::Cloud::ErrorReporting::V1beta1::Credentials.default
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
-              updater_proc = Google::Cloud::ErrorReporting::Credentials.new(credentials).updater_proc
+              updater_proc = Google::Cloud::ErrorReporting::V1beta1::Credentials.new(credentials).updater_proc
             end
             if credentials.is_a?(GRPC::Core::Channel)
               channel = credentials
@@ -155,13 +147,16 @@ module Google
               updater_proc = credentials.updater_proc
             end
 
+            package_version = Gem.loaded_specs['google-cloud-error_reporting'].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(
               "error_stats_service_client_config.json"
             )
@@ -174,9 +169,14 @@ module Google
                 timeout,
                 page_descriptors: PAGE_DESCRIPTORS,
                 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
             @error_stats_service_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
@@ -184,20 +184,24 @@ module Google
               channel: channel,
               updater_proc: updater_proc,
               scopes: scopes,
+              interceptors: interceptors,
               &Google::Devtools::Clouderrorreporting::V1beta1::ErrorStatsService::Stub.method(:new)
             )
 
             @list_group_stats = Google::Gax.create_api_call(
               @error_stats_service_stub.method(:list_group_stats),
-              defaults["list_group_stats"]
+              defaults["list_group_stats"],
+              exception_transformer: exception_transformer
             )
             @list_events = Google::Gax.create_api_call(
               @error_stats_service_stub.method(:list_events),
-              defaults["list_events"]
+              defaults["list_events"],
+              exception_transformer: exception_transformer
             )
             @delete_events = Google::Gax.create_api_call(
               @error_stats_service_stub.method(:delete_events),
-              defaults["delete_events"]
+              defaults["delete_events"],
+              exception_transformer: exception_transformer
             )
           end
 
@@ -255,6 +259,9 @@ 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::Gax::PagedEnumerable<Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupStats>]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Gax::PagedEnumerable<Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupStats>]
           #   An enumerable of Google::Devtools::Clouderrorreporting::V1beta1::ErrorGroupStats instances.
           #   See Google::Gax::PagedEnumerable documentation for other
@@ -262,10 +269,12 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1"
+          #   require "google/cloud/error_reporting"
           #
-          #   error_stats_service_client = Google::Cloud::ErrorReporting::V1beta1::ErrorStats.new
+          #   error_stats_service_client = Google::Cloud::ErrorReporting::ErrorStats.new(version: :v1beta1)
           #   formatted_project_name = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceClient.project_path("[PROJECT]")
+          #
+          #   # TODO: Initialize +time_range+:
           #   time_range = {}
           #
           #   # Iterate over all results.
@@ -291,7 +300,8 @@ module Google
               alignment_time: nil,
               order: nil,
               page_size: nil,
-              options: nil
+              options: nil,
+              &block
             req = {
               project_name: project_name,
               time_range: time_range,
@@ -304,7 +314,7 @@ module Google
               page_size: page_size
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouderrorreporting::V1beta1::ListGroupStatsRequest)
-            @list_group_stats.call(req, options)
+            @list_group_stats.call(req, options, &block)
           end
 
           # Lists the specified events.
@@ -338,6 +348,9 @@ 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::Gax::PagedEnumerable<Google::Devtools::Clouderrorreporting::V1beta1::ErrorEvent>]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Gax::PagedEnumerable<Google::Devtools::Clouderrorreporting::V1beta1::ErrorEvent>]
           #   An enumerable of Google::Devtools::Clouderrorreporting::V1beta1::ErrorEvent instances.
           #   See Google::Gax::PagedEnumerable documentation for other
@@ -345,10 +358,12 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1"
+          #   require "google/cloud/error_reporting"
           #
-          #   error_stats_service_client = Google::Cloud::ErrorReporting::V1beta1::ErrorStats.new
+          #   error_stats_service_client = Google::Cloud::ErrorReporting::ErrorStats.new(version: :v1beta1)
           #   formatted_project_name = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceClient.project_path("[PROJECT]")
+          #
+          #   # TODO: Initialize +group_id+:
           #   group_id = ''
           #
           #   # Iterate over all results.
@@ -370,7 +385,8 @@ module Google
               service_filter: nil,
               time_range: nil,
               page_size: nil,
-              options: nil
+              options: nil,
+              &block
             req = {
               project_name: project_name,
               group_id: group_id,
@@ -379,7 +395,7 @@ module Google
               page_size: page_size
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouderrorreporting::V1beta1::ListEventsRequest)
-            @list_events.call(req, options)
+            @list_events.call(req, options, &block)
           end
 
           # Deletes all error events of a given project.
@@ -393,23 +409,27 @@ 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::Clouderrorreporting::V1beta1::DeleteEventsResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::DeleteEventsResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1"
+          #   require "google/cloud/error_reporting"
           #
-          #   error_stats_service_client = Google::Cloud::ErrorReporting::V1beta1::ErrorStats.new
+          #   error_stats_service_client = Google::Cloud::ErrorReporting::ErrorStats.new(version: :v1beta1)
           #   formatted_project_name = Google::Cloud::ErrorReporting::V1beta1::ErrorStatsServiceClient.project_path("[PROJECT]")
           #   response = error_stats_service_client.delete_events(formatted_project_name)
 
           def delete_events \
               project_name,
-              options: nil
+              options: nil,
+              &block
             req = {
               project_name: project_name
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouderrorreporting::V1beta1::DeleteEventsRequest)
-            @delete_events.call(req, options)
+            @delete_events.call(req, options, &block)
           end
         end
       end

data/lib/google/cloud/error_reporting/v1beta1/report_errors_service_client.rb

@@ -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/clouderrorreporting/v1beta1/report_errors_service_pb"
-require "google/cloud/error_reporting/credentials"
+require "google/cloud/error_reporting/v1beta1/credentials"
 
 module Google
   module Cloud
@@ -47,6 +44,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
@@ -55,6 +55,7 @@ module Google
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
 
+
           PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}"
           )
@@ -94,16 +95,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
@@ -112,21 +115,10 @@ module Google
             require "google/gax/grpc"
             require "google/devtools/clouderrorreporting/v1beta1/report_errors_service_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::ErrorReporting::Credentials.default
+            credentials ||= Google::Cloud::ErrorReporting::V1beta1::Credentials.default
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
-              updater_proc = Google::Cloud::ErrorReporting::Credentials.new(credentials).updater_proc
+              updater_proc = Google::Cloud::ErrorReporting::V1beta1::Credentials.new(credentials).updater_proc
             end
             if credentials.is_a?(GRPC::Core::Channel)
               channel = credentials
@@ -141,13 +133,16 @@ module Google
               updater_proc = credentials.updater_proc
             end
 
+            package_version = Gem.loaded_specs['google-cloud-error_reporting'].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(
               "report_errors_service_client_config.json"
             )
@@ -159,9 +154,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
             @report_errors_service_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
@@ -169,12 +169,14 @@ module Google
               channel: channel,
               updater_proc: updater_proc,
               scopes: scopes,
+              interceptors: interceptors,
               &Google::Devtools::Clouderrorreporting::V1beta1::ReportErrorsService::Stub.method(:new)
             )
 
             @report_error_event = Google::Gax.create_api_call(
               @report_errors_service_stub.method(:report_error_event),
-              defaults["report_error_event"]
+              defaults["report_error_event"],
+              exception_transformer: exception_transformer
             )
           end
 
@@ -201,26 +203,32 @@ 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::Clouderrorreporting::V1beta1::ReportErrorEventResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @return [Google::Devtools::Clouderrorreporting::V1beta1::ReportErrorEventResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/error_reporting/v1beta1"
+          #   require "google/cloud/error_reporting"
           #
-          #   report_errors_service_client = Google::Cloud::ErrorReporting::V1beta1::ReportErrors.new
+          #   report_errors_service_client = Google::Cloud::ErrorReporting::ReportErrors.new(version: :v1beta1)
           #   formatted_project_name = Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceClient.project_path("[PROJECT]")
+          #
+          #   # TODO: Initialize +event+:
           #   event = {}
           #   response = report_errors_service_client.report_error_event(formatted_project_name, event)
 
           def report_error_event \
               project_name,
               event,
-              options: nil
+              options: nil,
+              &block
             req = {
               project_name: project_name,
               event: event
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Devtools::Clouderrorreporting::V1beta1::ReportErrorEventRequest)
-            @report_error_event.call(req, options)
+            @report_error_event.call(req, options, &block)
           end
         end
       end

data/lib/google/cloud/error_reporting/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module ErrorReporting
-      VERSION = "0.30.1".freeze
+      VERSION = "0.30.2".freeze
     end
   end
 end

data/lib/google/devtools/clouderrorreporting/v1beta1/error_group_service_services_pb.rb

@@ -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/clouderrorreporting/v1beta1/error_stats_service_services_pb.rb

@@ -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/clouderrorreporting/v1beta1/report_errors_service_services_pb.rb

@@ -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

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-error_reporting
 version: !ruby/object:Gem::Version
-  version: 0.30.1
+  version: 0.30.2
 platform: ruby
 authors:
 - Google Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-06 00:00:00.000000000 Z
+date: 2018-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.2'
+- !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
@@ -213,12 +227,13 @@ files:
 - lib/google/cloud/error_reporting/rails.rb
 - lib/google/cloud/error_reporting/service.rb
 - lib/google/cloud/error_reporting/v1beta1.rb
+- lib/google/cloud/error_reporting/v1beta1/credentials.rb
 - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/common.rb
+- lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_group_service.rb
 - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/error_stats_service.rb
 - lib/google/cloud/error_reporting/v1beta1/doc/google/devtools/clouderrorreporting/v1beta1/report_errors_service.rb
 - lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/duration.rb
 - lib/google/cloud/error_reporting/v1beta1/doc/google/protobuf/timestamp.rb
-- lib/google/cloud/error_reporting/v1beta1/doc/overview.rb
 - lib/google/cloud/error_reporting/v1beta1/error_group_service_client.rb
 - lib/google/cloud/error_reporting/v1beta1/error_group_service_client_config.json
 - lib/google/cloud/error_reporting/v1beta1/error_stats_service_client.rb

data/lib/google/cloud/error_reporting/v1beta1/doc/overview.rb

@@ -1,82 +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 Error Reporting API ([Beta](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
-    #
-    # [Stackdriver Error Reporting API][Product Documentation]:
-    # Stackdriver Error Reporting groups and counts similar errors from cloud
-    # services. The Stackdriver Error Reporting API provides a way to report new
-    # errors and read access to error groups and their associated errors.
-    # - [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 Error Reporting API.](https://console.cloud.google.com/apis/api/error-reporting)
-    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-    #
-    # ### Installation
-    # ```
-    # $ gem install google-cloud-error_reporting
-    # ```
-    #
-    # ### Preview
-    # #### ReportErrorsServiceClient
-    # ```rb
-    # require "google/cloud/error_reporting"
-    #
-    # report_errors_service_client = Google::Cloud::ErrorReporting::ReportErrors.new
-    # formatted_project_name = Google::Cloud::ErrorReporting::V1beta1::ReportErrorsServiceClient.project_path(project_id)
-    # message = "[MESSAGE]"
-    # service = "[SERVICE]"
-    # service_context = { service: service }
-    # file_path = "path/to/file.lang"
-    # line_number = 42
-    # function_name = "meaningOfLife"
-    # report_location = {
-    #   file_path: file_path,
-    #   line_number: line_number,
-    #   function_name: function_name
-    # }
-    # context = { report_location: report_location }
-    # event = {
-    #   message: message,
-    #   service_context: service_context,
-    #   context: context
-    # }
-    # response = report_errors_service_client.report_error_event(formatted_project_name, event)
-    # ```
-    #
-    # ### Next Steps
-    # - Read the [Stackdriver Error Reporting 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/error-reporting
-    #
-    #
-    module ErrorReporting
-      module V1beta1
-      end
-    end
-  end
-end