google-cloud-vision-v1p3beta1 0.1.3 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5d725cef5c7efe7de779a4695f95329f9e6dc072a6286ef24846bc8877b2323
-  data.tar.gz: c475196633214967d77da38bb5cc499b79ef3f6d8aa9bcd679c0a8d302728021
+  metadata.gz: bf2553c39fd167282677813185d60629b91fd23e6b0732513330c9a5952b12cc
+  data.tar.gz: b9797b02d3dc5477008edd5892dedb61a93ee07a0953b2a781381837677773cc
 SHA512:
-  metadata.gz: 20a621e8a1d61a407fc4e3fd5b8ae1df418b60dc95e1186800a06383d38687b2e66a0fef8d4d2ab5400e1dc2aa5a9c93e46f0a694b8f41088eab1e6d160cc6fe
-  data.tar.gz: a079bc6565cf4ed3f2fcd035f02d156031a3a6e7c35430eb7b1c3f9d59b4a36f32b0f4aedaf82603e642e6c1c79faf2b392da980c1842fc72d1d63aad676be98
+  metadata.gz: 111a0697c169cd710506122920c35d48f17b4ad1aec7ab5d46e2391ee2956619d29fe33205100f39a2cd3a5a3aa9cfbf17a4b16fdc005caff221e14482e6c48d
+  data.tar.gz: 604e29c8ad169b8d732a1ce684c02ab46efe08c7438f11d620b5e3aeeb0dbf53003a8719fdca660540b29d703b72ea5d7a03e173c9906cc2118333a42c19acf0

data/AUTHENTICATION.md

@@ -27,7 +27,7 @@ export VISION_CREDENTIALS=path/to/keyfile.json
 ```ruby
 require "google/cloud/vision/v1p3beta1"
 
-client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
+client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
 ```
 
 ## Credential Lookup
@@ -64,7 +64,7 @@ containers where writing files is difficult or not encouraged.
 
 The environment variables that google-cloud-vision-v1p3beta1
 checks for credentials are configured on the service Credentials class (such as
-{Google::Cloud::Vision::V1p3beta1::ProductSearch::Credentials}):
+{::Google::Cloud::Vision::V1p3beta1::ProductSearch::Credentials}):
 
 1. `VISION_CREDENTIALS` - Path to JSON file, or JSON contents
 2. `VISION_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/vision/v1p3beta1"
 
 ENV["VISION_CREDENTIALS"] = "path/to/keyfile.json"
 
-client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
+client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
 ```
 
 ### Configuration
@@ -88,7 +88,7 @@ environment variables. Either on an individual client initialization:
 ```ruby
 require "google/cloud/vision/v1p3beta1"
 
-client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new do |config|
+client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new do |config|
   config.credentials = "path/to/keyfile.json"
 end
 ```
@@ -98,11 +98,11 @@ Or configured globally for all clients:
 ```ruby
 require "google/cloud/vision/v1p3beta1"
 
-Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.configure do |config|
+::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.configure do |config|
   config.credentials = "path/to/keyfile.json"
 end
 
-client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
+client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
 ```
 
 ### Cloud SDK

data/README.md

@@ -25,7 +25,7 @@ In order to use this library, you first need to go through the following steps:
 ```ruby
 require "google/cloud/vision/v1p3beta1"
 
-client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
+client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
 request = my_create_request
 response = client.create_product_set request
 ```

data/lib/google/cloud/vision/v1p3beta1.rb

@@ -27,7 +27,7 @@ module Google
       # To load this package, including all its services, and instantiate a client:
       #
       #     require "google/cloud/vision/v1p3beta1"
-      #     client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
+      #     client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
       #
       module V1p3beta1
       end

data/lib/google/cloud/vision/v1p3beta1/image_annotator.rb

@@ -39,7 +39,7 @@ module Google
         # To load this service and instantiate a client:
         #
         #     require "google/cloud/vision/v1p3beta1/image_annotator"
-        #     client = Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new
+        #     client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new
         #
         module ImageAnnotator
         end

data/lib/google/cloud/vision/v1p3beta1/image_annotator/client.rb

@@ -40,15 +40,15 @@ module Google
             ##
             # Configure the ImageAnnotator Client class.
             #
-            # See {Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
+            # See {::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
             # for a description of the configuration fields.
             #
             # ## Example
             #
             # To modify the configuration for all ImageAnnotator clients:
             #
-            #     Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
-            #       config.timeout = 10_000
+            #     ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the Client client.
@@ -96,7 +96,7 @@ module Google
             # but structural changes (adding new fields, etc.) are not allowed. Structural changes
             # should be made on {Client.configure}.
             #
-            # See {Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
+            # See {::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
             # for a description of the configuration fields.
             #
             # @yield [config] Configure the Client client.
@@ -117,13 +117,13 @@ module Google
             # To create a new ImageAnnotator client with the default
             # configuration:
             #
-            #     client = Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new
+            #     client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new
             #
             # To create a new ImageAnnotator client with a custom
             # configuration:
             #
-            #     client = Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
-            #       config.timeout = 10_000
+            #     client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the ImageAnnotator client.
@@ -148,14 +148,16 @@ module Google
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
-              @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
+              @quota_project_id = @config.quota_project
+              @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
               @operations_client = Operations.new do |config|
                 config.credentials = credentials
+                config.endpoint = @config.endpoint
               end
 
-              @image_annotator_stub = Gapic::ServiceStub.new(
-                Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Stub,
+              @image_annotator_stub = ::Gapic::ServiceStub.new(
+                ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Stub,
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
@@ -163,6 +165,13 @@ module Google
               )
             end
 
+            ##
+            # Get the associated client for long-running operations.
+            #
+            # @return [::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Operations]
+            #
+            attr_reader :operations_client
+
             # Service calls
 
             ##
@@ -170,12 +179,12 @@ module Google
             #
             # @overload batch_annotate_images(request, options = nil)
             #   Pass arguments to `batch_annotate_images` via a request object, either of type
-            #   {Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest} or an equivalent Hash.
+            #   {::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest} or an equivalent Hash.
             #
-            #   @param request [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest, Hash]
+            #   @param request [::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest, ::Hash]
             #     A request object representing the call parameters. Required. To specify no
             #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload batch_annotate_images(requests: nil)
@@ -183,30 +192,30 @@ module Google
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
-            #   @param requests [Array<Google::Cloud::Vision::V1p3beta1::AnnotateImageRequest, Hash>]
+            #   @param requests [::Array<::Google::Cloud::Vision::V1p3beta1::AnnotateImageRequest, ::Hash>]
             #     Individual image annotation requests for this batch.
             #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
+            # @return [::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def batch_annotate_images request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.batch_annotate_images.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Vision::V1p3beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -221,8 +230,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -235,12 +244,12 @@ module Google
             #
             # @overload async_batch_annotate_files(request, options = nil)
             #   Pass arguments to `async_batch_annotate_files` via a request object, either of type
-            #   {Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest} or an equivalent Hash.
+            #   {::Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest} or an equivalent Hash.
             #
-            #   @param request [Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest, Hash]
+            #   @param request [::Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest, ::Hash]
             #     A request object representing the call parameters. Required. To specify no
             #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload async_batch_annotate_files(requests: nil)
@@ -248,30 +257,30 @@ module Google
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
-            #   @param requests [Array<Google::Cloud::Vision::V1p3beta1::AsyncAnnotateFileRequest, Hash>]
+            #   @param requests [::Array<::Google::Cloud::Vision::V1p3beta1::AsyncAnnotateFileRequest, ::Hash>]
             #     Required. Individual async file annotation requests for this batch.
             #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Gapic::Operation]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Gapic::Operation]
+            # @return [::Gapic::Operation]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def async_batch_annotate_files request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.async_batch_annotate_files.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Vision::V1p3beta1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -283,12 +292,12 @@ module Google
                                      retry_policy: @config.retry_policy
 
               @image_annotator_stub.call_rpc :async_batch_annotate_files, request, options: options do |response, operation|
-                response = Gapic::Operation.new response, @operations_client, options: options
+                response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -298,7 +307,7 @@ module Google
             # providing control over timeouts, retry behavior, logging, transport
             # parameters, and other low-level controls. Certain parameters can also be
             # applied individually to specific RPCs. See
-            # {Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration::Rpcs}
+            # {::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration::Rpcs}
             # for a list of RPCs that can be configured independently.
             #
             # Configuration can be applied globally to all clients, or to a single client
@@ -309,22 +318,22 @@ module Google
             # To modify the global config, setting the timeout for batch_annotate_images
             # to 20 seconds, and all remaining timeouts to 10 seconds:
             #
-            #     Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.batch_annotate_images.timeout = 20_000
+            #     ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.batch_annotate_images.timeout = 20.0
             #     end
             #
             # To apply the above configuration only to a new client:
             #
-            #     client = Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.batch_annotate_images.timeout = 20_000
+            #     client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.batch_annotate_images.timeout = 20.0
             #     end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
             #   Defaults to `"vision.googleapis.com"`.
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] credentials
             #   Credentials to send with calls. You may provide any of the following types:
             #    *  (`String`) The path to a service account key file in JSON format
@@ -336,29 +345,29 @@ module Google
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
-            #   @return [Object]
+            #   @return [::Object]
             # @!attribute [rw] scope
             #   The OAuth scopes
-            #   @return [Array<String>]
+            #   @return [::Array<::String>]
             # @!attribute [rw] lib_name
             #   The library name as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] lib_version
             #   The library version as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] channel_args
             #   Extra parameters passed to the gRPC channel. Note: this is ignored if a
             #   `GRPC::Core::Channel` object is provided as the credential.
-            #   @return [Hash]
+            #   @return [::Hash]
             # @!attribute [rw] interceptors
             #   An array of interceptors that are run before calls are executed.
-            #   @return [Array<GRPC::ClientInterceptor>]
+            #   @return [::Array<::GRPC::ClientInterceptor>]
             # @!attribute [rw] timeout
-            #   The call timeout in milliseconds.
-            #   @return [Numeric]
+            #   The call timeout in seconds.
+            #   @return [::Numeric]
             # @!attribute [rw] metadata
             #   Additional gRPC headers to be sent with the call.
-            #   @return [Hash{Symbol=>String}]
+            #   @return [::Hash{::Symbol=>::String}]
             # @!attribute [rw] retry_policy
             #   The retry policy. The value is a hash with the following keys:
             #    *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
@@ -366,25 +375,29 @@ module Google
             #    *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
             #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
             #       trigger a retry.
-            #   @return [Hash]
+            #   @return [::Hash]
+            # @!attribute [rw] quota_project
+            #   A separate project against which to charge quota.
+            #   @return [::String]
             #
             class Configuration
-              extend Gapic::Config
+              extend ::Gapic::Config
 
-              config_attr :endpoint,     "vision.googleapis.com", String
-              config_attr :credentials,  nil do |value|
+              config_attr :endpoint,      "vision.googleapis.com", ::String
+              config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
-              config_attr :scope,        nil, String, Array, nil
-              config_attr :lib_name,     nil, String, nil
-              config_attr :lib_version,  nil, String, nil
-              config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
-              config_attr :interceptors, nil, Array, nil
-              config_attr :timeout,      nil, Numeric, nil
-              config_attr :metadata,     nil, Hash, nil
-              config_attr :retry_policy, nil, Hash, Proc, nil
+              config_attr :scope,         nil, ::String, ::Array, nil
+              config_attr :lib_name,      nil, ::String, nil
+              config_attr :lib_version,   nil, ::String, nil
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr :interceptors,  nil, ::Array, nil
+              config_attr :timeout,       nil, ::Numeric, nil
+              config_attr :metadata,      nil, ::Hash, nil
+              config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
+              config_attr :quota_project, nil, ::String, nil
 
               # @private
               def initialize parent_config = nil
@@ -400,7 +413,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -425,21 +438,21 @@ module Google
               class Rpcs
                 ##
                 # RPC-specific configuration for `batch_annotate_images`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :batch_annotate_images
                 ##
                 # RPC-specific configuration for `async_batch_annotate_files`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :async_batch_annotate_files
 
                 # @private
                 def initialize parent_rpcs = nil
                   batch_annotate_images_config = parent_rpcs&.batch_annotate_images if parent_rpcs&.respond_to? :batch_annotate_images
-                  @batch_annotate_images = Gapic::Config::Method.new batch_annotate_images_config
+                  @batch_annotate_images = ::Gapic::Config::Method.new batch_annotate_images_config
                   async_batch_annotate_files_config = parent_rpcs&.async_batch_annotate_files if parent_rpcs&.respond_to? :async_batch_annotate_files
-                  @async_batch_annotate_files = Gapic::Config::Method.new async_batch_annotate_files_config
+                  @async_batch_annotate_files = ::Gapic::Config::Method.new async_batch_annotate_files_config
 
                   yield self if block_given?
                 end