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.
