VanillaPDF Python Bindings

Python bindings for Vanilla.PDF, a high-performance C++17 library for PDF document processing.

📖 Documentation: vanillapdf-py.readthedocs.io — API reference and examples.

Installation

pip install vanillapdf

Requires Python 3.11 or later. Pre-built wheels are available for Windows, Linux, and macOS.

Quick Start

import vanillapdf

# Open a document, read its title, and save a copy
with vanillapdf.Document.open("input.pdf") as doc:
    info = doc.get_document_info()
    if info is not None and info.title is not None:
        print("Title:", info.title.text)

    doc.save("output.pdf")

More runnable scripts — creating, encrypting, signing, and verifying documents — are in examples/.

Features

Available Now	Coming Soon
Open, create, and save PDF documents	JPEG2000 and ICC profile support
Document metadata, pages, and low-level object traversal
Encryption and decryption
Digital signatures (signing and verification)
Context manager support
Cross-platform (Windows, Linux, macOS)

The Python bindings expose functionality from the Vanilla.PDF C++ library, with more features being added progressively.

Development

# Install with test dependencies
pip install -e .[test]

# Run tests
pytest

# Build from source (requires CMake and a C++ compiler)
pip install build
python -m build

Contributing

Contributions are welcome. Please read the contributing guidelines before submitting a pull request.

License

Licensed under the Apache License 2.0.

---

Developed by Vanilla.PDF Labs — secure, high-performance PDF technology.