Add user info and pdf thumbnail examples

Author: Laurynas Butkus

convertapi/file_param.py

@@ -1,12 +1,13 @@
 import os
 
 from io import FileIO
+from .result import Result
 from .result_file import ResultFile
 from .upload_io import UploadIO
 
 def build(resource):
-    if isinstance(resource, ResultFile):
-        return resource.url
+    if isinstance(resource, Result):
+        return resource.file.url
 
     if isinstance(resource, UploadIO):
         return resource.upload()

convertapi/format_detector.py

@@ -1,12 +1,15 @@
 from os.path import splitext
 from io import FileIO
 from requests import utils
+from .result import Result
 
 def detect(resource):
     if 'filename' in dir(resource):
         path = resource.filename
     elif isinstance(resource, FileIO):
         path = resource.name
+    elif isinstance(resource, Result):
+        path = resource.file.filename
     else:
         path = utils.urlparse(resource).path
 

examples/create_pdf_thumbnail.py

@@ -0,0 +1,29 @@
+import convertapi
+import os
+import tempfile
+
+convertapi.api_secret = os.environ['CONVERT_API_SECRET'] # your api secret
+
+# Example of extracting first page from PDF and then chaining conversion PDF page to JPG.
+# https://www.convertapi.com/pdf-to-extract
+# https://www.convertapi.com/pdf-to-jpg
+
+pdf_result = convertapi.convert('extract',
+    {
+        'File': 'files/test.pdf',
+        'PageRange': 1,
+    })
+
+jpg_result = convertapi.convert(
+    'jpg',
+    {
+        'File': pdf_result,
+        'ScaleImage': True,
+        'ScaleProportions': True,
+        'ImageHeight': 300,
+        'ImageWidth': 300,
+    })
+
+saved_files = jpg_result.save_files(tempfile.gettempdir())
+
+print("The thumbnail saved to %s" % saved_files)

examples/retrieve_user_information.py

@@ -0,0 +1,9 @@
+import convertapi
+import os
+
+convertapi.api_secret = os.environ['CONVERT_API_SECRET'] # your api secret
+
+# Retrieve user information
+# https://www.convertapi.com/doc/user
+
+print(convertapi.user())

setup.cfg

@@ -1,3 +1,5 @@
 [metadata]
 description-file = README.md
 
+[easy_install]
+