google-cloud-speech 0.29.0 → 0.30.0

metadata

@@ -1,30 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-speech
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
-- Mike Moore
-- Chris Smith
+- Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-28 00:00:00.000000000 Z
+date: 2018-06-21 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: google-cloud-core
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: google-gax
   requirement: !ruby/object:Gem::Requirement
@@ -53,62 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.10'
-- !ruby/object:Gem::Dependency
-  name: minitest-autotest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: minitest-focus
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-- !ruby/object:Gem::Dependency
-  name: minitest-rg
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
-- !ruby/object:Gem::Dependency
-  name: autotest-suffix
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -137,38 +66,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: yard-doctest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<="
-      - !ruby/object:Gem::Version
-        version: 0.1.8
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<="
-      - !ruby/object:Gem::Version
-        version: 0.1.8
-description: google-cloud-speech is the official library for Google Cloud Speech API.
-email:
-- mike@blowmage.com
-- quartzmo@gmail.com
+description: google-cloud-speech is the official library for Cloud Speech API.
+email: googleapis-packages@google.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -176,32 +75,42 @@ files:
 - ".yardopts"
 - LICENSE
 - README.md
-- lib/google-cloud-speech.rb
 - lib/google/cloud/speech.rb
-- lib/google/cloud/speech/audio.rb
-- lib/google/cloud/speech/convert.rb
-- lib/google/cloud/speech/credentials.rb
-- lib/google/cloud/speech/operation.rb
-- lib/google/cloud/speech/project.rb
-- lib/google/cloud/speech/result.rb
-- lib/google/cloud/speech/service.rb
-- lib/google/cloud/speech/stream.rb
 - lib/google/cloud/speech/v1.rb
 - lib/google/cloud/speech/v1/cloud_speech_pb.rb
 - lib/google/cloud/speech/v1/cloud_speech_services_pb.rb
+- lib/google/cloud/speech/v1/credentials.rb
 - lib/google/cloud/speech/v1/doc/google/cloud/speech/v1/cloud_speech.rb
+- lib/google/cloud/speech/v1/doc/google/longrunning/operations.rb
 - lib/google/cloud/speech/v1/doc/google/protobuf/any.rb
 - lib/google/cloud/speech/v1/doc/google/protobuf/duration.rb
 - lib/google/cloud/speech/v1/doc/google/rpc/status.rb
 - lib/google/cloud/speech/v1/doc/overview.rb
+- lib/google/cloud/speech/v1/helpers.rb
 - lib/google/cloud/speech/v1/speech_client.rb
 - lib/google/cloud/speech/v1/speech_client_config.json
-- lib/google/cloud/speech/version.rb
-homepage: https://github.com/GoogleCloudPlatform/google-cloud-ruby/tree/master/google-cloud-speech
+- lib/google/cloud/speech/v1/stream.rb
+- lib/google/cloud/speech/v1p1beta1.rb
+- lib/google/cloud/speech/v1p1beta1/cloud_speech_pb.rb
+- lib/google/cloud/speech/v1p1beta1/cloud_speech_services_pb.rb
+- lib/google/cloud/speech/v1p1beta1/credentials.rb
+- lib/google/cloud/speech/v1p1beta1/doc/google/cloud/speech/v1p1beta1/cloud_speech.rb
+- lib/google/cloud/speech/v1p1beta1/doc/google/longrunning/operations.rb
+- lib/google/cloud/speech/v1p1beta1/doc/google/protobuf/any.rb
+- lib/google/cloud/speech/v1p1beta1/doc/google/protobuf/duration.rb
+- lib/google/cloud/speech/v1p1beta1/doc/google/rpc/status.rb
+- lib/google/cloud/speech/v1p1beta1/doc/overview.rb
+- lib/google/cloud/speech/v1p1beta1/helpers.rb
+- lib/google/cloud/speech/v1p1beta1/speech_client.rb
+- lib/google/cloud/speech/v1p1beta1/speech_client_config.json
+- lib/google/cloud/speech/v1p1beta1/stream.rb
+homepage: https://github.com/googleapis/googleapis
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message: 'The 0.30.0 release introduced breaking changes relative to
+  the previous release, 0.29.0. For more details and instructions to migrate your
+  code, please visit the migration guide: https://cloud.google.com/speech-to-text/docs/ruby-client-migration.'
 rdoc_options: []
 require_paths:
 - lib
@@ -217,8 +126,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
-summary: API Client library for Google Cloud Speech API
+summary: API Client library for Cloud Speech API
 test_files: []

data/lib/google-cloud-speech.rb

@@ -1,142 +0,0 @@
-# Copyright 2016 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.
-
-##
-# This file is here to be autorequired by bundler, so that the
-# Google::Cloud.speech and Google::Cloud#speech methods can be available, but
-# the library and all dependencies won't be loaded until required and used.
-
-
-gem "google-cloud-core"
-require "google/cloud"
-require "google/cloud/config"
-require "googleauth"
-
-module Google
-  module Cloud
-    ##
-    # Creates a new object for connecting to the Speech service.
-    # Each call creates a new connection.
-    #
-    # For more information on connecting to Google Cloud see the [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
-    #
-    # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
-    #   set of resources and operations that the connection can access. See
-    #   [Using OAuth 2.0 to Access Google
-    #   APIs](https://developers.google.com/identity/protocols/OAuth2).
-    #
-    #   The default scope is:
-    #
-    #   * `https://www.googleapis.com/auth/speech`
-    # @param [Integer] timeout Default timeout to use in requests. Optional.
-    # @param [Hash] client_config A hash of values to override the default
-    #   behavior of the API client. Optional.
-    #
-    # @return [Google::Cloud::Speech::Project]
-    #
-    # @example
-    #   require "google/cloud"
-    #
-    #   gcloud = Google::Cloud.new
-    #   speech = gcloud.speech
-    #
-    #   audio = speech.audio "path/to/audio.raw",
-    #                        encoding: :linear16,
-    #                        language: "en-US",
-    #                        sample_rate: 16000
-    #
-    # @example The default scope can be overridden with the `scope` option:
-    #   require "google/cloud"
-    #
-    #   gcloud  = Google::Cloud.new
-    #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
-    #   speech = gcloud.speech scope: platform_scope
-    #
-    def speech scope: nil, timeout: nil, client_config: nil
-      Google::Cloud.speech @project, @keyfile, scope: scope,
-                                               timeout: (timeout || @timeout),
-                                               client_config: client_config
-    end
-
-    ##
-    # Creates a new object for connecting to the Speech service.
-    # Each call creates a new connection.
-    #
-    # For more information on connecting to Google Cloud see the [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
-    #
-    # @param [String] project_id Project identifier for the Speech service
-    #   you are connecting to. If not present, the default project for the
-    #   credentials is used.
-    # @param [String, Hash, Google::Auth::Credentials] credentials The path to
-    #   the keyfile as a String, the contents of the keyfile as a Hash, or a
-    #   Google::Auth::Credentials object. (See {Speech::Credentials})
-    # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
-    #   set of resources and operations that the connection can access. See
-    #   [Using OAuth 2.0 to Access Google
-    #   APIs](https://developers.google.com/identity/protocols/OAuth2).
-    #
-    #   The default scope is:
-    #
-    #   * `https://www.googleapis.com/auth/speech`
-    # @param [Integer] timeout Default timeout to use in requests. Optional.
-    # @param [Hash] client_config A hash of values to override the default
-    #   behavior of the API client. Optional.
-    #
-    # @return [Google::Cloud::Speech::Project]
-    #
-    # @example
-    #   require "google/cloud"
-    #
-    #   speech = Google::Cloud.speech
-    #
-    #   audio = speech.audio "path/to/audio.raw",
-    #                        encoding: :linear16,
-    #                        language: "en-US",
-    #                        sample_rate: 16000
-    #
-    def self.speech project_id = nil, credentials = nil, scope: nil,
-                    timeout: nil, client_config: nil
-      require "google/cloud/speech"
-      Google::Cloud::Speech.new project_id: project_id,
-                                credentials: credentials,
-                                scope: scope, timeout: timeout,
-                                client_config: client_config
-    end
-  end
-end
-
-# Set the default speech configuration
-Google::Cloud.configure.add_config! :speech do |config|
-  default_project = Google::Cloud::Config.deferred do
-    ENV["SPEECH_PROJECT"]
-  end
-  default_creds = Google::Cloud::Config.deferred do
-    Google::Cloud::Config.credentials_from_env(
-      "SPEECH_CREDENTIALS", "SPEECH_CREDENTIALS_JSON",
-      "SPEECH_KEYFILE", "SPEECH_KEYFILE_JSON"
-    )
-  end
-
-  config.add_field! :project_id, default_project, match: String, allow_nil: true
-  config.add_alias! :project, :project_id
-  config.add_field! :credentials, default_creds,
-                    match: [String, Hash, Google::Auth::Credentials],
-                    allow_nil: true
-  config.add_alias! :keyfile, :credentials
-  config.add_field! :scope, nil, match: [String, Array]
-  config.add_field! :timeout, nil, match: Integer
-  config.add_field! :client_config, nil, match: Hash
-end

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

@@ -1,330 +0,0 @@
-# Copyright 2016 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 Speech
-      ##
-      # # Audio
-      #
-      # Represents a source of audio data, with related metadata such as the
-      # [audio encoding](https://cloud.google.com/speech/docs/basics#audio-encodings),
-      # [sample rate](https://cloud.google.com/speech/docs/basics#sample-rates),
-      # and [language](https://cloud.google.com/speech/docs/basics#languages).
-      #
-      # See {Project#audio}.
-      #
-      # @see https://cloud.google.com/speech/docs/basics#audio-encodings
-      #   Audio Encodings
-      # @see https://cloud.google.com/speech/docs/basics#sample-rates
-      #   Sample Rates
-      # @see https://cloud.google.com/speech/docs/basics#languages
-      #   Languages
-      #
-      # @example
-      #   require "google/cloud/speech"
-      #
-      #   speech = Google::Cloud::Speech.new
-      #
-      #   audio = speech.audio "path/to/audio.raw",
-      #                        encoding: :linear16,
-      #                        language: "en-US",
-      #                        sample_rate: 16000
-      #
-      #   results = audio.recognize
-      #   result = results.first
-      #   result.transcript #=> "how old is the Brooklyn Bridge"
-      #   result.confidence #=> 0.9826789498329163
-      #
-      class Audio
-        # @private The V1::RecognitionAudio object.
-        attr_reader :grpc
-        # @private The Project object.
-        attr_reader :speech
-
-        ##
-        # Encoding of audio data to be recognized.
-        #
-        #   Acceptable values are:
-        #
-        #   * `linear16` - Uncompressed 16-bit signed little-endian samples.
-        #     (LINEAR16)
-        #   * `flac` - The [Free Lossless Audio
-        #     Codec](http://flac.sourceforge.net/documentation.html) encoding.
-        #     Only 16-bit samples are supported. Not all fields in STREAMINFO
-        #     are supported. (FLAC)
-        #   * `mulaw` - 8-bit samples that compand 14-bit audio samples using
-        #     G.711 PCMU/mu-law. (MULAW)
-        #   * `amr` - Adaptive Multi-Rate Narrowband codec. (`sample_rate` must
-        #     be 8000 Hz.) (AMR)
-        #   * `amr_wb` - Adaptive Multi-Rate Wideband codec. (`sample_rate` must
-        #     be 16000 Hz.) (AMR_WB)
-        #   * `ogg_opus` - Ogg Mapping for Opus. (OGG_OPUS)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription.
-        #   * `speex` - Speex with header byte. (SPEEX_WITH_HEADER_BYTE)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription. If you must use a low-bitrate encoder,
-        #     OGG_OPUS is preferred.
-        #
-        # @return [String,Symbol]
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "path/to/audio.raw",
-        #                        language: "en-US",
-        #                        sample_rate: 16000
-        #
-        #   audio.encoding = :linear16
-        #   audio.encoding #=> :linear16
-        #
-        attr_accessor :encoding
-
-        ##
-        # The language of the supplied audio as a
-        # [BCP-47](https://tools.ietf.org/html/bcp47) language code. e.g.
-        # "en-US" for English (United States), "en-GB" for English (United
-        # Kingdom), "fr-FR" for French (France). See [Language
-        # Support](https://cloud.google.com/speech/docs/languages) for a list of
-        # the currently supported language codes.
-        #
-        # @return [String,Symbol]
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "path/to/audio.raw",
-        #                        encoding: :linear16,
-        #                        sample_rate: 16000
-        #
-        #   audio.language = "en-US"
-        #   audio.language #=> "en-US"
-        #
-        attr_accessor :language
-
-        ##
-        # Sample rate in Hertz of the audio data to be recognized. Valid values
-        # are: 8000-48000. 16000 is optimal. For best results, set the sampling
-        # rate of the audio source to 16000 Hz. If that's not possible, use the
-        # native sample rate of the audio source (instead of re-sampling).
-        #
-        # @return [Integer]
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "path/to/audio.raw",
-        #                        encoding: :linear16,
-        #                        language: "en-US"
-        #
-        #   audio.sample_rate = 16000
-        #   audio.sample_rate #=> 16000
-        #
-        attr_accessor :sample_rate
-
-        ##
-        # @private Creates a new Audio instance.
-        def initialize
-          @grpc = V1::RecognitionAudio.new
-        end
-
-        ##
-        # @private Whether the Audio has content.
-        #
-        def content?
-          @grpc.audio_source == :content
-        end
-
-        ##
-        # @private Whether the Audio is a URL.
-        #
-        def url?
-          @grpc.audio_source == :uri
-        end
-
-        ##
-        # Performs synchronous speech recognition. Sends audio data to the
-        # Speech API, which performs recognition on that data, and returns
-        # results only after all audio has been processed. Limited to audio data
-        # of 1 minute or less in duration.
-        #
-        # The Speech API will take roughly the same amount of time to process
-        # audio data sent synchronously as the duration of the supplied audio
-        # data. That is, if you send audio data of 30 seconds in length, expect
-        # the synchronous request to take approximately 30 seconds to return
-        # results.
-        #
-        # @see https://cloud.google.com/speech/docs/basics#synchronous-recognition
-        #   Synchronous Speech API Recognition
-        # @see https://cloud.google.com/speech/docs/basics#phrase-hints
-        #   Phrase Hints
-        #
-        # @param [String] max_alternatives The Maximum number of recognition
-        #   hypotheses to be returned. Default is 1. The service may return
-        #   fewer. Valid values are 0-30. Defaults to 1. Optional.
-        # @param [Boolean] profanity_filter When `true`, the service will
-        #   attempt to filter out profanities, replacing all but the initial
-        #   character in each filtered word with asterisks, e.g. "f***". Default
-        #   is `false`.
-        # @param [Array<String>] phrases A list of strings containing words and
-        #   phrases "hints" so that the speech recognition is more likely to
-        #   recognize them. See [usage
-        #   limits](https://cloud.google.com/speech/limits#content). Optional.
-        # @param [Boolean] words When `true`, return a list of words with
-        #   additional information about each word. Currently, the only
-        #   additional information provided is the the start and end time
-        #   offsets. See {Result#words}. Default is `false`.
-        #
-        # @return [Array<Result>] The transcribed text of audio recognized.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "path/to/audio.raw",
-        #                        encoding: :linear16,
-        #                        language: "en-US",
-        #                        sample_rate: 16000
-        #
-        #   results = audio.recognize
-        #   result = results.first
-        #   result.transcript #=> "how old is the Brooklyn Bridge"
-        #   result.confidence #=> 0.9826789498329163
-        #
-        def recognize max_alternatives: nil, profanity_filter: nil,
-                      phrases: nil, words: nil
-          ensure_speech!
-
-          speech.recognize self, encoding: encoding, sample_rate: sample_rate,
-                                 language: language,
-                                 max_alternatives: max_alternatives,
-                                 profanity_filter: profanity_filter,
-                                 phrases: phrases, words: words
-        end
-
-        ##
-        # Performs asynchronous speech recognition. Requests are processed
-        # asynchronously, meaning a Operation is returned once the audio data
-        # has been sent, and can be refreshed to retrieve recognition results
-        # once the audio data has been processed.
-        #
-        # @see https://cloud.google.com/speech/docs/basics#async-responses
-        #   Asynchronous Speech API Responses
-        #
-        # @param [String] max_alternatives The Maximum number of recognition
-        #   hypotheses to be returned. Default is 1. The service may return
-        #   fewer. Valid values are 0-30. Defaults to 1. Optional.
-        # @param [Boolean] profanity_filter When `true`, the service will
-        #   attempt to filter out profanities, replacing all but the initial
-        #   character in each filtered word with asterisks, e.g. "f***". Default
-        #   is `false`.
-        # @param [Array<String>] phrases A list of strings containing words and
-        #   phrases "hints" so that the speech recognition is more likely to
-        #   recognize them. See [usage
-        #   limits](https://cloud.google.com/speech/limits#content). Optional.
-        # @param [Boolean] words When `true`, return a list of words with
-        #   additional information about each word. Currently, the only
-        #   additional information provided is the the start and end time
-        #   offsets. See {Result#words}. Default is `false`.
-        #
-        # @return [Operation] A resource represents the long-running,
-        #   asynchronous processing of a speech-recognition operation.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "path/to/audio.raw",
-        #                        encoding: :linear16,
-        #                        language: "en-US",
-        #                        sample_rate: 16000
-        #
-        #   op = audio.process
-        #   op.done? #=> false
-        #   op.reload!
-        #   op.done? #=> true
-        #   results = op.results
-        #
-        def process max_alternatives: nil, profanity_filter: nil,
-                    phrases: nil, words: nil
-          ensure_speech!
-
-          speech.process self, encoding: encoding,
-                               sample_rate: sample_rate,
-                               language: language,
-                               max_alternatives: max_alternatives,
-                               profanity_filter: profanity_filter,
-                               phrases: phrases, words: words
-        end
-        alias long_running_recognize process
-        alias recognize_job process
-
-        ##
-        # @private The Google API Client object for the Audio.
-        def to_grpc
-          @grpc
-        end
-
-        ##
-        # @private New Audio from a source object.
-        def self.from_source source, speech
-          audio = new
-          audio.instance_variable_set :@speech, speech
-          if source.respond_to?(:read) && source.respond_to?(:rewind)
-            source.rewind
-            audio.grpc.content = source.read
-            return audio
-          end
-          # Convert Storage::File objects to the URL
-          source = source.to_gs_url if source.respond_to? :to_gs_url
-          # Everything should be a string from now on
-          source = String source
-          # Create an Audio from the Google Storage URL
-          if source.start_with? "gs://"
-            audio.grpc.uri = source
-            return audio
-          end
-          # Create an audio from a file on the filesystem
-          if File.file? source
-            raise ArgumentError, "Cannot read #{source}" unless \
-              File.readable? source
-            audio.grpc.content = File.read source, mode: "rb"
-            return audio
-          end
-          raise ArgumentError, "Unable to convert #{source} to an Audio"
-        end
-
-        protected
-
-        ##
-        # Raise an error unless an active Speech Project object is available.
-        def ensure_speech!
-          raise "Must have active connection" unless @speech
-        end
-      end
-    end
-  end
-end