mcruft-pdfcraft
Render PDF pages to PNG and extract pages through PdfCraft CLI; optionally extract and combine PDFs through the native binding. This package plugs into the mcruft document API. Use the same Python API across engines and inspect each conversion's loss report.
Install
Python 3.12 or later is required. Install the adapter with:
uv pip install mcruft-pdfcraft
Supply pdfcraft-cli 0.13.0 or later on PATH, or set
MCRUFT_PDFCRAFT_CLI to its executable path. For a self-contained installation
on macOS 11+ with Apple Silicon:
uv pip install 'mcruft-pdfcraft[all]'
The bundled extra installs only the CLI bundle; all installs every optional
component for this adapter. Bundles currently have macOS arm64 wheels only and
perform no runtime downloads. On other platforms, install the adapter and supply
a compatible CLI yourself.
mcruft-pdfcraft[native] installs the optional macOS arm64 Rust binding.
Use
With input.pdf in the current directory and its parent directory writable:
import mcruft
report = mcruft.convert("input.pdf", "pages.png", policy="fidelity")
print(report.engine)
print(report.outputs)
print(report.losses)
The router chooses an available engine by operation, format and policy; installing
this adapter does not force every route through it. Inspect the registry with
mcruft.engines().
Choose editable to favour document structure or fidelity to favour appearance.
Routes that cannot honour the requested policy raise UnsupportedRoute.
PNG exports require fidelity and may create numbered files; use report.outputs
to find the actual paths.
Limits and documentation
PNG output is rasterised. The native extra provides page operations, not the full PdfCraft application API. Installing an engine does not promise lossless round trips. The package does not include the desktop editor.
Licence: Apache-2.0. Upstream CLI licences are distributed with the separate binary wheel.
1 maintainer
Metadata
1 maintainer
Release files for mcruft-pdfcraft 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcruft_pdfcraft-1.0.0.tar.gz | 7.5 kB | Without provenance | Details for mcruft_pdfcraft-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcruft_pdfcraft-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for mcruft_pdfcraft-1.0.0-py3-none-any.whl |
Total release size: 12.1 kB
Release files / mcruft_pdfcraft-1.0.0.tar.gz
| Download URL | mcruft_pdfcraft-1.0.0.tar.gz |
|---|---|
| Size | 7.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
17c0fe52d4a40b995f8f45022744270d9c27be448ace4ca882fd51a2487ad3ca
|
|
BLAKE2b-256 checksum How to use checksums |
a33bb4b2b606a942f79489b65bd3b4b9c76fb10b940b1a3b8a0a4d4e0876684f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mcruft_pdfcraft-1.0.0-py3-none-any.whl
| Download URL | mcruft_pdfcraft-1.0.0-py3-none-any.whl |
|---|---|
| Size | 4.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
876629671012389b680f8d61908b410fc315ddf4705a0330d6fe358f9868a464
|
|
BLAKE2b-256 checksum How to use checksums |
3c194b809f23c69b29d00e43976072b896bc3c115ecd71962fb8305ea11906f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mcruft-pdfcraft 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
