Skip to content

Commit

Permalink
Add quickstart sample for the Cloud Speech API. [(#658)](GoogleCloudP…
Browse files Browse the repository at this point in the history
  • Loading branch information
jmdobry authored and busunkim96 committed Sep 3, 2020
1 parent e2ec918 commit 76b89b6
Show file tree
Hide file tree
Showing 5 changed files with 96 additions and 0 deletions.
20 changes: 20 additions & 0 deletions packages/google-cloud-python-speech/samples/snippets/README.rst.in
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# This file is used to generate README.rst

product:
name: Google Cloud Speech API
short_name: Cloud Speech API
url: https://cloud.google.com/speech/docs/
description: >
The `Google Cloud Speech API`_ enables easy integration of Google speech
recognition technologies into developer applications. Send audio and receive
a text transcription from the Cloud Speech API service.

setup:
- auth
- install_deps

samples:
- name: Quickstart
file: quickstart.py

cloud_client_library: true
53 changes: 53 additions & 0 deletions packages/google-cloud-python-speech/samples/snippets/quickstart.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
#!/usr/bin/env python

# Copyright 2016 Google Inc. All Rights Reserved.
#
# 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.


def run_quickstart():
# [START speech_quickstart]
import io
import os

# Imports the Google Cloud client library
from google.cloud import speech

# Instantiates a client
speech_client = speech.Client()

# The name of the audio file to transcribe
file_name = os.path.join(
os.path.dirname(__file__),
'resources',
'audio.raw')

# Loads the audio into memory
with io.open(file_name, 'rb') as audio_file:
content = audio_file.read()
audio_sample = speech_client.sample(
content,
source_uri=None,
encoding='LINEAR16',
sample_rate=16000)

# Detects speech in the audio file
alternatives = speech_client.speech_api.sync_recognize(audio_sample)

for alternative in alternatives:
print('Transcript: {}'.format(alternative.transcript))
# [END speech_quickstart]


if __name__ == '__main__':
run_quickstart()
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Copyright 2016 Google Inc. All Rights Reserved.
#
# 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.


import quickstart


def test_quickstart(capsys):
quickstart.run_quickstart()
out, _ = capsys.readouterr()
assert 'Transcript: how old is the Brooklyn Bridge' in out
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
google-cloud-speech==0.21.0
Binary file not shown.

0 comments on commit 76b89b6

Please sign in to comment.