Metadata-Version: 2.4
Name: comicbox-pdffile
Version: 0.2.2
Summary: A ZipFile like API for PyMuPDF
Project-URL: News, https://github.com/ajslater/comicbox-pdffile
Project-URL: Report Issues, https://github.com/ajslater/comicbox-pdffile/issues
Project-URL: homepage, https://github.com/ajslater/comicbox-pdffile
Project-URL: repository, https://github.com/ajslater/comicbox-pdffile
Project-URL: documentation, https://github.com/ajslater/comicbox-pdffile
Author-email: AJ Slater <aj@slater.net>
License: GPL-3.0-only
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: <4.0,>=3.9
Requires-Dist: filetype<2.0.0,>=1.2.0
Requires-Dist: pymupdf<2.0.0,>=1.24.0
Requires-Dist: python-dateutil>=2.9.0.post0
Description-Content-Type: text/markdown

# PDFFile

A ZipFile like API for PDFs using [PyMuPDF](https://pymupdf.readthedocs.io/) as
a backend.

Look in `pdffile.py` for exposed functions.

## Dependencies

The pymupdf dependency usually has wheels that install a local version of
libmupdf. But for some platforms (e.g. Windows) it may require libstdc++ and
c/c++ build tools installed to compile a libmupdf. More detail on this is
available in the
[pymupdf docs](https://pymupdf.readthedocs.io/en/latest/installation.html#installation-when-a-suitable-wheel-is-not-available).

## Data Types

MuPDF reads and writes all data types as strings. PDFFile automatically converts
pdf date strings to python datetimes and pdf/xml boolean strings to python bools
and back.

The helper functions to_datetime, to_pdf_date, to_bool, and to_xml_bool are
available on the PDFFile class.
