chore(examples): Add IAM authentication to examples

Author: ehdsouza

examples/assistant_v1.py

@@ -5,8 +5,17 @@
 assistant = AssistantV1(
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD',
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://gateway.watsonplatform.net/assistant/api',
     version='2017-04-21')
 
+## If service instance provides API key authentication
+# assistant = AssistantV1(
+#     version='2017-04-21',
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/assistant/api',
+#     iam_api_key='your_api_key')
+
 #########################
 # Workspaces
 #########################

examples/conversation_v1.py

@@ -5,8 +5,18 @@
 conversation = ConversationV1(
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD',
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://gateway.watsonplatform.net/conversation/api',
     version='2018-02-16')
 
+## If service instance provides API key authentication
+# conversation = ConversationV1(
+#     version='2018-02-16',
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/conversation/api',
+#     iam_api_key='your_api_key')
+
+
 # When you send multiple requests for the same conversation, include the
 # context object from the previous response.
 # response = conversation.message(workspace_id=workspace_id, message_input={

examples/discovery_v1.py

@@ -5,9 +5,18 @@
 
 discovery = DiscoveryV1(
     version='2017-10-16',
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://gateway.watsonplatform.net/discovery/api',
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD')
 
+## If service instance provides API key authentication
+# discovery = DiscoveryV1(
+#     version='2017-10-16',
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/discovery/api',
+#     iam_api_key='your_api_key')
+
 environments = discovery.list_environments()
 print(json.dumps(environments, indent=2))
 

examples/natural_language_classifier_v1.py

@@ -6,9 +6,17 @@
 from watson_developer_cloud import NaturalLanguageClassifierV1
 
 natural_language_classifier = NaturalLanguageClassifierV1(
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://gateway.watsonplatform.net/natural-language-classifier/api',
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD')
 
+## If service instance provides API key authentication
+# natural_language_classifier = NaturalLanguageClassifierV1(
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/natural-language-classifier/api',
+#     iam_api_key='your_api_key')
+
 classifiers = natural_language_classifier.list_classifiers()
 print(json.dumps(classifiers, indent=2))
 

examples/natural_language_understanding_v1.py

@@ -6,9 +6,18 @@
 
 natural_language_understanding = NaturalLanguageUnderstandingV1(
     version='2017-02-27',
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://gateway.watsonplatform.net/natural-language-understanding/api',
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD')
 
+## If service instance provides API key authentication
+# natural_language_understanding = NaturalLanguageUnderstandingV1(
+#     version='2017-02-27',
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/natural-language-understanding/api',
+#     iam_api_key='your_api_key')
+
 response = natural_language_understanding.analyze(
     text='Bruce Banner is the Hulk and Bruce Wayne is BATMAN! '
          'Superman fears not Banner, but Wayne.',

examples/personality_insights_v3.py

@@ -9,9 +9,18 @@
 
 personality_insights = PersonalityInsightsV3(
     version='2016-10-20',
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://gateway.watsonplatform.net/personality-insights/api',
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD')
 
+## If service instance provides API key authentication
+# personality_insights = PersonalityInsightsV3(
+#     version='2016-10-20',
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/personality-insights/api',
+#     iam_api_key='your_api_key')
+
 with open(join(dirname(__file__), '../resources/personality-v3.json')) as \
         profile_json:
     profile = personality_insights.profile(

examples/speech_to_text_v1.py

@@ -9,6 +9,12 @@
     password='YOUR SERVICE PASSWORD',
     url='https://stream.watsonplatform.net/speech-to-text/api')
 
+## If service instance provides API key authentication
+# speech_to_text = SpeechToTextV1(
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://stream.watsonplatform.net/speech-to-text/api',
+#     iam_api_key='your_api_key')
+
 print(json.dumps(speech_to_text.list_models(), indent=2))
 
 print(json.dumps(speech_to_text.get_model('en-US_BroadbandModel'), indent=2))

examples/text_to_speech_v1.py

@@ -5,9 +5,17 @@
 from watson_developer_cloud import TextToSpeechV1
 
 text_to_speech = TextToSpeechV1(
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://stream.watsonplatform.net/text-to-speech/api,
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD')
 
+## If service instance provides API key authentication
+# text_to_speech = TextToSpeechV1(
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://stream.watsonplatform.net/text-to-speech/api',
+#     iam_api_key='your_api_key')
+
 print(json.dumps(text_to_speech.list_voices(), indent=2))
 
 with open(join(dirname(__file__), '../resources/output.wav'),

examples/tone_analyzer_v3.py

@@ -5,10 +5,19 @@
 from watson_developer_cloud.tone_analyzer_v3 import ToneInput
 
 tone_analyzer = ToneAnalyzerV3(
+    ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+    # url='https://gateway.watsonplatform.net/tone-analyzer/api',
     username='YOUR SERVICE USERNAME',
     password='YOUR SERVICE PASSWORD',
     version='2017-09-26')
 
+## If service instance provides API key authentication
+# tone_analyzer = ToneAnalyzerV3(
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/tone-analyzer/api',
+#     version='2017-09-26',
+#     iam_api_key='your_api_key')
+
 print("\ntone_chat() example 1:\n")
 utterances = [{'text': 'I am very happy.', 'user': 'glenn'},
               {'text': 'It is a good day.', 'user': 'glenn'}]

examples/visual_recognition_v3.py

@@ -6,7 +6,17 @@
 test_url = 'https://www.ibm.com/ibm/ginni/images' \
            '/ginni_bio_780x981_v4_03162016.jpg'
 
-visual_recognition = VisualRecognitionV3('2016-05-20', api_key='YOUR API KEY')
+visual_recognition = VisualRecognitionV3('2016-05-20',
+                                         ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+                                         #  url='https://gateway.watsonplatform.net/visual-recognition/api',
+                                         api_key='YOUR API KEY')
+
+## If service instance provides IAM API key authentication
+# visual_recognition = VisualRecognitionV3(
+#     '2016-05-20',
+#     ## url is optional, and defaults to the URL below. Use the correct URL for your region.
+#     url='https://gateway.watsonplatform.net/visual-recognition/api',
+#     iam_api_key='your_api_key')
 
 # with open(join(dirname(__file__), '../resources/cars.zip'), 'rb') as cars, \
 #        open(join(dirname(__file__), '../resources/trucks.zip'), 'rb') as