google-cloud-speech 0.32.0 → 1.2.1

data/lib/google/cloud/speech/v1.rb

@@ -1,157 +0,0 @@
-# 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 "google/cloud/speech/v1/speech_client"
-require "google/cloud/speech/v1/helpers"
-
-module Google
-  module Cloud
-    module Speech
-      # rubocop:disable LineLength
-
-      ##
-      # # Ruby Client for Cloud Speech API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
-      #
-      # [Cloud Speech API][Product Documentation]:
-      # Converts audio to text by applying powerful neural network models.
-      # - [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 Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
-      # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-      #
-      # ### Installation
-      # ```
-      # $ gem install google-cloud-speech
-      # ```
-      #
-      # ### Preview
-      # #### SpeechClient
-      # ```rb
-      # require "google/cloud/speech"
-      #
-      # speech_client = Google::Cloud::Speech.new(version: :v1)
-      # language_code = "en-US"
-      # sample_rate_hertz = 44100
-      # encoding = :FLAC
-      # config = {
-      #   language_code: language_code,
-      #   sample_rate_hertz: sample_rate_hertz,
-      #   encoding: encoding
-      # }
-      # uri = "gs://bucket-name/hello.flac"
-      # audio = { uri: uri }
-      # response = speech_client.recognize(config, audio)
-      # ```
-      #
-      # ### Next Steps
-      # - Read the [Cloud Speech 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/speech
-      #
-      # ## 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.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
-      # 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 V1
-        # rubocop:enable LineLength
-
-        ##
-        # Service that implements Google Cloud Speech API.
-        #
-        # @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 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,
-            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,
-            lib_version: lib_version
-          }.select { |_, v| v != nil }
-          Google::Cloud::Speech::V1::SpeechClient.new(**kwargs)
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/speech/v1p1beta1/cloud_speech_pb.rb

@@ -1,190 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/cloud/speech/v1p1beta1/cloud_speech.proto
-
-
-require 'google/protobuf'
-
-require 'google/api/annotations_pb'
-require 'google/longrunning/operations_pb'
-require 'google/protobuf/any_pb'
-require 'google/protobuf/duration_pb'
-require 'google/protobuf/empty_pb'
-require 'google/protobuf/timestamp_pb'
-require 'google/rpc/status_pb'
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_message "google.cloud.speech.v1p1beta1.RecognizeRequest" do
-    optional :config, :message, 1, "google.cloud.speech.v1p1beta1.RecognitionConfig"
-    optional :audio, :message, 2, "google.cloud.speech.v1p1beta1.RecognitionAudio"
-  end
-  add_message "google.cloud.speech.v1p1beta1.LongRunningRecognizeRequest" do
-    optional :config, :message, 1, "google.cloud.speech.v1p1beta1.RecognitionConfig"
-    optional :audio, :message, 2, "google.cloud.speech.v1p1beta1.RecognitionAudio"
-  end
-  add_message "google.cloud.speech.v1p1beta1.StreamingRecognizeRequest" do
-    oneof :streaming_request do
-      optional :streaming_config, :message, 1, "google.cloud.speech.v1p1beta1.StreamingRecognitionConfig"
-      optional :audio_content, :bytes, 2
-    end
-  end
-  add_message "google.cloud.speech.v1p1beta1.StreamingRecognitionConfig" do
-    optional :config, :message, 1, "google.cloud.speech.v1p1beta1.RecognitionConfig"
-    optional :single_utterance, :bool, 2
-    optional :interim_results, :bool, 3
-  end
-  add_message "google.cloud.speech.v1p1beta1.RecognitionConfig" do
-    optional :encoding, :enum, 1, "google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding"
-    optional :sample_rate_hertz, :int32, 2
-    optional :audio_channel_count, :int32, 7
-    optional :enable_separate_recognition_per_channel, :bool, 12
-    optional :language_code, :string, 3
-    repeated :alternative_language_codes, :string, 18
-    optional :max_alternatives, :int32, 4
-    optional :profanity_filter, :bool, 5
-    repeated :speech_contexts, :message, 6, "google.cloud.speech.v1p1beta1.SpeechContext"
-    optional :enable_word_time_offsets, :bool, 8
-    optional :enable_word_confidence, :bool, 15
-    optional :enable_automatic_punctuation, :bool, 11
-    optional :enable_speaker_diarization, :bool, 16
-    optional :diarization_speaker_count, :int32, 17
-    optional :metadata, :message, 9, "google.cloud.speech.v1p1beta1.RecognitionMetadata"
-    optional :model, :string, 13
-    optional :use_enhanced, :bool, 14
-  end
-  add_enum "google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding" do
-    value :ENCODING_UNSPECIFIED, 0
-    value :LINEAR16, 1
-    value :FLAC, 2
-    value :MULAW, 3
-    value :AMR, 4
-    value :AMR_WB, 5
-    value :OGG_OPUS, 6
-    value :SPEEX_WITH_HEADER_BYTE, 7
-  end
-  add_message "google.cloud.speech.v1p1beta1.RecognitionMetadata" do
-    optional :interaction_type, :enum, 1, "google.cloud.speech.v1p1beta1.RecognitionMetadata.InteractionType"
-    optional :industry_naics_code_of_audio, :uint32, 3
-    optional :microphone_distance, :enum, 4, "google.cloud.speech.v1p1beta1.RecognitionMetadata.MicrophoneDistance"
-    optional :original_media_type, :enum, 5, "google.cloud.speech.v1p1beta1.RecognitionMetadata.OriginalMediaType"
-    optional :recording_device_type, :enum, 6, "google.cloud.speech.v1p1beta1.RecognitionMetadata.RecordingDeviceType"
-    optional :recording_device_name, :string, 7
-    optional :original_mime_type, :string, 8
-    optional :obfuscated_id, :int64, 9
-    optional :audio_topic, :string, 10
-  end
-  add_enum "google.cloud.speech.v1p1beta1.RecognitionMetadata.InteractionType" do
-    value :INTERACTION_TYPE_UNSPECIFIED, 0
-    value :DISCUSSION, 1
-    value :PRESENTATION, 2
-    value :PHONE_CALL, 3
-    value :VOICEMAIL, 4
-    value :PROFESSIONALLY_PRODUCED, 5
-    value :VOICE_SEARCH, 6
-    value :VOICE_COMMAND, 7
-    value :DICTATION, 8
-  end
-  add_enum "google.cloud.speech.v1p1beta1.RecognitionMetadata.MicrophoneDistance" do
-    value :MICROPHONE_DISTANCE_UNSPECIFIED, 0
-    value :NEARFIELD, 1
-    value :MIDFIELD, 2
-    value :FARFIELD, 3
-  end
-  add_enum "google.cloud.speech.v1p1beta1.RecognitionMetadata.OriginalMediaType" do
-    value :ORIGINAL_MEDIA_TYPE_UNSPECIFIED, 0
-    value :AUDIO, 1
-    value :VIDEO, 2
-  end
-  add_enum "google.cloud.speech.v1p1beta1.RecognitionMetadata.RecordingDeviceType" do
-    value :RECORDING_DEVICE_TYPE_UNSPECIFIED, 0
-    value :SMARTPHONE, 1
-    value :PC, 2
-    value :PHONE_LINE, 3
-    value :VEHICLE, 4
-    value :OTHER_OUTDOOR_DEVICE, 5
-    value :OTHER_INDOOR_DEVICE, 6
-  end
-  add_message "google.cloud.speech.v1p1beta1.SpeechContext" do
-    repeated :phrases, :string, 1
-  end
-  add_message "google.cloud.speech.v1p1beta1.RecognitionAudio" do
-    oneof :audio_source do
-      optional :content, :bytes, 1
-      optional :uri, :string, 2
-    end
-  end
-  add_message "google.cloud.speech.v1p1beta1.RecognizeResponse" do
-    repeated :results, :message, 2, "google.cloud.speech.v1p1beta1.SpeechRecognitionResult"
-  end
-  add_message "google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse" do
-    repeated :results, :message, 2, "google.cloud.speech.v1p1beta1.SpeechRecognitionResult"
-  end
-  add_message "google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata" do
-    optional :progress_percent, :int32, 1
-    optional :start_time, :message, 2, "google.protobuf.Timestamp"
-    optional :last_update_time, :message, 3, "google.protobuf.Timestamp"
-  end
-  add_message "google.cloud.speech.v1p1beta1.StreamingRecognizeResponse" do
-    optional :error, :message, 1, "google.rpc.Status"
-    repeated :results, :message, 2, "google.cloud.speech.v1p1beta1.StreamingRecognitionResult"
-    optional :speech_event_type, :enum, 4, "google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.SpeechEventType"
-  end
-  add_enum "google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.SpeechEventType" do
-    value :SPEECH_EVENT_UNSPECIFIED, 0
-    value :END_OF_SINGLE_UTTERANCE, 1
-  end
-  add_message "google.cloud.speech.v1p1beta1.StreamingRecognitionResult" do
-    repeated :alternatives, :message, 1, "google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative"
-    optional :is_final, :bool, 2
-    optional :stability, :float, 3
-    optional :result_end_time, :message, 4, "google.protobuf.Duration"
-    optional :channel_tag, :int32, 5
-    optional :language_code, :string, 6
-  end
-  add_message "google.cloud.speech.v1p1beta1.SpeechRecognitionResult" do
-    repeated :alternatives, :message, 1, "google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative"
-    optional :channel_tag, :int32, 2
-    optional :language_code, :string, 5
-  end
-  add_message "google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative" do
-    optional :transcript, :string, 1
-    optional :confidence, :float, 2
-    repeated :words, :message, 3, "google.cloud.speech.v1p1beta1.WordInfo"
-  end
-  add_message "google.cloud.speech.v1p1beta1.WordInfo" do
-    optional :start_time, :message, 1, "google.protobuf.Duration"
-    optional :end_time, :message, 2, "google.protobuf.Duration"
-    optional :word, :string, 3
-    optional :confidence, :float, 4
-    optional :speaker_tag, :int32, 5
-  end
-end
-
-module Google
-  module Cloud
-    module Speech
-      module V1p1beta1
-        RecognizeRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognizeRequest").msgclass
-        LongRunningRecognizeRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.LongRunningRecognizeRequest").msgclass
-        StreamingRecognizeRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.StreamingRecognizeRequest").msgclass
-        StreamingRecognitionConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.StreamingRecognitionConfig").msgclass
-        RecognitionConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionConfig").msgclass
-        RecognitionConfig::AudioEncoding = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding").enummodule
-        RecognitionMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionMetadata").msgclass
-        RecognitionMetadata::InteractionType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionMetadata.InteractionType").enummodule
-        RecognitionMetadata::MicrophoneDistance = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionMetadata.MicrophoneDistance").enummodule
-        RecognitionMetadata::OriginalMediaType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionMetadata.OriginalMediaType").enummodule
-        RecognitionMetadata::RecordingDeviceType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionMetadata.RecordingDeviceType").enummodule
-        SpeechContext = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.SpeechContext").msgclass
-        RecognitionAudio = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognitionAudio").msgclass
-        RecognizeResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.RecognizeResponse").msgclass
-        LongRunningRecognizeResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse").msgclass
-        LongRunningRecognizeMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata").msgclass
-        StreamingRecognizeResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.StreamingRecognizeResponse").msgclass
-        StreamingRecognizeResponse::SpeechEventType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.SpeechEventType").enummodule
-        StreamingRecognitionResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.StreamingRecognitionResult").msgclass
-        SpeechRecognitionResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.SpeechRecognitionResult").msgclass
-        SpeechRecognitionAlternative = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative").msgclass
-        WordInfo = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1p1beta1.WordInfo").msgclass
-      end
-    end
-  end
-end

data/lib/google/cloud/speech/v1p1beta1/cloud_speech_services_pb.rb

@@ -1,56 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# Source: google/cloud/speech/v1p1beta1/cloud_speech.proto for package 'google.cloud.speech.v1p1beta1'
-# Original file comments:
-# 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
-#
-#     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,
-# 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 'grpc'
-require 'google/cloud/speech/v1p1beta1/cloud_speech_pb'
-
-module Google
-  module Cloud
-    module Speech
-      module V1p1beta1
-        module Speech
-          # Service that implements Google Cloud Speech API.
-          class Service
-
-            include GRPC::GenericService
-
-            self.marshal_class_method = :encode
-            self.unmarshal_class_method = :decode
-            self.service_name = 'google.cloud.speech.v1p1beta1.Speech'
-
-            # Performs synchronous speech recognition: receive results after all audio
-            # has been sent and processed.
-            rpc :Recognize, RecognizeRequest, RecognizeResponse
-            # Performs asynchronous speech recognition: receive results via the
-            # google.longrunning.Operations interface. Returns either an
-            # `Operation.error` or an `Operation.response` which contains
-            # a `LongRunningRecognizeResponse` message.
-            rpc :LongRunningRecognize, LongRunningRecognizeRequest, Google::Longrunning::Operation
-            # Performs bidirectional streaming speech recognition: receive results while
-            # sending audio. This method is only available via the gRPC API (not REST).
-            rpc :StreamingRecognize, stream(StreamingRecognizeRequest), stream(StreamingRecognizeResponse)
-          end
-
-          Stub = Service.rpc_stub_class
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/speech/v1p1beta1/credentials.rb

@@ -1,41 +0,0 @@
-# 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 Speech
-      module V1p1beta1
-        class Credentials < Google::Auth::Credentials
-          SCOPE = [
-            "https://www.googleapis.com/auth/cloud-platform"
-          ].freeze
-          PATH_ENV_VARS = %w(SPEECH_CREDENTIALS
-                             SPEECH_KEYFILE
-                             GOOGLE_CLOUD_CREDENTIALS
-                             GOOGLE_CLOUD_KEYFILE
-                             GCLOUD_KEYFILE)
-          JSON_ENV_VARS = %w(SPEECH_CREDENTIALS_JSON
-                             SPEECH_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