google-cloud-vision 0.38.0 → 1.0.0

data/lib/google/cloud/vision/v1/text_annotation_pb.rb

@@ -1,94 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/cloud/vision/v1/text_annotation.proto
-
-
-require 'google/protobuf'
-
-require 'google/cloud/vision/v1/geometry_pb'
-require 'google/api/annotations_pb'
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_message "google.cloud.vision.v1.TextAnnotation" do
-    repeated :pages, :message, 1, "google.cloud.vision.v1.Page"
-    optional :text, :string, 2
-  end
-  add_message "google.cloud.vision.v1.TextAnnotation.DetectedLanguage" do
-    optional :language_code, :string, 1
-    optional :confidence, :float, 2
-  end
-  add_message "google.cloud.vision.v1.TextAnnotation.DetectedBreak" do
-    optional :type, :enum, 1, "google.cloud.vision.v1.TextAnnotation.DetectedBreak.BreakType"
-    optional :is_prefix, :bool, 2
-  end
-  add_enum "google.cloud.vision.v1.TextAnnotation.DetectedBreak.BreakType" do
-    value :UNKNOWN, 0
-    value :SPACE, 1
-    value :SURE_SPACE, 2
-    value :EOL_SURE_SPACE, 3
-    value :HYPHEN, 4
-    value :LINE_BREAK, 5
-  end
-  add_message "google.cloud.vision.v1.TextAnnotation.TextProperty" do
-    repeated :detected_languages, :message, 1, "google.cloud.vision.v1.TextAnnotation.DetectedLanguage"
-    optional :detected_break, :message, 2, "google.cloud.vision.v1.TextAnnotation.DetectedBreak"
-  end
-  add_message "google.cloud.vision.v1.Page" do
-    optional :property, :message, 1, "google.cloud.vision.v1.TextAnnotation.TextProperty"
-    optional :width, :int32, 2
-    optional :height, :int32, 3
-    repeated :blocks, :message, 4, "google.cloud.vision.v1.Block"
-    optional :confidence, :float, 5
-  end
-  add_message "google.cloud.vision.v1.Block" do
-    optional :property, :message, 1, "google.cloud.vision.v1.TextAnnotation.TextProperty"
-    optional :bounding_box, :message, 2, "google.cloud.vision.v1.BoundingPoly"
-    repeated :paragraphs, :message, 3, "google.cloud.vision.v1.Paragraph"
-    optional :block_type, :enum, 4, "google.cloud.vision.v1.Block.BlockType"
-    optional :confidence, :float, 5
-  end
-  add_enum "google.cloud.vision.v1.Block.BlockType" do
-    value :UNKNOWN, 0
-    value :TEXT, 1
-    value :TABLE, 2
-    value :PICTURE, 3
-    value :RULER, 4
-    value :BARCODE, 5
-  end
-  add_message "google.cloud.vision.v1.Paragraph" do
-    optional :property, :message, 1, "google.cloud.vision.v1.TextAnnotation.TextProperty"
-    optional :bounding_box, :message, 2, "google.cloud.vision.v1.BoundingPoly"
-    repeated :words, :message, 3, "google.cloud.vision.v1.Word"
-    optional :confidence, :float, 4
-  end
-  add_message "google.cloud.vision.v1.Word" do
-    optional :property, :message, 1, "google.cloud.vision.v1.TextAnnotation.TextProperty"
-    optional :bounding_box, :message, 2, "google.cloud.vision.v1.BoundingPoly"
-    repeated :symbols, :message, 3, "google.cloud.vision.v1.Symbol"
-    optional :confidence, :float, 4
-  end
-  add_message "google.cloud.vision.v1.Symbol" do
-    optional :property, :message, 1, "google.cloud.vision.v1.TextAnnotation.TextProperty"
-    optional :bounding_box, :message, 2, "google.cloud.vision.v1.BoundingPoly"
-    optional :text, :string, 3
-    optional :confidence, :float, 4
-  end
-end
-
-module Google
-  module Cloud
-    module Vision
-      module V1
-        TextAnnotation = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.TextAnnotation").msgclass
-        TextAnnotation::DetectedLanguage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.TextAnnotation.DetectedLanguage").msgclass
-        TextAnnotation::DetectedBreak = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.TextAnnotation.DetectedBreak").msgclass
-        TextAnnotation::DetectedBreak::BreakType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.TextAnnotation.DetectedBreak.BreakType").enummodule
-        TextAnnotation::TextProperty = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.TextAnnotation.TextProperty").msgclass
-        Page = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.Page").msgclass
-        Block = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.Block").msgclass
-        Block::BlockType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.Block.BlockType").enummodule
-        Paragraph = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.Paragraph").msgclass
-        Word = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.Word").msgclass
-        Symbol = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.Symbol").msgclass
-      end
-    end
-  end
-end

data/lib/google/cloud/vision/v1/web_detection_pb.rb

@@ -1,51 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/cloud/vision/v1/web_detection.proto
-
-
-require 'google/protobuf'
-
-require 'google/api/annotations_pb'
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_message "google.cloud.vision.v1.WebDetection" do
-    repeated :web_entities, :message, 1, "google.cloud.vision.v1.WebDetection.WebEntity"
-    repeated :full_matching_images, :message, 2, "google.cloud.vision.v1.WebDetection.WebImage"
-    repeated :partial_matching_images, :message, 3, "google.cloud.vision.v1.WebDetection.WebImage"
-    repeated :pages_with_matching_images, :message, 4, "google.cloud.vision.v1.WebDetection.WebPage"
-    repeated :visually_similar_images, :message, 6, "google.cloud.vision.v1.WebDetection.WebImage"
-    repeated :best_guess_labels, :message, 8, "google.cloud.vision.v1.WebDetection.WebLabel"
-  end
-  add_message "google.cloud.vision.v1.WebDetection.WebEntity" do
-    optional :entity_id, :string, 1
-    optional :score, :float, 2
-    optional :description, :string, 3
-  end
-  add_message "google.cloud.vision.v1.WebDetection.WebImage" do
-    optional :url, :string, 1
-    optional :score, :float, 2
-  end
-  add_message "google.cloud.vision.v1.WebDetection.WebPage" do
-    optional :url, :string, 1
-    optional :score, :float, 2
-    optional :page_title, :string, 3
-    repeated :full_matching_images, :message, 4, "google.cloud.vision.v1.WebDetection.WebImage"
-    repeated :partial_matching_images, :message, 5, "google.cloud.vision.v1.WebDetection.WebImage"
-  end
-  add_message "google.cloud.vision.v1.WebDetection.WebLabel" do
-    optional :label, :string, 1
-    optional :language_code, :string, 2
-  end
-end
-
-module Google
-  module Cloud
-    module Vision
-      module V1
-        WebDetection = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection").msgclass
-        WebDetection::WebEntity = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebEntity").msgclass
-        WebDetection::WebImage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebImage").msgclass
-        WebDetection::WebPage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebPage").msgclass
-        WebDetection::WebLabel = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebLabel").msgclass
-      end
-    end
-  end
-end

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

@@ -1,249 +0,0 @@
-# Copyright 2020 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 "google/cloud/vision/v1p3beta1/product_search_client"
-require "google/cloud/vision/v1p3beta1/image_annotator_client"
-require "google/cloud/vision/v1p3beta1/helpers"
-require "google/cloud/vision/v1p3beta1/image_annotator_pb"
-require "google/cloud/vision/v1p3beta1/product_search_service_pb"
-
-module Google
-  module Cloud
-    module Vision
-      # rubocop:disable LineLength
-
-      ##
-      # # Ruby Client for Cloud Vision API
-      #
-      # [Cloud Vision API][Product Documentation]:
-      # Integrates Google Vision features, including image labeling, face, logo, and
-      # landmark detection, optical character recognition (OCR), and detection of
-      # explicit content, into applications.
-      # - [Product Documentation][]
-      #
-      # ## Quick Start
-      # In order to use this library, you first need to go through the following
-      # steps:
-      #
-      # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-      # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-      # 3. [Enable the Cloud Vision API.](https://console.cloud.google.com/apis/library/vision.googleapis.com)
-      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-vision/latest/file.AUTHENTICATION.html)
-      #
-      # ### Installation
-      # ```
-      # $ gem install google-cloud-vision
-      # ```
-      #
-      # ### Preview
-      # #### ImageAnnotatorClient
-      # ```rb
-      # require "google/cloud/vision"
-      #
-      # image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1p3beta1)
-      # gcs_image_uri = "gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
-      # source = { gcs_image_uri: gcs_image_uri }
-      # image = { source: source }
-      # type = :FACE_DETECTION
-      # features_element = { type: type }
-      # features = [features_element]
-      # requests_element = { image: image, features: features }
-      # requests = [requests_element]
-      # response = image_annotator_client.batch_annotate_images(requests)
-      # ```
-      #
-      # ### Next Steps
-      # - Read the [Cloud Vision 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/googleapis/google-cloud-ruby/blob/master/README.md)
-      #   to see the full list of Cloud APIs that we cover.
-      #
-      # [Product Documentation]: https://cloud.google.com/vision
-      #
-      # ## Enabling Logging
-      #
-      # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-      # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
-      # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
-      # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
-      #
-      # Configuring a Ruby stdlib logger:
-      #
-      # ```ruby
-      # require "logger"
-      #
-      # module MyLogger
-      #   LOGGER = Logger.new $stderr, level: Logger::WARN
-      #   def logger
-      #     LOGGER
-      #   end
-      # end
-      #
-      # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-      # module GRPC
-      #   extend MyLogger
-      # end
-      # ```
-      #
-      module V1p3beta1
-        # rubocop:enable LineLength
-
-        module ProductSearch
-          ##
-          # Manages Products and ProductSets of reference images for use in product
-          # search. It uses the following resource model:
-          #
-          # * The API has a collection of {Google::Cloud::Vision::V1p3beta1::ProductSet ProductSet} resources, named
-          #   `projects/*/locations/*/productSets/*`, which acts as a way to put different
-          #   products into groups to limit identification.
-          #
-          # In parallel,
-          #
-          # * The API has a collection of {Google::Cloud::Vision::V1p3beta1::Product Product} resources, named
-          #   `projects/*/locations/*/products/*`
-          #
-          # * Each {Google::Cloud::Vision::V1p3beta1::Product Product} has a collection of {Google::Cloud::Vision::V1p3beta1::ReferenceImage ReferenceImage} resources, named
-          #   `projects/*/locations/*/products/*/referenceImages/*`
-          #
-          # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
-          #   Provides the means for authenticating requests made by the client. This parameter can
-          #   be many types.
-          #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
-          #   authenticating requests made by this client.
-          #   A `String` will be treated as the path to the keyfile to be used for the construction of
-          #   credentials for this client.
-          #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
-          #   credentials for this client.
-          #   A `GRPC::Core::Channel` will be used to make calls through.
-          #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
-          #   should already be composed with a `GRPC::Core::CallCredentials` object.
-          #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
-          #   metadata for requests, generally, to give OAuth credentials.
-          # @param scopes [Array<String>]
-          #   The OAuth scopes for this service. This parameter is ignored if
-          #   an updater_proc is supplied.
-          # @param client_config [Hash]
-          #   A Hash for call options for each method. See
-          #   Google::Gax#construct_settings for the structure of
-          #   this data. Falls back to the default config if not specified
-          #   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 service_address [String]
-          #   Override for the service hostname, or `nil` to leave as the default.
-          # @param service_port [Integer]
-          #   Override for the service port, or `nil` to leave as the default.
-          # @param exception_transformer [Proc]
-          #   An optional proc that intercepts any exceptions raised during an API call to inject
-          #   custom error handling.
-          def self.new \
-              credentials: nil,
-              scopes: nil,
-              client_config: nil,
-              timeout: nil,
-              metadata: nil,
-              service_address: nil,
-              service_port: nil,
-              exception_transformer: nil,
-              lib_name: nil,
-              lib_version: nil
-            kwargs = {
-              credentials: credentials,
-              scopes: scopes,
-              client_config: client_config,
-              timeout: timeout,
-              metadata: metadata,
-              exception_transformer: exception_transformer,
-              lib_name: lib_name,
-              service_address: service_address,
-              service_port: service_port,
-              lib_version: lib_version
-            }.select { |_, v| v != nil }
-            Google::Cloud::Vision::V1p3beta1::ProductSearchClient.new(**kwargs)
-          end
-        end
-
-        module ImageAnnotator
-          ##
-          # Service that performs Google Cloud Vision API detection tasks over client
-          # images, such as face, landmark, logo, label, and text detection. The
-          # ImageAnnotator service returns detected entities from the images.
-          #
-          # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
-          #   Provides the means for authenticating requests made by the client. This parameter can
-          #   be many types.
-          #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
-          #   authenticating requests made by this client.
-          #   A `String` will be treated as the path to the keyfile to be used for the construction of
-          #   credentials for this client.
-          #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
-          #   credentials for this client.
-          #   A `GRPC::Core::Channel` will be used to make calls through.
-          #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
-          #   should already be composed with a `GRPC::Core::CallCredentials` object.
-          #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
-          #   metadata for requests, generally, to give OAuth credentials.
-          # @param scopes [Array<String>]
-          #   The OAuth scopes for this service. This parameter is ignored if
-          #   an updater_proc is supplied.
-          # @param client_config [Hash]
-          #   A Hash for call options for each method. See
-          #   Google::Gax#construct_settings for the structure of
-          #   this data. Falls back to the default config if not specified
-          #   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 service_address [String]
-          #   Override for the service hostname, or `nil` to leave as the default.
-          # @param service_port [Integer]
-          #   Override for the service port, or `nil` to leave as the default.
-          # @param exception_transformer [Proc]
-          #   An optional proc that intercepts any exceptions raised during an API call to inject
-          #   custom error handling.
-          def self.new \
-              credentials: nil,
-              scopes: nil,
-              client_config: nil,
-              timeout: nil,
-              metadata: nil,
-              service_address: nil,
-              service_port: nil,
-              exception_transformer: nil,
-              lib_name: nil,
-              lib_version: nil
-            kwargs = {
-              credentials: credentials,
-              scopes: scopes,
-              client_config: client_config,
-              timeout: timeout,
-              metadata: metadata,
-              exception_transformer: exception_transformer,
-              lib_name: lib_name,
-              service_address: service_address,
-              service_port: service_port,
-              lib_version: lib_version
-            }.select { |_, v| v != nil }
-            Google::Cloud::Vision::V1p3beta1::ImageAnnotatorClient.new(**kwargs)
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,42 +0,0 @@
-# Copyright 2020 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 Vision
-      module V1p3beta1
-        class Credentials < Google::Auth::Credentials
-          SCOPE = [
-            "https://www.googleapis.com/auth/cloud-platform",
-            "https://www.googleapis.com/auth/cloud-vision"
-          ].freeze
-          PATH_ENV_VARS = %w(VISION_CREDENTIALS
-                             VISION_KEYFILE
-                             GOOGLE_CLOUD_CREDENTIALS
-                             GOOGLE_CLOUD_KEYFILE
-                             GCLOUD_KEYFILE)
-          JSON_ENV_VARS = %w(VISION_CREDENTIALS_JSON
-                             VISION_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/vision/v1p3beta1/doc/google/cloud/vision/v1p3beta1/geometry.rb

@@ -1,72 +0,0 @@
-# Copyright 2020 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 Vision
-      module V1p3beta1
-        # A vertex represents a 2D point in the image.
-        # NOTE: the vertex coordinates are in the same scale as the original image.
-        # @!attribute [rw] x
-        #   @return [Integer]
-        #     X coordinate.
-        # @!attribute [rw] y
-        #   @return [Integer]
-        #     Y coordinate.
-        class Vertex; end
-
-        # A vertex represents a 2D point in the image.
-        # NOTE: the normalized vertex coordinates are relative to the original image
-        # and range from 0 to 1.
-        # @!attribute [rw] x
-        #   @return [Float]
-        #     X coordinate.
-        # @!attribute [rw] y
-        #   @return [Float]
-        #     Y coordinate.
-        class NormalizedVertex; end
-
-        # A bounding polygon for the detected image annotation.
-        # @!attribute [rw] vertices
-        #   @return [Array<Google::Cloud::Vision::V1p3beta1::Vertex>]
-        #     The bounding polygon vertices.
-        # @!attribute [rw] normalized_vertices
-        #   @return [Array<Google::Cloud::Vision::V1p3beta1::NormalizedVertex>]
-        #     The bounding polygon normalized vertices.
-        class BoundingPoly; end
-
-        # A normalized bounding polygon around a portion of an image.
-        # @!attribute [rw] vertices
-        #   @return [Array<Google::Cloud::Vision::V1p3beta1::NormalizedVertex>]
-        #     Normalized vertices of the bounding polygon.
-        class NormalizedBoundingPoly; end
-
-        # A 3D position in the image, used primarily for Face detection landmarks.
-        # A valid Position must have both x and y coordinates.
-        # The position coordinates are in the same scale as the original image.
-        # @!attribute [rw] x
-        #   @return [Float]
-        #     X coordinate.
-        # @!attribute [rw] y
-        #   @return [Float]
-        #     Y coordinate.
-        # @!attribute [rw] z
-        #   @return [Float]
-        #     Z coordinate (or depth).
-        class Position; end
-      end
-    end
-  end
-end