Get Started with the Apryse Server SDK Python 3 PDF Library Integration

You'll install or update pip3 and Python3, then get started with our samples to see the output you can create when you integrate the Apryse Server SDK into your application. Last, you'll create a project and integrate the Server SDK into your Python 3 application, all while using the macOS platform.

Before you start:

• Install Visual Studio Code (or your preferred application) to write, edit, and debug source code.
• Get your Apryse trial key.

You’ll need Python3 in your system. You’ll need pip3 to eventually install the Apryse Server SDK.

1. Check to see if Python3 and pip3 are installed on your system:

1python3 --version
2python3 -m pip --version

2. Complete one of the following, using Homebrew, based on whether pip3 and Python3 are already installed:

• OPTION 1: Install Python3 and pip3, via Homebrew, if they're not installed. You can use any Python 3 version Python supports.
  • Add the following to the command line:

1brew install python3

• OPTION 2: Update Python3 and pip3, through Homebrew, if there are versions already installed on your device:
  • Add the following to the command line to ensure Homebrew is up to date:

1brew update

• Add the following to the command line:

1brew upgrade python3

You'll download and run the OfficeToPDFTest sample which allows you to explore and validate the conversion feature offered by the SDK. By running the sample, you can quickly:

• Verify the capabilities.
• Understand how to interact with the MS Office to Conversion PDF API.
• Use it as a reference for integrating similar functionality into your own application.

1. Download the zip file for macOS which includes all of the Apryse samples.
2. Go to your Downloads folder and double-click the file to unzip it.
3. Select Documents, File > New Folder to add a new folder, then enter ApryseSamples as the folder name, and press Enter to create the new folder. You can create a folder at a different location if you prefer, but for this guide’s instructions, we used the location and name above.
4. Use your Mac Finder to navigate to the Downloads folder, copy the unzipped folder, and paste it into the new folder you made, ApryseSamples.
5. Navigate to the folder  /Documents/ApryseSamples/PDFNetPython3/Samples/OfficeToPDFTest/Python, right-click on the Python folder, then select New Terminal at Folder.
6. The macOS terminal opens to the directory you specified. On the command line, enter the following, then press Enter to install the apryse-sdk library from Apryse’s S3 private repository (You need this to run samples successfully):

1python3 -m pip install apryse-sdk --extra-index-url=https://pypi.apryse.com

or

1pip3 install apryse-sdk --extra-index-url=https://pypi.apryse.com 

If no errors occur, Successfully installed apryse-sdk... will display in terminal.

7. Navigate via your Mac Finder to /Documents/ApryseSamples/PDFNetPython3/Samples/LicenseKey/Python/LicenseKey.py, and double-click to open so you can add your license key to the LicenseKey.py file before running the sample.

8. Scroll down to the line containing ‘LicenseKey = “YOUR_PDFTRON_LICENSE_KEY”’ and replace the words in quotes with the copy of your trial license key. Leave the ‘if LicenseKey ==YOUR_PDFTRON_LICENSE_KEY’ as is with its default text.

9. Save your changes and close the file.

10. To run the sample, navigate, through the Mac Finder, to the folder you created:  /Home/ApryseSamples/PDFNetPython3/Samples/OfficeToPDFTest/Python, right-click on the Python folder, then select New Terminal at Folder.

11. The Mac terminal opens the OfficeToPDFTest sample. From the project directory, on the command line, enter the following, then press Enter:

1sh RunTest.sh

When you run the command, the sample code loads an Office document, converts the Office document to PDF, saves the resulting PDF, and outputs status messages to the console. For more details, you can look at additional OfficeToPDFsample code and the Convert MS Office (Word, Excel, PowerPoint) to PDF overview.

Once the sample finishes running, you'll see the status Done in the terminal.

12. At the command prompt, type Exit, then press Enter.

13. Go to your Mac Finder and navigate to: /Documents/ApryseSamples/Samples/TestFiles/Output. You will see three output PDF files (Fisherman.pdf, the_rime_of_the_ancient_mariner.pdf, and the factsheet_Arabic.pdf):

14. Open the PDF files to see the converted output. You have successfully run the OfficeToPDFTest conversion sample!

Next, you’ll create your own Python3 project and add the Apryse Server SDK so you can later integrate the Apryse Server SDK into the project and run it.

1. In your Mac Finder, navigate to the Documents folder, and add a new folder.
2. Enter the folder name, NewApryseProject, then press Enter.

Next, you’ll open a blank PDF page within your application.

1. Open Visual Studio Code (or your preferred application) and from the File menu, select Open Folder.
2. Navigate to the Documents folder from the Mac Finder, then, select the NewApryseProject folder and click Select Folder.

The NewApryseProject opens in Visual Studio Code.

3. Create a file in the project named HelloWorld.py.

4. Copy the following Python code and paste it into Line 1 of the HelloWorld.py file, then Save your file:

1# You can add the following line to integrate apryse-sdk
2# into your solution from anywhere on your system so long as
3# the library was installed successfully via pip
4
5from apryse_sdk import *
6
7def main():
8
9 # You need to initialize the PDFNet library
10 # Before calling any PDF related methods
11 PDFNet.Initialize("demo:1763580498695:601269ef03000000007505554501519c80287620321ec3184e959426e1")
12
13 # This example creates a new document
14 # and a new page, then adds the page
15 # in the page sequence of the document
16 doc = PDFDoc()
17
18 page1 = doc.PageCreate()
19 doc.PagePushBack(page1)
20
21 # We save the document in a linearized
22 # format which is the most popular and
23 # effective way to speed up viewing PDFs
24 doc.Save(("linearized_output.pdf"), SDFDoc.e_linearized)
25
26 doc.Close()
27
28if __name__ == "__main__":
29 main()

Keep in mind the following about the code above:

• You’re importing the Apryse SDK.
• You’re initializing PDFNet using your Apryse license key. Scroll down to the line containing PDFNet.Initialize(“YOUR_LICENSE_KEY”); and replace the words in quotes with the copy of your trial license key. If you’re logged in to Apryse.com, your license key will automatically replace YOUR_LICENSE_KEY in the code above.
• You’re doing various work with PDFNet. In this case, with a PDFDoc object.

5. To test that your code works, run the script in the folder containing HelloWorld.py in the command prompt, then press Enter.

1python -u HelloWorld.py 

6. The code executes and you will see “PDFNet is running in demo mode.”

7. Exit out of the command line and navigate to the Documents > NewApryseProject folder from Mac Finder.

8. Open the linearized_output.pdf which you created by integrating the Apryse Server SDK!

9. Now that you have successfully run an OfficeToPDFTest sample and integrated the Apryse Server SDK Python PDF Library into your application, you can try out 50+ samples depending on your needs.

10. To try additional samples, go to section 2. Run a sample > Step 5 above and choose a different sample to run with a different URL path.

You'll install or update pip3 and Python3, then get started with our samples to see the output you can create when you integrate the Apryse Server SDK into your application. Last, you'll create a project and integrate the Server SDK into your Python 3 application, all while using the Windows platform.

Before you start:

• Install Visual Studio Code (or your preferred application) to write, edit, and debug source code.
• Get your Apryse trial key.

You’ll need Python3 in your system. You’ll need pip3 to eventually install the Apryse Server SDK.

1. Check to see if Python3 and pip3 are installed on your system:

1python --version
2pip --version

2. Complete one of the following based on whether pip3 and Python3 are already installed:

• OPTION 1: Install Python3 and pip3 if they're not installed:
  • To download Python3, go to the Python Windows download page, then select the file you need. You can use any Python3 version Python supports.
  • Click on the executable in your Downloads folder to start installation. Make sure to check the box before the actual install to set Python to the path.
• OPTION 2: Update Python3 and pip3 if there are versions already installed on your device:
  • Add the following to the command line:

1python -m pip install --upgrade pip

You'll download and run the OfficeToPDFTest sample which allows you to explore and validate the conversion feature offered by the SDK. By running the sample, you can quickly:

• Verify the capabilities.
• Understand how to interact with the MS Office to Conversion PDF API.
• Use it as a reference for integrating similar functionality into your own application.

1. Download the zip file for Windows which includes all of the Apryse samples.
2. Select Documents, New Folder, then enter ApryseSamples, and press Enter to create a new folder to extract the zip file into for running the samples. You can create a folder at a different location if you prefer, but for this guide’s instructions, we used the location and name above.
3. Use your Windows file explorer to navigate to the Downloads folder, right-click on the zip file, then select Extract all.
4. Click Browse.
5. Go to the new folder you made, highlight it, then click Select Folder.
6. Click Extract.

The file is extracted to the folder.

7. Navigate to the folder /Documents/ApryseSamples/Samples/OfficeToPDFTest/Python, right-click on the Python folder, then select Open in Terminal.

8. The Windows terminal opens to the directory you specified. On the command line, enter the following, then press Enter to install the apryse-sdk library from Apryse’s S3 private repository (You need this to run samples successfully):

1pip install apryse-sdk --extra-index-url=https://pypi.apryse.com

If no errors occur, Successfully installed apryse-sdk... will display in terminal.

9. Navigate via your Windows file explorer to /Documents/ApryseSamples/Samples/LicenseKey/Python/LicenseKey.py and double-click to open so you can add your license key to the LicenseKey.py file before running the sample.

10. Scroll down to the line containing ‘LicenseKey = “YOUR_PDFTRON_LICENSE_KEY”' and replace the words in quotes with the copy of your trial license key. Leave the ‘if LicenseKey ==YOUR_PDFTRON_LICENSE_KEY’ as is with its default text.

11. Save your changes and close the file.

12. To run the sample, navigate, through the Windows file explorer, to the folder you created:  /Home/ApryseSamples/Samples/OfficeToPDFTest/Python, right-click on the Python folder, then select Open in Terminal.

13. The Windows terminal opens the OfficeToPDFTest sample. From the project directory, on the command line, enter the following, then press Enter:

1python –u OfficeToPDFTest.py

When you run the command, the sample code loads an Office document, converts the Office document to PDF, saves the resulting PDF, and outputs status messages to the console. For more details, you can look at additional OfficeToPDFsample code and the Convert MS Office (Word, Excel, PowerPoint) to PDF overview.

Once the sample finishes running, you'll see the status Done in the terminal.

14. At the command prompt, type exit, then press Enter.

15. Go to your Windows file explorer and navigate to: /Documents/ApryseSamples/Samples/TestFiles/Output. You will see three output PDF files (Fisherman.pdf, the_rime_of_the_ancient_mariner.pdf, and the factsheet_Arabic.pdf):

16. Open the PDF files to see the converted output. You have successfully run the OfficeToPDFTest conversion sample!

Next, you’ll create your own Python3 project and add the Apryse Server SDK so you can later integrate the Apryse Server SDK into the project and run it.

1. In your Windows file explorer, navigate to the Documents folder, and add a new folder.
2. Enter the folder name, NewApryseProject, then press Enter.

Next, you’ll open a blank PDF page within your application.

1. Open Visual Studio Code (or your preferred application) and from the File menu, select Open Folder.
2. Navigate to the Documents folder from Windows file explorer, then, select the NewApryseProject folder and click Select Folder.

The NewApryseProject opens in Visual Studio Code.

3. Create a file in the project named HelloWorld.py.

4. Copy the following Python code and paste it into Line 1 of the HelloWorld.py file, then Save your file:

1# You can add the following line to integrate apryse-sdk
2# into your solution from anywhere on your system so long as
3# the library was installed successfully via pip
4
5from apryse_sdk import *
6
7def main():
8
9 # You need to initialize the PDFNet library
10 # Before calling any PDF related methods
11 PDFNet.Initialize("YOUR_LICENSE_KEY")
12
13 try:
14 # This example creates a new document
15 # and a new page, then adds the page
16 # in the page sequence of the document
17 doc = PDFDoc()
18
19 page1 = doc.PageCreate()
20 doc.PagePushBack(page1)
21
22 # We save the document in a linearized
23 # format which is the most popular and
24 # effective way to speed up viewing PDFs
25 doc.Save(("linearized_output.pdf"), SDFDoc.e_linearized)
26
27 doc.Close()
28 except Exception as e:
29 print("Unable to create PDF document, error: " + str(e))
30
31 PDFNet.Terminate()
32
33if __name__ == "__main__":
34 main()

Keep in mind the following about the code above:

• You’re importing the Apryse SDK.
• You’re initializing PDFNet using your Apryse license key. Scroll down to the line containing PDFNet.Initialize(“YOUR_LICENSE_KEY”); and replace the words in quotes with the copy of your trial license key. If you’re logged in to Apryse.com, your license key will automatically replace YOUR_LICENSE_KEY in the code above.
• You’re doing various work with PDFNet. In this case, with a PDFDoc object.
• You’re calling PDF.Terminate which releases any resources in use.

5. To test that your code works, run the script in the folder containing HelloWorld.py in the command prompt, then press Enter.

1python.exe -u HelloWorld.py 

6. The code executes and you will see “PDFNet is running in demo mode.”

7. Exit out of the command line and navigate to the Documents > NewApryseProject folder from Windows file explorer.

8. Open the linearized_output.pdf which you created by integrating the Apryse Server SDK!

9. Now that you have successfully run an OfficeToPDFTest sample and integrated the Apryse Server SDK Python PDF Library into your application, you can try out 50+ samples depending on your needs.

10. To try additional samples, go to section 2. Run a sample > Step 7 above and choose a different sample to run with a different URL path.

You'll install or update pip3 and Python 3, then get started with our samples to see the output you can create when you integrate the Apryse Server SDK into your application. Last, you'll create a project and integrate the Server SDK into your Python 3 application, all while using the Linux platform.

1python3 --version 
2python3 -m pip –version 

1sudo apt update 

1sudo add-apt-repository universe 
2sudo apt update 

1sudo apt install python3-pip 

1sudo apt install python3 python3-pip

1python3 -m pip install apryse-sdk --extra-index-url=https://pypi.apryse.com 

1pip3 install install apryse-sdk --extra-index-url=https://pypi.apryse.com 

1sh RunTest.sh

1python3 -m pip install apryse-sdk --extra-index-url=https://pypi.apryse.com 

1pip3 install install apryse-sdk --extra-index-url=https://pypi.apryse.com 

1# You can add the following line to integrate apryse-sdk
2# into your solution from anywhere on your system so long as
3# the library was installed successfully via pip
4from apryse_sdk import *
5def main():
6 # You need to initialize the PDFNet library
7 # Before calling any PDF related methods
8 PDFNet.Initialize("YOUR_LICENSE_KEY")
9 # This example creates a new document
10 # and a new page, then adds the page
11 # in the page sequence of the document
12 doc = PDFDoc()
13 page1 = doc.PageCreate()
14 doc.PagePushBack(page1)
15 # We save the document in a linearized
16 # format which is the most popular and
17 # effective way to speed up viewing PDFs
18 doc.Save(("linearized_output.pdf"), SDFDoc.e_linearized)
19 doc.Close()
20if __name__ == "__main__":
21 main()

1python3 -u HelloWorld.py 

1python3 --version

1mkdir YOUR_FUNCTION_FOLDER
2cd YOUR_FUNCTION_FOLDER
3python3 -m pip install --target . apryse-sdk --extra-index-url=https://pypi.apryse.com

1zip -r ./YOUR_FUNCTION_FOLDER.zip .

1from base64 import b64encode, b64decode
2import json
3from apryse_sdk import *
4def lambda_handler(event, context):
5 if event["httpMethod"] == "GET":
6 return {
7 'statusCode': 200,
8 'body': json.dumps('Hello from Apryse!')
9 }
10 elif event["httpMethod"] == "POST":
11 try:
12 body = json.loads(event["body"])
13 PDFNet.Initialize("YOUR_APRYSE_LICENSE_KEY") # if you use apryse-sdk 9.1.0 and above. Otherwise use PDFNet.Initialize()
14 # your AWS lambda function goes here
15 message = {
16 'statusCode': 200,
17 'headers': {'Content-Type': 'application/json'},
18 'body': json.dumps(base64_string),
19 }
20 return message
21 except Exception as e:
22 message = {
23 'statusCode': 500,
24 'body': e
25 }
26 return (message)

1# This example shows how to create AWS Lambda functions using Apryse SDK.
2# A REST API request was posted with base64 encoded data by the client.
3# The request would be processed by the server and a response with base64 encoded data of OfficeToPDF output would be sent to the client.
4from base64 import b64encode, b64decode
5import json
6from apryse_sdk import *
7def lambda_handler(event, context):
8 if event["httpMethod"] == "GET":
9 return {
10 'statusCode': 200,
11 'body': json.dumps('Hello, please send base64 doc to use this Lambda!')
12 }
13 elif event["httpMethod"] == "POST":
14 try:
15 body = json.loads(event["body"])
16 base64str = body["file"]["data"]
17 filename = body["file"]["filename"]
18 base64_bytes = b64decode(base64str)
19 # save input doc
20 output_path = '/tmp/'
21 input_filename = filename.split('.')[0] + '.docx'
22 with open(output_path + input_filename, 'wb') as open_file:
23 byte_content = open_file.write(base64_bytes)
24 # Start with a PDFDoc
25 PDFNet.Initialize("YOUR_APRYSE_LICENSE_KEY") # if you use apryse-sdk 9.1.0 and above. Otherwise use PDFNet.Initialize()
26 pdfdoc = PDFDoc()
27 # perform the conversion with no optional parameters and save to /temp
28 Convert.OfficeToPDF(pdfdoc, output_path + input_filename, None)
29 # save the result
30 output_filename = filename.split('.')[0] + '.pdf'
31 pdfdoc.Save(output_path + output_filename, SDFDoc.e_linearized)
32 # sending data
33 with open(output_path + output_filename, 'rb') as open_file:
34 byte_content = open_file.read()
35 base64_bytes = b64encode(byte_content)
36 base64_string = base64_bytes.decode('utf-8')
37 print("Sending " + output_filename )
38 message = {
39 'statusCode': 200,
40 'headers': {'Content-Type': 'application/json'},
41 'body': json.dumps(base64_string),
42 }
43 return message
44 except Exception as e:
45 print(e)
46 message = {
47 'statusCode': 500,
48 'body': e
49 }
50 return (message)

1json_data = {
2 "file": {
3 "encoding": "base64",
4 "data": base64_string_of_your_office_document,
5 "filename": filename,
6 "content-type": "application/pdf"
7 }
8 }

1python AWSLambdaExample.py --url <YOUR PUBLISHED FUNCTION URL>

1python AWSLambdaExample.py --url <YOUR PUBLISHED FUNCTION URL> --filename <YOUR OFFICE FILENAME>