Developer Guide Leave feedback

Welcome to the Developer Guide for GroupDocs.Conversion for Python via .NET. This section provides practical code examples designed to help you quickly integrate and use the GroupDocs.Conversion API in your projects.

Before proceeding, please review the following topics:

• System Requirements: Covers the specifications for your system.
• Installation: Provides installation options and instructions.

We recommend to get a Temporary License to test all the product features.

Each code example in this guide is provided as a standalone script that you can copy directly into a .py file. You’ll find the instructions for running code examples below.

Alongside each code example, you will find source and output files that you can download for reference. These output files demonstrate the actual results you can achieve with GroupDocs.Conversion when using a valid license.

• Source files are provided as the input files used in each example.
• Output files are generated after conversion and are available for download without evaluation watermarks. A valid license was applied during the conversion process by setting the license path through the environment variable GROUPDOCS_LIC_PATH.

This topic explains how to run a code example from the Developer Guide section. We will demonstrate the process using the Load File From Local Disk example, but the steps are the same for any example you choose.

Create a folder by typing mkdir load-file-from-local-disk in your terminal and navigate into it with cd load-file-from-local-disk.

We recommend using a virtual environment to manage dependencies in Python applications. Learn more about virtual environments in the Create and Use Virtual Environments documentation topic.

Create a virtual environment:

py -m venv .venv

python3 -m venv .venv

Activate the virtual environment:

.venv\Scripts\activate

source .venv/bin/activate

Download the OS-specific package from the GroupDocs.Conversion for Python via .NET releases page, copy it to the folder, and install:

py -m pip install groupdocs_conversion_net-24.11-py3-none-win_amd64.whl

py -m pip install groupdocs_conversion_net-24.11-py3-none-win32.whl

python3 -m pip install groupdocs_conversion_net-24.11-py3-none-macosx_11_0_arm64.whl

python3 -m pip install groupdocs_conversion_net-24.11-py3-none-macosx_10_14_x86_64.whl

Copy the license file into the folder that you created, or set the environment variable GROUPDOCS_LIC_PATH with the absolute path to the license file.

set GROUPDOCS_LIC_PATH "C:\path\to\your\license\file.lic"

$env:GROUPDOCS_LIC_PATH="C:\path\to\your\license\file.lic"

export GROUPDOCS_LIC_PATH="/path/to/your/license/file.lic"

Create a file named convert_to_pdf.py and copy in the code example:

from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_to_pdf():
    # Specify source file location
    converter = Converter("./business-plan.docx")
    
    # Specify output file location and convert options
    output_path = "./business-plan.pdf"
    pdf_options = PdfConvertOptions()
    
    # Convert and save to output path
    converter.convert(output_path, pdf_options)

if __name__ == "__main__":
    convert_to_pdf()

Download the input file business-plan.docx and copy it into the folder.

In your terminal, run the following command:

py convert_to_pdf.py

python3 convert_to_pdf.py

Check for the output file business-plan.pdf in the current directory.

If you encounter any issues while running the examples:

• Ensure all dependencies are installed correctly.
• Visit our Technical Support page for further assistance.