Some test text!

Search
Hamburger Icon

Windows / Guides / Python3

Precompiled Python3 & Windows PDF library integration

This guide will help you run Apryse samples and integrate a free trial of the Apryse SDK into Python applications on Windows. Your free trial includes unlimited trial usage and support from solution engineers.

Run Apryse SDK in production
A commercial license key is required for use in a production environment. Please fill out our licensing form if you do not have a valid license key.
Keep your commercial license key confidential.
License keys are uniquely generated. Please make sure that it is not publicly available (e.g. in your public GitHub).

Prerequisites

  • Python 3.5 - 3.12 and pip.

    Make sure the executable name is python.exe (default on Windows) and Python is added to your path environment variable.

There are THREE steps needed before you can use apryse-sdk library.

Step 1

Use pip to install apryse-sdk library from Apryse's S3 private repository in terminal. Notice that PDFNetPython3 library from Python Package Index (PyPI) will no longer be updated in the future after the 9.5.0 release.

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

or

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

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

If you run into this error when installing apryse-sdk via pip:

ERROR: Could not find a version that satisfies the requirement apryse-sdk (from versions: none)
ERROR: No matching distribution found for apryse-sdk

It is possible that your Python version is NOT fully compatible. You can check your python version by using the command:

python --version

and make sure your Python version is within 3.5 - 3.11.

Step 2

Download apryse-sdk Samples and unzip the package.

Step 3

Get your Apryse trial key.

Apryse collects some data regarding your usage of the SDK for product improvement.

If you wish to continue without data collection, contact us and we will email you a no-tracking trial key for you to get started.

Run the Samples

Navigate to the Samples folder. Notice that you will need to update Samples/LicenseKey/PYTHON/LicenseKey.py before you could run Samples.

Run a specific sample

  1. Find the sample you want to run and navigate into the PYTHON folder inside.

  2. Find RunTest.bat and double click on it to run it. Alternatively, you can use the following command to run AddImageTest in command prompt:

    cd Samples\AddImageTest\PYTHON
     python -u AddImageTest.py

AddImageOutput

The output files are stored in Samples/TestFiles/output/

Run all samples

Find runall_python.bat in the samples folder and double click on it to run it. The output files from all tests are stored in Samples/TestFiles/output/.

Integrate into your application

It is easy to integrate apryse-sdk into your application. After you have installed apryse-sdk via pip, all you need to do is add from apryse-sdk import * to your Python script.

Below is an example called HelloWorld.py:

# You can add the following line to integrate apryse-sdk
# into your solution from anywhere on your system so long as
# the library was installed successfully via pip

from apryse_sdk import *

def main():

    # You need to initialize the PDFNet library 
    # Before calling any PDF related methods
    PDFNet.Initialize("YOUR_APRYSE_LICENSE_KEY")

    # This example creates a new document
    # and a new page, then adds the page
    # in the page sequence of the document
    doc = PDFDoc()

    page1 = doc.PageCreate()
    doc.PagePushBack(page1)

    # We save the document in a linearized
    # format which is the most popular and 
    # effective way to speed up viewing PDFs
    doc.Save(("linearized_output.pdf"), SDFDoc.e_linearized)

    doc.Close()

if __name__ == "__main__":
    main()

To test that your code works, run the script in the folder containing HelloWorld.py in command prompt:

python.exe -u HelloWorld.py

Once you have successfully run this, you should see an output file in the working directory of this program.

Installing Additional Modules

Additional modules are required to run our OCRTest or CADTest samples, which can be downloaded here .

Be sure to merge the Samples/ directory from the module into the Samples/ directory obtained from the download in Step 2, ensuring that the files the sample code depends on are available.

Next step

Guides Samples

Troubleshooting

  1. If you run into this error when installing apryse-sdk via pip:
ERROR: Could not find a version that satisfies the requirement apryse-sdk (from versions: none)
ERROR: No matching distribution found for apryse-sdk

It is possible that your Python version is NOT fully compatible. You can check your python version by using the command:

python --version

and make sure your Python version is within 3.5 - 3.11.

We recommend using Python 3.5.4, 3.6.8, 3.7.9, 3.8.5, 3.9.6, 3.10.4 to guarantee 100% compatibility.

If errors still occur, please contact our support team.

  1. If you cannot install apryse-sdk library via pip, you need to check whether python and pip are installed in your system.

    You can test it by using the following command:

    python -m pip --version

    If no errors occur and your python version is within 3.5 - 3.11, it may be that no precompiled apryse-sdk library is compatible with your system. Please contact our support team. You might need to build your own apryse-sdk wrapper using SWIG and our PDFNetC library.

  2. If you are running into issues with compatibility with other libraries, we recommend using our library in a

virtual environment, to guarantee the location of where our library will be installed. Henceforth, if our library needs to be imported, be sure to activate the same virtual environment before running a Python script that imports from apryse-sdk, as follows:

# Creates a venv/ folder in your current directory
python -m venv venv
# Activate the virtual environment in the current command prompt session
venv\Scripts\activate.bat
  1. If you want to upgrade apryse-sdk to the latest version, you can simply run:

    python -m pip install apryse-sdk --upgrade --extra-index-url=https://pypi.apryse.com
  2. If you run a sample and get the output:

nopip You will need to install apryse-sdk via pip first before you could run the sample.

Get the answers you need: Chat with us