adding Conversation service

Author: jsstylos

examples/conversation_v1_experimental.py

@@ -0,0 +1,14 @@
+import json
+from watson_developer_cloud import ConversationV1Experimental
+
+
+conversation = ConversationV1Experimental(
+    username='YOUR SERVICE USERNAME',
+    password='YOUR SERVICE PASSWORD',
+    version='2016-05-09')
+
+# replace with your own workspace_id
+workspace_id = '25dfa8a0-0263-471b-8980-317e68c30488'
+
+response = conversation.message(workspace_id=workspace_id, message_input={'text': 'What\'s the weather like?'})
+print(json.dumps(response, indent=2))

watson_developer_cloud/__init__.py

@@ -20,6 +20,7 @@
 from .alchemy_vision_v1 import AlchemyVisionV1
 from .authorization_v1 import AuthorizationV1
 from .concept_insights_v2 import ConceptInsightsV2
+from .conversation_v1_experimental import ConversationV1Experimental
 from .document_conversion_v1 import DocumentConversionV1
 from .dialog_v1 import DialogV1
 from .language_translation_v2 import LanguageTranslationV2

watson_developer_cloud/conversation_v1_experimental.py

@@ -0,0 +1,45 @@
+# Copyright 2016 IBM 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.
+"""
+The Conversation v1 experimental service
+(http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/conversation.html)
+"""
+
+from .watson_developer_cloud_service import WatsonDeveloperCloudService
+
+
+class ConversationV1Experimental(WatsonDeveloperCloudService):
+    """Client for the Conversation service"""
+
+    default_url = 'https://gateway.watsonplatform.net/conversation-experimental/api'
+    latest_version = '2016-05-19'
+
+    def __init__(self, version, url=default_url, username=None, password=None, use_vcap_services=True):
+        WatsonDeveloperCloudService.__init__(
+            self, 'conversation', url, username, password, use_vcap_services)
+        self.version = version
+
+    def message(self, workspace_id, message_input, context=None):
+        """
+        Retrieves information about a specific classifier.
+        :param workspace_id: The workspace to use
+        :param message_input: The input, usually containing a text field
+        :param context: The optional context object
+        """
+
+        params = {'version': self.version}
+        data = {'input': message_input,
+                'context': context}
+        return self.request(method='POST', url='/v1/workspaces/{0}/message'.format(workspace_id), params=params,
+                            json=data, accept_json=True)