Add word to pdf and png example

Author: Laurynas Butkus

convertapi/file_param.py

@@ -13,13 +13,13 @@ def build(resource):
         return resource.url
 
     if isinstance(resource, UploadIO):
-        return resource.upload()
+        return resource.file_id
 
     if isinstance(resource, FileIO):
-        return UploadIO(resource).upload()
+        return UploadIO(resource).file_id
 
     if os.path.isfile(resource):
         io = open(resource, 'rb')
-        return UploadIO(io).upload()
+        return UploadIO(io).file_id
 
     return resource

convertapi/upload_io.py

@@ -4,18 +4,26 @@
 class UploadIO:
     def __init__(self, io, filename = None):
         self.io = io
-        self.__filename = filename
+        self._filename = filename
+        self._file_id = None
 
-    def upload(self):
-        result = convertapi.client.upload(self.io, self.filename)
-        return result['FileId']
+    @property
+    def file_id(self):
+        if self._file_id is None:
+            self._file_id = self.__upload()
+
+        return self._file_id
 
     @property
     def filename(self):
-        if self.__filename:
-            return self.__filename
+        if self._filename:
+            return self._filename
 
         if 'name' in dir(self.io):
             return os.path.basename(self.io.name)
 
         raise 'Filename must be provided for non File resources'
+
+    def __upload(self):
+        result = convertapi.client.upload(self.io, self.filename)
+        return result['FileId']

examples/convert_url_to_pdf.py

@@ -0,0 +1,22 @@
+import convertapi
+import os
+import tempfile
+
+convertapi.api_secret = os.environ['CONVERT_API_SECRET'] # your api secret
+
+# Example of converting Web Page URL to PDF file
+# https://www.convertapi.com/web-to-pdf
+
+result = convertapi.convert(
+    'pdf',
+    {
+        'Url': 'https://en.wikipedia.org/wiki/Data_conversion',
+        'FileName': 'web-example',
+    },
+    from_format = 'web',
+    timeout = 180,
+)
+
+saved_files = result.save_files(tempfile.gettempdir())
+
+print("The web page PDF saved to %s" % saved_files)

examples/convert_word_to_pdf_and_png.py

@@ -0,0 +1,22 @@
+import convertapi
+import os
+import tempfile
+
+convertapi.api_secret = os.environ['CONVERT_API_SECRET'] # your api secret
+
+# Example of saving Word docx to PDF and to PNG
+# https://www.convertapi.com/docx-to-pdf
+# https://www.convertapi.com/docx-to-png
+
+# Use upload IO wrapper to upload file only once to the API
+upload_io = convertapi.UploadIO(open('files/test.docx', 'rb'))
+
+saved_files = convertapi.convert('pdf', { 'File': upload_io }).save_files(tempfile.gettempdir())
+
+print("The PDF saved to %s" % saved_files)
+
+# Reuse the same uploaded file
+
+saved_files = convertapi.convert('png', { 'File': upload_io }).save_files(tempfile.gettempdir())
+
+print("The PNG saved to %s" % saved_files)

examples/create_pdf_thumbnail.py

@@ -8,11 +8,13 @@
 # https://www.convertapi.com/pdf-to-extract
 # https://www.convertapi.com/pdf-to-jpg
 
-pdf_result = convertapi.convert('extract',
+pdf_result = convertapi.convert(
+    'extract',
     {
         'File': 'files/test.pdf',
         'PageRange': 1,
-    })
+    }
+)
 
 jpg_result = convertapi.convert(
     'jpg',
@@ -22,7 +24,8 @@
         'ScaleProportions': True,
         'ImageHeight': 300,
         'ImageWidth': 300,
-    })
+    }
+)
 
 saved_files = jpg_result.save_files(tempfile.gettempdir())