new feature: extract pages

Author: apexdodge

README.md

@@ -1,7 +1,7 @@
 # api2pdf.python
 Python bindings for [Api2Pdf REST API](https://www.api2pdf.com/documentation/v2) 
 
-Api2Pdf.com is a powerful REST API for instantly generating PDF and Office documents from HTML, URLs, Microsoft Office Documents (Word, Excel, PPT), Email files, and images. You can generate image preview or thumbnail of a PDF, office document, or email file. The API also supports merge / concatenation of two or more PDFs, setting passwords on PDFs, and adding bookmarks to PDFs. Api2Pdf is a wrapper for popular libraries such as **wkhtmltopdf**, **Headless Chrome**, **PdfSharp**, and **LibreOffice**.
+Api2Pdf.com is a powerful REST API for instantly generating PDF and Office documents from HTML, URLs, Microsoft Office Documents (Word, Excel, PPT), Email files, and images. You can generate image preview or thumbnail of a PDF, office document, or email file. The API also supports merge / concatenation of two or more PDFs, setting passwords on PDFs, adding bookmarks to PDFs, splitting or extracting pages from a PDF. Api2Pdf is a wrapper for popular libraries such as **wkhtmltopdf**, **Headless Chrome**, **PdfSharp**, and **LibreOffice**.
 
 - [Installation](#installation)
 - [Resources](#resources)
@@ -220,6 +220,15 @@ To use the merge endpoint, supply a list of urls to existing PDFs. The engine wi
     password = 'hello'
     response = a2p.PdfSharp.add_password(url, password)
 
+**Extract pages, or split an existing PDF**
+
+[More information here](https://www.api2pdf.com/extract-pages-out-of-a-pdf-with-rest-api/)
+
+    url = 'https://link-to-pdf'
+    start = 0
+    end = 2
+    response = a2p.PdfSharp.extract_pages(url, start, end)
+
 ---
 
 ## <a name="helpers"></a>Helper Methods

api2pdf/api2pdf.py

@@ -133,6 +133,13 @@ def add_password(self, url, userpassword, ownerpassword=None, inline=True, file_
             payload['ownerpassword'] = ownerpassword
         return self._make_request('/pdfsharp/password', payload)
 
+    def extract_pages(self, url, start=0, end=0, inline=True, file_name=None):
+        payload = self._build_base_payload(inline, file_name)
+        payload['url'] = url
+        payload['start'] = start
+        payload['end'] = end
+        return self._make_request('/pdfsharp/extract-pages', payload)
+
 class Api2PdfResponse(object):
     def __init__(self, headers, endpoint, payload_as_json, response):
         self.headers = headers

setup.py

@@ -5,7 +5,7 @@
 
 setuptools.setup(
     name="api2pdf",
-    version="2.0.1",
+    version="2.1.0",
     author="Zack Schwartz",
     author_email="support@api2pdf.com",
     description="This client library is a wrapper for the Api2Pdf.com REST API. See full REST api documentation at https://www.api2pdf.com/documentation/v2. Api2Pdf is a powerful API that supports HTML to PDF, URL to PDF, HTML to Image, URL to Image, Thumbnail / image preview of an Office file, Office files (Word to PDF), HTML to Docx, HTML to excel, PDF to HTML, merge PDFs together, add bookmarks to PDFs, add passwords to PDFs",