add audiotranscription to python SDK

Author: alexandr

README.rst

@@ -135,6 +135,22 @@ __ https://docs.scaleapi.com/#create-data-collection-task
       fields={ 'hiring_page': 'Hiring Page URL' },
     )
 
+Create audiotranscription task
+==============================
+
+Check `this`__ for further information.
+
+__ https://docs.scaleapi.com/#create-audio-transcription-task
+
+.. code-block:: python
+
+    task = client.create_audiotranscription_task(
+        callback_url='http://www.example.com/callback',
+        attachment_type='audio',
+        attachment='https://storage.googleapis.com/deepmind-media/pixie/knowing-what-to-say/second-list/speaker-3.wav',
+        verbatim=False
+    )
+
 Retrieve task
 =============
 

scaleapi/__init__.py

@@ -14,7 +14,8 @@
                                  'fields', 'choices'},
                   'annotation': {'attachment', 'attachment_type', 'instruction',
                                  'objects_to_annotate', 'with_labels', 'examples'},
-                  'datacollection': {'attachment', 'attachment_type', 'fields'}}
+                  'datacollection': {'attachment', 'attachment_type', 'fields'},
+                  'audiotranscription': {'attachment', 'attachment_type', 'verbatim'}}
 SCALE_ENDPOINT = 'https://api.scaleapi.com/v1/'
 DEFAULT_LIMIT = 100
 DEFAULT_OFFSET = 0
@@ -149,3 +150,8 @@ def create_datacollection_task(self, **kwargs):
         validate_payload('datacollection', kwargs)
         taskdata = self._postrequest('task/datacollection', payload=kwargs)
         return Task(taskdata, self)
+
+    def create_audiotranscription_task(self, **kwargs):
+        validate_payload('audiotranscription', kwargs)
+        taskdata = self._postrequest('task/audiotranscription', payload=kwargs)
+        return Task(taskdata, self)

setup.py

@@ -2,13 +2,13 @@
 setup(
     name = 'scaleapi',
     packages = ['scaleapi'],
-    version = '0.1.5',
+    version = '0.1.6',
     description = 'The official Python client library for the Scale API, the API for human labor.',
     author = 'Calvin Huang',
     author_email = 'c@lvin.me',
     url = 'https://github.com/scaleapi/scaleapi-python-client',
     download_url = 'https://github.com/scaleapi/scaleapi-python-client/tarball/0.1.2',
-    keywords = ['scale', 'scaleapi', 'humans', 'tasks', 'categorization', 'transcription', 'annotation', 'comparison', 'data collection', 'phone call'],
+    keywords = ['scale', 'scaleapi', 'humans', 'tasks', 'categorization', 'transcription', 'annotation', 'comparison', 'data collection', 'phone call', 'audio transcription'],
     install_requires = ['requests', 'enum34'],
     classifiers = ['Programming Language :: Python :: 2.7',
                    'Programming Language :: Python :: 3.5',

tests/test_client.py

@@ -134,6 +134,29 @@ def test_datacollection_fail():
             attachment_type='website')
 
 
+def test_audiotranscription_ok():
+    task = client.create_audiotranscription_task(
+        callback_url='http://www.example.com/callback',
+        attachment_type='audio',
+        attachment='https://storage.googleapis.com/deepmind-media/pixie/knowing-what-to-say/second-list/speaker-3.wav',
+        verbatim=False
+    )
+
+
+def test_audiotranscription_fail():
+    with pytest.raises(scaleapi.ScaleInvalidRequest):
+        client.create_audiotranscription_task(
+            callback_url='http://www.example.com/callback',
+            attachment_type='audio')
+
+
+def test_audiotranscription_fail2():
+    with pytest.raises(scaleapi.ScaleInvalidRequest):
+        client.create_audiotranscription_task(
+            callback_url='http://www.example.com/callback',
+            attachment='some_non_url')
+
+
 def test_cancel():
     task = make_a_task()
     # raises a scaleexception, because test tasks complete instantly