Allow passing alternative converter

Author: Laurynas Butkus

convertapi/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.1.1'
+__version__ = '1.2.0'
 
 from .exceptions import *
 from .client import Client

convertapi/task.py

@@ -23,6 +23,9 @@ def run(self):
         timeout = self.timeout + convertapi.conversion_timeout_delta
         path = "convert/%s/to/%s" % (from_format, self.to_format)
 
+        if 'converter' in params:
+            path += "/converter/%s" % (params['converter'])
+
         response = convertapi.client.post(path, params, timeout = timeout)
 
         return Result(response)

examples/alternative_converter.py

@@ -0,0 +1,15 @@
+import convertapi
+import os
+import tempfile
+
+convertapi.api_secret = os.environ['CONVERT_API_SECRET'] # your api secret
+
+# Example of saving Word docx to PDF using OpenOffice converter
+# https://www.convertapi.com/doc-to-pdf/openoffice
+
+upload_io = convertapi.UploadIO(open('files/test.docx', 'rb'))
+params = { 'File': upload_io, 'converter': 'openoffice' }
+
+saved_files = convertapi.convert('pdf', params).save_files(tempfile.gettempdir())
+
+print("The PDF saved to %s" % saved_files)

tests/test_convertapi.py

@@ -23,6 +23,11 @@ def test_convert_file(self):
 		assert result.save_files(tempfile.gettempdir())
 		assert result.conversion_cost > 0
 
+	def test_convert_file_alternative(self):
+		result = convertapi.convert('pdf', { 'File': 'examples/files/test.docx', 'converter': 'openoffice' })
+		assert result.save_files(tempfile.gettempdir())
+		assert result.conversion_cost > 0
+
 	def test_convert_file_url(self):
 		result = convertapi.convert('pdf', { 'File': 'https://cdn.convertapi.com/cara/testfiles/document.docx?test=1' })
 		assert result.conversion_cost > 0