google-cloud-asset 0.1.2 → 0.2.0

data/lib/google/cloud/asset/v1/doc/google/rpc/status.rb

@@ -0,0 +1,87 @@
+# Copyright 2019 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 Rpc
+    # The `Status` type defines a logical error model that is suitable for
+    # different programming environments, including REST APIs and RPC APIs. It is
+    # used by [gRPC](https://github.com/grpc). The error model is designed to be:
+    #
+    # * Simple to use and understand for most users
+    # * Flexible enough to meet unexpected needs
+    #
+    # = Overview
+    #
+    # The `Status` message contains three pieces of data: error code, error
+    # message, and error details. The error code should be an enum value of
+    # {Google::Rpc::Code}, but it may accept additional error codes
+    # if needed.  The error message should be a developer-facing English message
+    # that helps developers *understand* and *resolve* the error. If a localized
+    # user-facing error message is needed, put the localized message in the error
+    # details or localize it in the client. The optional error details may contain
+    # arbitrary information about the error. There is a predefined set of error
+    # detail types in the package `google.rpc` that can be used for common error
+    # conditions.
+    #
+    # = Language mapping
+    #
+    # The `Status` message is the logical representation of the error model, but it
+    # is not necessarily the actual wire format. When the `Status` message is
+    # exposed in different client libraries and different wire protocols, it can be
+    # mapped differently. For example, it will likely be mapped to some exceptions
+    # in Java, but more likely mapped to some error codes in C.
+    #
+    # = Other uses
+    #
+    # The error model and the `Status` message can be used in a variety of
+    # environments, either with or without APIs, to provide a
+    # consistent developer experience across different environments.
+    #
+    # Example uses of this error model include:
+    #
+    # * Partial errors. If a service needs to return partial errors to the client,
+    #   it may embed the `Status` in the normal response to indicate the partial
+    #   errors.
+    #
+    # * Workflow errors. A typical workflow has multiple steps. Each step may
+    #   have a `Status` message for error reporting.
+    #
+    # * Batch operations. If a client uses batch request and batch response, the
+    #   `Status` message should be used directly inside batch response, one for
+    #   each error sub-response.
+    #
+    # * Asynchronous operations. If an API call embeds asynchronous operation
+    #   results in its response, the status of those operations should be
+    #   represented directly using the `Status` message.
+    #
+    # * Logging. If some API errors are stored in logs, the message `Status` could
+    #   be used directly after any stripping needed for security/privacy reasons.
+    # @!attribute [rw] code
+    #   @return [Integer]
+    #     The status code, which should be an enum value of
+    #     {Google::Rpc::Code}.
+    # @!attribute [rw] message
+    #   @return [String]
+    #     A developer-facing error message, which should be in English. Any
+    #     user-facing error message should be localized and sent in the
+    #     {Google::Rpc::Status#details} field, or localized
+    #     by the client.
+    # @!attribute [rw] details
+    #   @return [Array<Google::Protobuf::Any>]
+    #     A list of messages that carry the error details.  There is a common set of
+    #     message types for APIs to use.
+    class Status; end
+  end
+end

data/lib/google/cloud/asset/v1/helpers.rb

@@ -0,0 +1,29 @@
+# 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 Cloud
+    module Asset
+      module V1
+        class AssetServiceClient
+          # Alias for Google::Cloud::Asset::V1::AssetServiceClient.project_path.
+          # @param project [String]
+          # @return [String]
+          def project_path project
+            self.class.project_path project
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/asset/v1beta1.rb

@@ -14,6 +14,7 @@
 
 
 require "google/cloud/asset/v1beta1/asset_service_client"
+require "google/cloud/asset/v1beta1/helpers"
 
 module Google
   module Cloud

data/lib/google/cloud/asset/v1beta1/asset_service_client.rb

@@ -207,8 +207,9 @@ module Google
 
           # Exports assets with time and resource types to a given Cloud Storage
           # location. The output format is newline-delimited JSON.
-          # This API implements the {Google::Longrunning::Operation} API allowing you
-          # to keep track of the export.
+          # This API implements the
+          # {Google::Longrunning::Operation} API allowing
+          # you to keep track of the export.
           #
           # @param parent [String]
           #   Required. The relative name of the root asset. This can only be an
@@ -245,14 +246,14 @@ module Google
           # @example
           #   require "google/cloud/asset"
           #
-          #   asset_service_client = Google::Cloud::Asset.new(version: :v1beta1)
+          #   asset_client = Google::Cloud::Asset.new(version: :v1beta1)
           #   formatted_parent = Google::Cloud::Asset::V1beta1::AssetServiceClient.project_path("[PROJECT]")
           #
           #   # TODO: Initialize `output_config`:
           #   output_config = {}
           #
           #   # Register a callback during the method call.
-          #   operation = asset_service_client.export_assets(formatted_parent, output_config) do |op|
+          #   operation = asset_client.export_assets(formatted_parent, output_config) do |op|
           #     raise op.results.message if op.error?
           #     op_results = op.results
           #     # Process the results.
@@ -328,7 +329,8 @@ module Google
           # @param asset_names [Array<String>]
           #   A list of the full names of the assets. For example:
           #   `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
-          #   See [Resource Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
+          #   See [Resource
+          #   Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
           #   for more info.
           #
           #   The request becomes a no-op if the asset name list is empty, and the max
@@ -344,7 +346,7 @@ module Google
           # @example
           #   require "google/cloud/asset"
           #
-          #   asset_service_client = Google::Cloud::Asset.new(version: :v1beta1)
+          #   asset_client = Google::Cloud::Asset.new(version: :v1beta1)
           #   formatted_parent = Google::Cloud::Asset::V1beta1::AssetServiceClient.project_path("[PROJECT]")
           #
           #   # TODO: Initialize `content_type`:
@@ -352,7 +354,7 @@ module Google
           #
           #   # TODO: Initialize `read_time_window`:
           #   read_time_window = {}
-          #   response = asset_service_client.batch_get_assets_history(formatted_parent, content_type, read_time_window)
+          #   response = asset_client.batch_get_assets_history(formatted_parent, content_type, read_time_window)
 
           def batch_get_assets_history \
               parent,

data/lib/google/cloud/asset/v1beta1/asset_service_services_pb.rb

@@ -37,8 +37,9 @@ module Google
 
             # Exports assets with time and resource types to a given Cloud Storage
             # location. The output format is newline-delimited JSON.
-            # This API implements the [google.longrunning.Operation][google.longrunning.Operation] API allowing you
-            # to keep track of the export.
+            # This API implements the
+            # [google.longrunning.Operation][google.longrunning.Operation] API allowing
+            # you to keep track of the export.
             rpc :ExportAssets, ExportAssetsRequest, Google::Longrunning::Operation
             # Batch gets the update history of assets that overlap a time window.
             # For RESOURCE content, this API outputs history with asset in both

data/lib/google/cloud/asset/v1beta1/doc/google/cloud/asset/v1beta1/asset_service.rb

@@ -49,8 +49,10 @@ module Google
         class ExportAssetsRequest; end
 
         # The export asset response. This message is returned by the
-        # {Google::Longrunning::Operations::GetOperation} method in the returned
-        # {Google::Longrunning::Operation#response} field.
+        # {Google::Longrunning::Operations::GetOperation}
+        # method in the returned
+        # {Google::Longrunning::Operation#response}
+        # field.
         # @!attribute [rw] read_time
         #   @return [Google::Protobuf::Timestamp]
         #     Time the snapshot was taken.
@@ -70,7 +72,8 @@ module Google
         #   @return [Array<String>]
         #     A list of the full names of the assets. For example:
         #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
-        #     See [Resource Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
+        #     See [Resource
+        #     Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
         #     for more info.
         #
         #     The request becomes a no-op if the asset name list is empty, and the max

data/lib/google/cloud/asset/v1beta1/doc/google/cloud/asset/v1beta1/assets.rb

@@ -44,8 +44,10 @@ module Google
         # Cloud IAM policies, and other non-GCP assets.
         # @!attribute [rw] name
         #   @return [String]
-        #     The full name of the asset. For example: `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
-        #     See [Resource Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
+        #     The full name of the asset. For example:
+        #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
+        #     See [Resource
+        #     Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
         #     for more information.
         # @!attribute [rw] asset_type
         #   @return [String]
@@ -55,8 +57,8 @@ module Google
         #     Representation of the resource.
         # @!attribute [rw] iam_policy
         #   @return [Google::Iam::V1::Policy]
-        #     Representation of the actual Cloud IAM policy set on a cloud resource. For each
-        #     resource, there must be at most one Cloud IAM policy set on it.
+        #     Representation of the actual Cloud IAM policy set on a cloud resource. For
+        #     each resource, there must be at most one Cloud IAM policy set on it.
         class Asset; end
 
         # Representation of a cloud resource.
@@ -85,12 +87,14 @@ module Google
         # @!attribute [rw] parent
         #   @return [String]
         #     The full name of the immediate parent of this resource. See
-        #     [Resource Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
+        #     [Resource
+        #     Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
         #     for more information.
         #
         #     For GCP assets, it is the parent resource defined in the [Cloud IAM policy
         #     hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy).
-        #     For example: `"//cloudresourcemanager.googleapis.com/projects/my_project_123"`.
+        #     For example:
+        #     `"//cloudresourcemanager.googleapis.com/projects/my_project_123"`.
         #
         #     For third-party assets, it is up to the users to define.
         # @!attribute [rw] data

data/lib/google/cloud/asset/v1beta1/doc/google/longrunning/operations.rb

@@ -31,7 +31,7 @@ module Google
     # @!attribute [rw] done
     #   @return [true, false]
     #     If the value is `false`, it means the operation is still in progress.
-    #     If true, the operation is completed, and either `error` or `response` is
+    #     If `true`, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [Google::Rpc::Status]

data/lib/google/cloud/asset/v1beta1/doc/google/rpc/status.rb

@@ -15,24 +15,25 @@
 
 module Google
   module Rpc
-    # The `Status` type defines a logical error model that is suitable for different
-    # programming environments, including REST APIs and RPC APIs. It is used by
-    # [gRPC](https://github.com/grpc). The error model is designed to be:
+    # The `Status` type defines a logical error model that is suitable for
+    # different programming environments, including REST APIs and RPC APIs. It is
+    # used by [gRPC](https://github.com/grpc). The error model is designed to be:
     #
     # * Simple to use and understand for most users
     # * Flexible enough to meet unexpected needs
     #
     # = Overview
     #
-    # The `Status` message contains three pieces of data: error code, error message,
-    # and error details. The error code should be an enum value of
-    # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
-    # error message should be a developer-facing English message that helps
-    # developers *understand* and *resolve* the error. If a localized user-facing
-    # error message is needed, put the localized message in the error details or
-    # localize it in the client. The optional error details may contain arbitrary
-    # information about the error. There is a predefined set of error detail types
-    # in the package `google.rpc` that can be used for common error conditions.
+    # The `Status` message contains three pieces of data: error code, error
+    # message, and error details. The error code should be an enum value of
+    # {Google::Rpc::Code}, but it may accept additional error codes
+    # if needed.  The error message should be a developer-facing English message
+    # that helps developers *understand* and *resolve* the error. If a localized
+    # user-facing error message is needed, put the localized message in the error
+    # details or localize it in the client. The optional error details may contain
+    # arbitrary information about the error. There is a predefined set of error
+    # detail types in the package `google.rpc` that can be used for common error
+    # conditions.
     #
     # = Language mapping
     #
@@ -69,12 +70,14 @@ module Google
     #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of {Google::Rpc::Code}.
+    #     The status code, which should be an enum value of
+    #     {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {Google::Rpc::Status#details} field, or localized by the client.
+    #     {Google::Rpc::Status#details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

data/lib/google/cloud/asset/v1beta1/helpers.rb

@@ -0,0 +1,29 @@
+# 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 Cloud
+    module Asset
+      module V1beta1
+        class AssetServiceClient
+          # Alias for Google::Cloud::Asset::V1beta1::AssetServiceClient.project_path.
+          # @param project [String]
+          # @return [String]
+          def project_path project
+            self.class.project_path project
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-01 00:00:00.000000000 Z
+date: 2019-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.61.0
+        version: 0.64.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.61.0
+        version: 0.64.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -118,6 +118,22 @@ files:
 - LICENSE
 - README.md
 - lib/google/cloud/asset.rb
+- lib/google/cloud/asset/v1.rb
+- lib/google/cloud/asset/v1/asset_service_client.rb
+- lib/google/cloud/asset/v1/asset_service_client_config.json
+- lib/google/cloud/asset/v1/asset_service_pb.rb
+- lib/google/cloud/asset/v1/asset_service_services_pb.rb
+- lib/google/cloud/asset/v1/assets_pb.rb
+- lib/google/cloud/asset/v1/credentials.rb
+- lib/google/cloud/asset/v1/doc/google/cloud/asset/v1/asset_service.rb
+- lib/google/cloud/asset/v1/doc/google/cloud/asset/v1/assets.rb
+- lib/google/cloud/asset/v1/doc/google/iam/v1/policy.rb
+- lib/google/cloud/asset/v1/doc/google/longrunning/operations.rb
+- lib/google/cloud/asset/v1/doc/google/protobuf/any.rb
+- lib/google/cloud/asset/v1/doc/google/protobuf/struct.rb
+- lib/google/cloud/asset/v1/doc/google/protobuf/timestamp.rb
+- lib/google/cloud/asset/v1/doc/google/rpc/status.rb
+- lib/google/cloud/asset/v1/helpers.rb
 - lib/google/cloud/asset/v1beta1.rb
 - lib/google/cloud/asset/v1beta1/asset_service_client.rb
 - lib/google/cloud/asset/v1beta1/asset_service_client_config.json
@@ -133,6 +149,7 @@ files:
 - lib/google/cloud/asset/v1beta1/doc/google/protobuf/struct.rb
 - lib/google/cloud/asset/v1beta1/doc/google/protobuf/timestamp.rb
 - lib/google/cloud/asset/v1beta1/doc/google/rpc/status.rb
+- lib/google/cloud/asset/v1beta1/helpers.rb
 homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-asset
 licenses:
 - Apache-2.0
@@ -152,8 +169,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: API Client library for Cloud Asset API