Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cbrunet/python-poppler
Python binding to Poppler-cpp pdf library
https://github.com/cbrunet/python-poppler
pdf poppler poppler-cpp poppler-library pybind11 python python-poppler
Last synced: 2 months ago
JSON representation
Python binding to Poppler-cpp pdf library
- Host: GitHub
- URL: https://github.com/cbrunet/python-poppler
- Owner: cbrunet
- License: gpl-2.0
- Created: 2020-04-14T02:08:09.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-21T20:40:19.000Z (almost 2 years ago)
- Last Synced: 2024-04-26T09:41:49.624Z (9 months ago)
- Topics: pdf, poppler, poppler-cpp, poppler-library, pybind11, python, python-poppler
- Language: Python
- Homepage:
- Size: 1.47 MB
- Stars: 83
- Watchers: 4
- Forks: 14
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://github.com/psf/black)
# python-poppler
**python-poppler** is a Python binding to the poppler-cpp library. It allows to read, render, or modify PDF documents.
More specifically, it currently allows to:
- read an modify document meta data;
- list and read embedded documents;
- list the fonts used by the document;
- search or extract text on a given page of the document;
- render a page to a raw image;
- get info about transitions effects between the pages;
- read the table of contents of the document.
# Documentation
https://cbrunet.github.io/python-poppler/
Documentation is currently a work-in-progress. Here you will find information about
installation of the package, compilation from sources, and usage.
Meanwhile, because it follows the interface of `poppler-cpp`, you can refer to the [documentation of the C++ library](https://poppler.freedesktop.org/api/cpp/namespacepoppler.html).
# Usage
The package is installed as `poppler`.
Example:
```python
from poppler import load_from_file, PageRenderer
pdf_document = load_from_file("sample.pdf")
page_1 = pdf_document.create_page(0)
page_1_text = page_1.text()
renderer = PageRenderer()
image = renderer.render_page(page_1)
image_data = image.data
```
# Contributing
Contributions are welcome.
Please use the [GitHub issue tracker](https://github.com/cbrunet/python-poppler/issues)
to report bugs or request features.
You can also submit Pull requests.
Code is formatted using [black](https://github.com/psf/black).
Ensure that everything is well formatted. You can use
```
tox -e lint
```
to lint your code.
Please ensure that all tests pass, by running `tox`.
Please provide unit tests covering the new feature, or proving
that a bug is corrected, when possible.