More verbose access to alternatives.

daspecster · daspecster · commit 5844cad6bf7a · 2016-10-19T09:27:28.000-04:00
diff --git a/speech/google/cloud/speech/client.py b/speech/google/cloud/speech/client.py
@@ -405,19 +405,19 @@ def _make_request_stream(sample, language_code=None, max_alternatives=None,
                              will return a maximum of 1. Defaults to 1
 
     :type profanity_filter: bool
-    :param profanity_filter: If True, the server will attempt to filter
-                             out profanities, replacing all but the
+    :param profanity_filter: (Optional) If True, the server will attempt to
+                             filter out profanities, replacing all but the
                              initial character in each filtered word with
                              asterisks, e.g. ``'f***'``. If False or
                              omitted, profanities won't be filtered out.
 
     :type speech_context: list
-    :param speech_context: A list of strings (max 50) containing words and
-                           phrases "hints" so that the speech recognition
-                           is more likely to recognize them. This can be
-                           used to improve the accuracy for specific words
-                           and phrases. This can also be used to add new
-                           words to the vocabulary of the recognizer.
+    :param speech_context: (Optional) A list of strings (max 50) containing
+                           words and phrases "hints" so that the speech
+                           recognition is more likely to recognize them.
+                           This can be used to improve the accuracy for
+                           specific words and phrases. This can also be used to
+                           add new words to the vocabulary of the recognizer.
 
     :type single_utterance: bool
     :param single_utterance: (Optional) If false or omitted, the recognizer
diff --git a/speech/google/cloud/speech/streaming_response.py b/speech/google/cloud/speech/streaming_response.py
@@ -71,7 +71,8 @@ def confidence(self):
         :returns: Confidence score of recognized speech [0.0-1.0].
         """
         if self.results and self.results[0].alternatives:
-            return self.results[0].alternatives[0].confidence
+            top_alternative = self.results[0].alternatives[0]
+            return top_alternative.confidence
         else:
             return 0.0
 
@@ -122,7 +123,8 @@ def transcript(self):
         :returns: Transcript text from response.
         """
         if self.results and self.results[0].alternatives:
-            return self.results[0].alternatives[0].transcript
+            top_alternative = self.results[0].alternatives[0]
+            return top_alternative.transcript
         else:
             return None
 
