pdf-tooling 0.1.1__py3-none-any.whl

pdf_tooling-0.1.1.dist-info/METADATA

@@ -0,0 +1,206 @@
+Metadata-Version: 2.5
+Name: pdf-tooling
+Version: 0.1.1
+Summary: One safe, permissively-licensed command-line tool for the common PDF chores.
+Project-URL: Homepage, https://github.com/ArmandoHerra/pdf-toolkit
+Project-URL: Repository, https://github.com/ArmandoHerra/pdf-toolkit
+Project-URL: Changelog, https://github.com/ArmandoHerra/pdf-toolkit/blob/main/changelog.md
+Author: Armando Herra
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+License-File: THIRD_PARTY_LICENSES
+Keywords: cli,merge,ocr,pdf,rasterize,split
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: pdfplumber<0.12,>=0.11.10
+Requires-Dist: pikepdf<11,>=10.12.0
+Requires-Dist: pillow<13,>=12.3.0
+Requires-Dist: pypdf[crypto]<7,>=6.16.2
+Requires-Dist: pypdfium2<6,>=5.13.0
+Requires-Dist: pytesseract<0.4,>=0.3.13
+Requires-Dist: reportlab<6,>=5.0.1
+Requires-Dist: typer<1,>=0.12
+Provides-Extra: all
+Requires-Dist: weasyprint<70,>=69.0; extra == 'all'
+Provides-Extra: html
+Requires-Dist: weasyprint<70,>=69.0; extra == 'html'
+Description-Content-Type: text/markdown
+
+# pdf-toolkit
+
+An Apache-2.0 PDF toolkit CLI in Python. One safe command-line tool (`pdftoolkit`) for the common PDF chores — `merge`, `split`, `extract`, `delete`, `rotate`, `reorder`, `rasterize`, `compose`, `create`, `text`, `tables`, `compress`, `repair`, `linearize`, `encrypt`, `decrypt`, `permissions`, `meta`, `watermark`, `stamp`, `ocr` and `convert`, plus `doctor`, `info` and `version` — built on a permissively licensed engine stack (pypdf, pypdfium2, reportlab, pikepdf, pdfplumber, Tesseract, LibreOffice) with nothing AGPL or GPL on the call graph.
+
+Safety is first-class: a global `--dry-run`, no-clobber by default, atomic write-to-temp-then-rename, and inputs that are never mutated unless you ask for `--in-place`.
+
+**Current phase:** Phase 1 (v1) complete — per-spec status lives in `ai_plans/pdf-toolkit/specs/SPEC-INDEX.md`; history in `changelog.md`.
+
+- **Website:** https://armandoherra.github.io/pdf-toolkit/ — the public landing page (source in `website/`).
+
+## This is not `pdftk`
+
+`pdf-toolkit` shares no code with `pdftk`, is not a fork of it, and is not a drop-in replacement for it. `pdftk` is GPL-licensed; this project is **Apache-2.0**, and its engine policy forbids anything under AGPL, GPL or LGPL from appearing as an import, an optional extra, or a `subprocess` fallback. The console script is named `pdftoolkit` precisely so the two cannot be confused on your `PATH`.
+
+The PyPI **distribution** to install is **`pdf-tooling`**. The distribution named `pdftoolkit` on PyPI is an unrelated GPL-3.0 project and is not this software. The import package is `pdf_toolkit`, and the installed console scripts are `pdftoolkit` and `pdf-toolkit`; the three names differ deliberately.
+
+## Getting Started
+
+```bash
+# Prerequisites: Python >= 3.11 and uv (https://docs.astral.sh/uv/)
+git clone https://github.com/ArmandoHerra/pdf-toolkit.git
+cd pdf-toolkit
+uv sync
+uv run pdftoolkit --help
+```
+
+`uv sync` installs the runtime stack *and* the development tooling, so there is no separate bootstrap step.
+
+## What exists today
+
+The CLI spine, the output contract and the exit-code contract are in place end-to-end, and every verb named at the top of this file — structure, raster, compose, text, optimize, crypto and overlay operations alike — is shipped behind them, not merely specified.
+
+The complete top-level roster, by family:
+
+| Family | Commands |
+|---|---|
+| Structure | `merge`, `split`, `extract`, `delete`, `rotate`, `reorder` |
+| Raster & compose | `rasterize`, `compose`, `create` |
+| Text | `text`, `tables` |
+| Optimize | `compress`, `repair`, `linearize` |
+| Crypto | `encrypt`, `decrypt`, `permissions` |
+| Metadata & overlay | `meta` (`get` / `set`), `watermark`, `stamp` |
+| Engine-backed | `ocr`, `convert` |
+| Diagnostics | `doctor`, `info`, `version` |
+
+That table is asserted against the live command tree by set-inclusion, so a verb
+shipped tomorrow turns the check red with no author action — but
+`uv run pdftoolkit --help` remains the authoritative list.
+
+```bash
+uv run pdftoolkit --help               # the full verb tree; always the authoritative list
+uv run pdftoolkit doctor               # which engines resolved, and how
+uv run pdftoolkit merge a.pdf b.pdf -O merged.pdf
+uv run pdftoolkit rotate report.pdf --pages 2-4 --angle 90 -O rotated.pdf
+uv run pdftoolkit compress report.pdf -O small.pdf
+uv run pdftoolkit --version            # tool, Python and engine versions on one line
+```
+
+`uv run pdftoolkit --help` is the authoritative list of what is actually available at any moment — if a verb is not printed there, it does not exist yet.
+
+## Output contract
+
+Rendered payloads go to **stdout**; diagnostics, warnings and progress go to **stderr**. `-o` selects the shape and defaults to `table` when stdout is a terminal and `json` when it is not, so piping into `jq` needs no flag.
+
+| Shape | Behaviour |
+|---|---|
+| `-o table` | An aligned, plain-text table. No colour when `--no-color` is passed, when `NO_COLOR` is set, or when the stream is not a terminal. |
+| `-o json` | One object, carrying `schema_version`. |
+| `-o ndjson` | One object per item, one per line, **each line carrying its own `schema_version`** so a single streamed line is self-describing. |
+
+Errors are the one deliberate asymmetry: with `-o table` an error is a one-line `error: …` on stderr, but with `-o json`/`-o ndjson` it is an object on **stdout**, so a machine consumer reading stdout never has to also read stderr to learn that the run failed. That holds for **every** failure you can reach, an unknown flag and a missing argument included: those are usage errors (exit 2) carrying the same envelope, not a human `Usage:` block.
+
+**A command group does not take the global block.** `meta` groups `meta get` and `meta set`, and the global flags are declared at the root and on every verb, never on a group — so `pdftoolkit meta -o json` is a usage error (exit 2) rather than a run. It names the two positions that do work: `pdftoolkit -o json meta get FILE` (before the group) and `pdftoolkit meta get FILE -o json` (after the subcommand).
+
+**Global flags with no command at all** — `pdftoolkit -o json` — are an incomplete invocation and exit 2 as well, pointing at `--help`. `pdftoolkit` on its own, with no arguments, still prints help and exits 0.
+
+The structured shapes and the exit-code table below are **public API from v1.0.0**. Breaking either requires a major version bump and a `schema_version` increment. Pre-1.0 releases are explicitly still moving.
+
+## Exit codes
+
+Uniform across every verb.
+
+| Code | Name | Meaning |
+|---|---|---|
+| 0 | `OK` | Success — including an empty-but-valid report. A `--dry-run` mirrors the code the real run would return, so it is not always 0. |
+| 1 | `FAILURE` | The operation ran and failed — corrupt input, engine error, unwritable destination. |
+| 2 | `USAGE` | Bad invocation — unknown flag, mutually exclusive flags, malformed page range, unknown subcommand, a global flag at a command group, or global flags with no command. |
+| 3 | `ENGINE_MISSING` | A required engine or binary is unavailable. The message always carries an install hint. |
+| 4 | `NO_INPUT` | Valid invocation, nothing to act on. |
+| 5 | `REFUSED` | A safety gate declined. |
+| 6 | `AUTH` | Password required, incorrect, or of the wrong kind. |
+
+## Safety contract
+
+- `--dry-run` plans and reports; it writes nothing, anywhere.
+- Outputs never clobber. An existing target needs `-f/--force`.
+- Every write is write-to-temp-on-the-target-filesystem, `fsync`, then an atomic rename.
+- Inputs are never mutated unless you pass `--in-place`, which writes a `.bak` sidecar first. `--no-backup` suppresses the sidecar and requires `--in-place` — on its own it is a usage error.
+- A password is never accepted as a command-line value. `--password-file` takes a path or `-`, because `argv` is world-readable in `/proc` and lands in shell history.
+
+## Compression ceiling
+
+Structure-level compression plus optional image downsampling is the ceiling of a permissive stack: Ghostscript is AGPL-3.0+ and deliberately excluded, so `compress` builds on `pikepdf`/libqpdf object streams and an opt-in Pillow image pass instead. `--images downsample`'s resample threshold is computed against the page's own width in inches (the page box), never an image's placement rectangle, which under-downsamples a small image on a large page — a stated, conservative limitation.
+
+## Encryption, passwords and permissions
+
+`encrypt` writes AES-256 (revision 6) by default. `--legacy` selects RC4-128, which is cryptographically broken and exists only for readers that predate PDF 1.7 ExtensionLevel 3; it also leaves document metadata unencrypted, because the format cannot encrypt metadata without AES. Every cryptographic operation is libqpdf's, reached through `pikepdf`. This tool implements no cryptography of its own — no key derivation, no cipher, no password comparison.
+
+**A password is never accepted as a command-line value.** There is no `--password`, no `--user-password` and no `--owner-password`: `argv` is world-readable in `/proc` and lands in shell history, so the harm would happen before the tool could refuse. Passing any of those three spellings is a usage error (exit 2) naming the three supported paths, in order of preference — in the separated form (`--password hunter2`) and in the joined one (`--password=hunter2`) alike, and the value is never echoed back in either:
+
+| Path | Spelling | Notes |
+|---|---|---|
+| A file | `--password-file PATH`, `--owner-password-file PATH`, `--user-password-file PATH` | The first line only. A single trailing newline is stripped; no other whitespace is, because a password may legitimately end in a space. |
+| Standard input | the same flags with `-` | One line. Only one slot may read from stdin per run. |
+| The environment | `PDF_TOOLKIT_PASSWORD`, `PDF_TOOLKIT_OWNER_PASSWORD` | Consulted only when no flag was given for that slot. |
+| A prompt | none | Only when stdin is a terminal. Never on a pipe, where it would hang. |
+
+With none of those available the run exits **6** and writes nothing.
+
+Run `chmod 600` on any password file. The tool warns when one is readable by group or other, and recommends exactly that — it warns rather than refuses, because refusing to read a 0644 file would break more scripts than it protects.
+
+**The environment channel is weaker than a file, and this document says so rather than implying otherwise.** A process's environment is readable through `/proc/<pid>/environ` by any process running as the same user, and it is inherited by every child the tool spawns. A password file with restrictive permissions is the stronger choice; the environment variable exists because a CI system often has no better option.
+
+No secure erasure is claimed, anywhere. A resolved password is held in a buffer that is zeroed after use, but Python may already have copied it while decoding the file, and swap and core dumps are outside a process's control. The same goes for the `.bak` sidecar and for temporary files: they are deleted, not shredded.
+
+`encrypt --in-place` needs one more word from you, and it is the one place where the safety default and the security default point in opposite directions. The `.bak` sidecar is a copy of the **original**, so an in-place encryption would leave plaintext sitting next to the ciphertext, silently. So it refuses (exit 5) unless you pass `--no-backup` (keep no plaintext copy) or `-y` (keep it, knowingly).
+
+**Permission bits are advisory.** They are a request to the reader, not a lock: only cooperating readers honour them, any reader holding the file may ignore every bit, and a reader that can display a page can extract it. Encryption protects the content; the bits on their own protect nothing. `--allow` takes a comma-separated, repeatable list from `print`, `print-highres`, `copy`, `modify`, `annotate`, `forms`, `assemble`, `accessibility`, plus the exclusive `all` and `none`; omitting it grants nothing. `accessibility` is granted whatever you ask for — PDF 2.0 deprecated that bit and conforming readers always permit it — and `permissions` reports what the document actually grants rather than what was requested. **`print-highres` also grants `print`**: a reader permitted to print at full resolution may obviously print at low resolution, and the format has no spelling for “high but not low”, so asking for the one token grants two. That is the format's behaviour rather than this tool's choice, and it is disclosed at the flag that causes it instead of being left for `permissions` to reveal afterwards.
+
+`decrypt` round-trips the **page tree** byte for byte: the decoded content streams, the page dictionaries and every embedded image's raw bytes come back identical. The whole file does not, and nothing here claims it does — `/ID`, `/Encrypt`, the trailer, the cross-reference table and object numbering all legitimately change on any resave.
+
+## OCR and Office conversion
+
+`ocr` and `convert` are the two verbs that depend on a system binary rather than a Python wheel — the two verbs `pdftoolkit doctor` can legitimately report as unavailable.
+
+`ocr` drives the **tesseract** binary. For every selected page it renders the page, recognises a text-only layer, and overlays that layer on the **original** page object — the page's own image is never re-rendered, and a byte-level check proves the image stream is identical before and after. `--skip-text-pages` leaves a page that already has extractable text untouched (no render, no OCR call). This build ships whatever tessdata language packs the host has installed; `--lang` is validated against exactly that list (`pdftoolkit doctor`), and a pack that is not installed exits 3 with an install hint naming it. No accuracy or confidence claim is made anywhere in this tool — `ocr` is described here by its engine, not by a quality promise.
+
+`convert` drives headless **LibreOffice** (`soffice`) to turn an office document into a PDF. Each invocation gets its own isolated LibreOffice profile directory and converts into a private scratch location first — LibreOffice never writes to the destination directly, and the destination is only touched through this tool's one write chokepoint. An exit 0 from `soffice` having produced no output file is treated as a failure here, not a success, because that is a real and well-known LibreOffice failure mode. `--timeout` bounds one conversion; on expiry the whole process group is killed, so no `soffice.bin` daemon is left running.
+
+## Development
+
+```bash
+make test      # run the test suite
+make ci        # the full local gate: format, lint, types, tests, licenses, SAST, CVEs
+```
+
+`make help` lists every target. `make ci` is a **subset** of CI, run with the same commands — it does not predict CI. What runs locally, what does not, and why is declared in `.github/gate-parity.toml` and printed by `make ci`'s own epilogue on every run. No target degrades to a weaker substitute or exits 0 when its check did not run.
+
+Contributions are accepted under the Developer Certificate of Origin (`git commit -s`). See `CONTRIBUTING.md` for the commit conventions and `TESTING.md` for how to run each suite.
+
+## Known issues
+
+Open defects and planned work are recorded, per finding, in the maintainer's planning tree:
+
+- `ai_plans/pdf-toolkit/BACKLOG.md` — the groomed intake list.
+- `ai_plans/pdf-toolkit/qa/FINDINGS-LEDGER.md` — every finding a QA sweep has raised, with its state and its evidence.
+
+**Those artifacts live in the maintainer's planning repository and are not part of this distribution.** They are not shipped in the sdist or the wheel and are not present in a clone of this repository; the paths above are where they live for anyone reading this source tree beside it.
+
+The most recent sweep carrying a readable verdict is `2026-09-03_113318`, taken at commit `7afdb1a`. This section names a sweep and a commit and never a tally — a count is wrong the day after it is written, and the ledger's own header could not hold one still for two days. Read the ledger for what is open right now.
+
+If a sweep ever records nothing open, this section still stands and reads *no open findings are recorded as of sweep `<id>` (`<sha>`)*. It is not deleted: a momentarily vacuous pointer is still the affordance, and deleting it silently removes the only place a user is told where the defects are.
+
+## License
+
+Apache-2.0 — see `LICENSE` and `NOTICE`. `THIRD_PARTY_LICENSES` is generated from the resolved environment and ships in both the sdist and the wheel.

pdf_tooling-0.1.1.dist-info/RECORD

@@ -0,0 +1,89 @@
+pdf_toolkit/__init__.py,sha256=DXMZ9LWgYMu239D_i3rd14I-BBK7XBE2-Ul1gBWTeAw,1099
+pdf_toolkit/__main__.py,sha256=8A97Ke8Ee8eRZmpGODr0YDFjTVwR-JeMD_aco_tTZYo,367
+pdf_toolkit/errors.py,sha256=vIWHj7uJDw6C57zvAtTdlaNs1D8o6zfJ1ETpnBCkSfw,9410
+pdf_toolkit/models.py,sha256=DGxWYTZJN5mZEXI9L0xUA84pMS1_UE4jAwn_RtET_aU,20535
+pdf_toolkit/secret.py,sha256=7ExXfr8TF2I0vF6fLITrXUxC5h0VtPwNeC3RYwvEB5w,5706
+pdf_toolkit/adapters/__init__.py,sha256=FSo5bkDD9NnZT2nulNvg-YCk86ZIjH2zzWIwRe-B5KI,4809
+pdf_toolkit/adapters/pdfium_raster.py,sha256=w_AfoTgZ1D8tzwYDncpNrnrSTD__r1yLcvk-nai-8Lk,12538
+pdf_toolkit/adapters/pdfium_text.py,sha256=f3N0V6DZK8pIcT8iEfekcoVD_aScytx2QA4YnUMztBY,3850
+pdf_toolkit/adapters/pdfplumber_text.py,sha256=JQCx2LcMHvns3GOFVoXDbjsKhd4t-7w84O0Fzempoa0,7392
+pdf_toolkit/adapters/pikepdf_structure.py,sha256=_R72mP-Mo4sybp2dbwCWmr7mKErv0Ea1yUfnpOc2ek0,21830
+pdf_toolkit/adapters/pypdf_structure.py,sha256=cUK8shPYMWRG0h2YgzH4FNN6vlfX5XRZe4f7H0sXRw0,44955
+pdf_toolkit/adapters/reportlab_compose.py,sha256=sHwvjLFnFpenFFNsrIbM5qUuWypSCR0wmgOqute-83A,13835
+pdf_toolkit/adapters/soffice_office.py,sha256=VLya6KzHat4qL8vD_LW7nv0odgxs4Q4ff2nffBsXHyk,7666
+pdf_toolkit/adapters/subprocess_util.py,sha256=pKUWDlU7u7oNsCdT8lT0bjDklaYP_NZIapqIHAX3SuA,16910
+pdf_toolkit/adapters/tesseract_ocr.py,sha256=wNn3hMGw5kSL9GfDkqy4vYaFh4NH4cIyslO4_sAjKRA,18069
+pdf_toolkit/cli/__init__.py,sha256=fdB_zWcITGiOnGZm0g1I3hY-15c2YjUNHSBVcJs10II,363
+pdf_toolkit/cli/cmd_compose.py,sha256=TYwyDep6mWdFJQVPebhjLZ188fV0QXuNyTLdde7qy78,6912
+pdf_toolkit/cli/cmd_compress.py,sha256=-M1tJeVXNdvChFrAqhKG0fYRy9Ue3MMNlnDIcozjgsI,9981
+pdf_toolkit/cli/cmd_create.py,sha256=kMpms2X1cWbNfIO_noHqvJZ9-31bBhODWkcmCjmsRYI,8932
+pdf_toolkit/cli/cmd_decrypt.py,sha256=5yG4qIZqCDTYtqqhvOapUvJWeZnPyqRtvkOoFdw8RVA,4244
+pdf_toolkit/cli/cmd_delete.py,sha256=rp-BidVyVyhuAspdKAFzxLt0YdSQ-KTICRkT-IEZYX8,5193
+pdf_toolkit/cli/cmd_doctor.py,sha256=fCb4yz-zBI6z40TyAyQXeSMWogyAPQSJ-5bm4vr5KKU,5848
+pdf_toolkit/cli/cmd_encrypt.py,sha256=lwz4Hwt7KHo5g4gC10AOCFKpEf3HXUpoeUMmgN_8l40,12182
+pdf_toolkit/cli/cmd_extract.py,sha256=aI7nShOGCMCD__JMBGQVvkIbnwGI0Ft4GUg8P1pDNTI,5661
+pdf_toolkit/cli/cmd_info.py,sha256=X3FFOEc40aHFReKy9cuBV7ZcTVhksYIAGVAhEYOazDs,6624
+pdf_toolkit/cli/cmd_linearize.py,sha256=n3AyZwP1SN70po2GUlsFOG4tHUXOBk022vrQIg_YZXw,3098
+pdf_toolkit/cli/cmd_merge.py,sha256=pi8HAlY9W5oGZSPZ1SFNlQw-IVHH6E-VaZe8TuQo-xQ,3993
+pdf_toolkit/cli/cmd_meta.py,sha256=GroHWC73tQJrrqSLO3gI7EoTE1GAfUhxMTM0iIgj_bU,1132
+pdf_toolkit/cli/cmd_meta_get.py,sha256=MraNWYSvWka2FMPjHUccf-HmiUrLEIhDNmRD-fRaLxU,5524
+pdf_toolkit/cli/cmd_meta_set.py,sha256=xCBcv9w8twC9zNUaJHoVqpKndjLTd2yx1lvl16L0xuI,5685
+pdf_toolkit/cli/cmd_ocr.py,sha256=qxtzTSQf49nztjv9sDsoMi1MJ-PcwpgWGW4t3dPET4A,7210
+pdf_toolkit/cli/cmd_office.py,sha256=IvOookyk0FvFi167Zn4LYXwWrLCtBJFpBFMMoLfn4YU,6296
+pdf_toolkit/cli/cmd_permissions.py,sha256=jPE1ZpGTjH1-kh-Hw4NAXc5KgmFjE16PtnsUcS4p65I,4369
+pdf_toolkit/cli/cmd_rasterize.py,sha256=GqbRiM41xHxJ_Av8qJdMmcS8-KhqsY_jm0I7qiLEnik,7225
+pdf_toolkit/cli/cmd_reorder.py,sha256=lbfZDD1T8mFbY6Ys95-6mS0zZHMo8WtWMsc8rE_0eyI,4753
+pdf_toolkit/cli/cmd_repair.py,sha256=gd9fGh3ybMaoxz6-tYQ3FK19eNt0NXNIhUKfEvd2l1c,3392
+pdf_toolkit/cli/cmd_rotate.py,sha256=nVdbhVVLA4DtGhyAokMIcfusou5T2-YCqKE5U3cO96s,5937
+pdf_toolkit/cli/cmd_split.py,sha256=gZFGr2Fk3sfUdi5iEffXhwLHDkdWM4L2880tdr3hJNs,4784
+pdf_toolkit/cli/cmd_stamp.py,sha256=IZP_6PTYFgtEtCQqG6FGxttNVEnIM3hPUgd-F5QRYz0,4956
+pdf_toolkit/cli/cmd_tables.py,sha256=Ei6RHk4mujjQL_T0UGFSxE7AVXIx4D8Jy5251JR9DPw,9925
+pdf_toolkit/cli/cmd_text.py,sha256=G5kwamX5PglfuKitmWmy_txDnZ60NpD0VnN18GglRSI,8134
+pdf_toolkit/cli/cmd_version.py,sha256=R-8s98zQzM2m7dYvax7iiZ-RS0ao-8Wk5MnQl8LZTPk,4307
+pdf_toolkit/cli/cmd_watermark.py,sha256=n8qVGWMy2nOBqOXhHzlswFJRltF67USA0pjH4bYtuVY,6054
+pdf_toolkit/cli/common.py,sha256=oVJ7KxfLqmuIaI9NYH1iM7KgIXj8eBLMnpXnZ2A4M5U,51702
+pdf_toolkit/cli/exit_codes.py,sha256=gve2MT3tR6C9I38GEKoa4EaT8fERb6RnNzHRTpu7xnI,1850
+pdf_toolkit/cli/main.py,sha256=xZ-HG9-T-bm7bPTcKF20gk020wpm8u4KhRnbYvloA7U,17826
+pdf_toolkit/cli/password.py,sha256=w6_607BGJIU64X1erC-qOqcTVW5TmYD2-RM-pRqrPmo,11166
+pdf_toolkit/ops/__init__.py,sha256=FwytaUvU8YxjzgY6HECWbRwtKUDf2XKBpeOAXevPU0s,521
+pdf_toolkit/ops/compose.py,sha256=Cx07AlxvgFdrNIyWQJqPd1ptOlIPVmV-NlyphZDKsgY,36477
+pdf_toolkit/ops/crypto.py,sha256=zY9gkwfjljne1RKqk_7RL4p4vYyZHZf57dNvwoO4VUo,25593
+pdf_toolkit/ops/inspect.py,sha256=g3ArEqb3xd6P7hnSrMVVF25DRCnzGV3bMebhRICsLW0,7221
+pdf_toolkit/ops/merge.py,sha256=LMlIgwQIpS5_KfFhKFI07tMLlP13QAHuy4dVuwXsLOo,9030
+pdf_toolkit/ops/metadata.py,sha256=VkDB5XmdjIIVXl9Ntfsh3Qkey-S_LNjD1EoDev5S_80,10520
+pdf_toolkit/ops/ocr.py,sha256=IfbLYQBM_BUh9UEr1JwZTFSSmNadY1_e2vutfhF2lG0,17836
+pdf_toolkit/ops/office.py,sha256=RnMyV_VOKRl6HmEUAG2AGSa51imqgLav2CKHcmw4CyA,11517
+pdf_toolkit/ops/optimize.py,sha256=U9vMl0jTCgPood2990YqFWOYSc14K46Ga19MMjF2GWk,20533
+pdf_toolkit/ops/overlay.py,sha256=waPS0U6sY1N7XZZRA9_Z-3fMqVJoUmmXcYvAScyzmg0,15926
+pdf_toolkit/ops/pagerange.py,sha256=F28VbGgMrMQVi0jDU0Y12I-4ZK_3kKwVoPxpMEK3vHo,18363
+pdf_toolkit/ops/pages.py,sha256=DEYywR5XAMLPnYeTPPnG5MKoMRZnAfvKsyG5g5rwUQs,28965
+pdf_toolkit/ops/procpool.py,sha256=LtjSJt4zZLEQ5ywJzQmw1hkU5I2KPU-TImq4FNj9Og4,20063
+pdf_toolkit/ops/raster.py,sha256=tYL7xMzRTXK-guCfVe1ts85PSg8LS8p2dWVmoWV4mXA,17838
+pdf_toolkit/ops/split.py,sha256=HzdgL01-PB4rC9R7A-8yFYv8VYjTpgku_gWKhsQZGHA,11778
+pdf_toolkit/ops/textract.py,sha256=J15GWarNvq0PnzFyol-RhD_c_foBpGd-vXiRxVk63xs,31289
+pdf_toolkit/output/__init__.py,sha256=Rw2YitaHNiKBuvCY42CCrBVpcbsK2HD258_0BtUlw1U,2626
+pdf_toolkit/output/json.py,sha256=T0cxj7VVndA7Nb1NkZnKkQYf2QNNBkbTYlKVO-ZPuT0,1855
+pdf_toolkit/output/logging.py,sha256=Ligm1AJ9oj95-uXXvI4vbjyU2SGAZF_tawwf00puH4Q,8522
+pdf_toolkit/output/table.py,sha256=d6WEj8JreoWlcVEx1Fqhq8C6x6tT53Tp53xD0ckgr1g,2679
+pdf_toolkit/ports/__init__.py,sha256=AkY7B6eyn10l6JOAgeWAgDk0P_EJ9qKpxAwVLR5VV-A,11624
+pdf_toolkit/ports/compose.py,sha256=lD4s395jj9MpevzunIBn2QHbZaUuPh_kOWJyRCR3vgM,8101
+pdf_toolkit/ports/ocr.py,sha256=C_pwDckQs5k2t-qCjYz8ZIwUEpreuKEP9khvD4nxhgA,4886
+pdf_toolkit/ports/office.py,sha256=fTG7TYLsAscWxe7GG-iDXyS47Ywa7J6XUeqLVztj4t4,4290
+pdf_toolkit/ports/raster.py,sha256=CBeOp3fFZtBskbhSt4obQlacaOBQMuLdnUe6BxdSLPw,3819
+pdf_toolkit/ports/structure.py,sha256=ZlUMFMG0J0iQjBHUCJhiL52eoWL4XPz2RR3Wqy4napo,34151
+pdf_toolkit/ports/text.py,sha256=ogn1NNQl6u_G33SMsPy3654yezZUeWxfhtI6-bxSG2Q,9510
+pdf_toolkit/safety/__init__.py,sha256=cGtiUyYXQx9CwLkMzdIrUvIBn7Bdz9Eewdbi3OfXa4M,2890
+pdf_toolkit/safety/_faults.py,sha256=e4Yi_QSbi8wH4XQnRAukVBkQIzeLNqOeWNLni57cQ80,3731
+pdf_toolkit/safety/atomic.py,sha256=3RQ1h6Hm3zC4sCHYaLlFZcj9sf_UH-bc3I-8QsesL4U,42072
+pdf_toolkit/safety/confirm.py,sha256=6faASnO40bEoRtxLy9_CkddaFm9o55TMpwo0S1mpwcI,8192
+pdf_toolkit/safety/naming.py,sha256=0vU8kF00s9XDAzrDMc5U5sfCvrwh1T5sUdd23ymLVBY,7522
+pdf_toolkit/safety/paths.py,sha256=YplcNiZoluATGL5qkIpBc6FM7DC5YbLWsNIq1tfm7aE,18525
+pdf_toolkit/safety/policy.py,sha256=D_vrO9ecqlHhK4pmmzSGTUvcWer9cJ8VgFXWOa8gJ_o,2916
+pdf_toolkit/safety/tempnames.py,sha256=STZNXKu6ZZR2W3ptYWTLEl5VWiIxrZx8rnj2efs_e2E,2493
+pdf_tooling-0.1.1.dist-info/METADATA,sha256=p4niqi6FQNR0rItDbWwn2jMejJ-ZjZ9AZQ1bCXm_QQ0,17202
+pdf_tooling-0.1.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+pdf_tooling-0.1.1.dist-info/entry_points.txt,sha256=d7xs_VQ5LN7_-2JhvCSGI8GEXo7kOSveD4vUIuMeqkg,97
+pdf_tooling-0.1.1.dist-info/licenses/LICENSE,sha256=1ULOZeHoWKCV7NO8Td8BMfIRdB4ZJqZQPHHf3vm5OaQ,11344
+pdf_tooling-0.1.1.dist-info/licenses/NOTICE,sha256=vgSDj_0vBunBJBft0FJRIKWKF2ZPdx5qeZ1RiMcoedY,1704
+pdf_tooling-0.1.1.dist-info/licenses/THIRD_PARTY_LICENSES,sha256=lnY6CBQZyTqjR_TeKCK3yRQvVmJb9t1jmbH26nqAccs,160341
+pdf_tooling-0.1.1.dist-info/RECORD,,

pdf_tooling-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

pdf_tooling-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pdf-toolkit = pdf_toolkit.cli.main:main
+pdftoolkit = pdf_toolkit.cli.main:main

pdf_tooling-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Armando Herra
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

pdf_tooling-0.1.1.dist-info/licenses/NOTICE

@@ -0,0 +1,42 @@
+pdf-toolkit
+Copyright 2026 Armando Herra
+
+Licensed under the Apache License, Version 2.0. See LICENSE for the full text.
+
+This product orchestrates third-party PDF engines rather than implementing PDF
+parsing or rendering itself. Every engine on the call graph is permissively
+licensed; nothing under AGPL, GPL or LGPL is reachable — not as an import, not
+as an optional extra, and not as a subprocess fallback.
+
+The complete, generated attribution list for a given build lives in
+THIRD_PARTY_LICENSES, produced from the resolved environment and shipped in
+both the sdist and the wheel.
+
+Engine attribution summary:
+
+  pypdf                 BSD-3-Clause
+  cryptography          Apache-2.0 OR BSD-3-Clause
+  pypdfium2             BSD-3-Clause / Apache-2.0 (Chromium's pdfium)
+  reportlab             BSD
+  pikepdf               MPL-2.0 (bundles libqpdf, Apache-2.0)
+  pdfplumber            MIT
+  pdfminer.six          MIT
+  pytesseract           Apache-2.0
+  Pillow                MIT-CMU
+  typer                 MIT (bundles Click, BSD-3-Clause)
+
+MPL-2.0 appears above and is deliberate rather than overlooked. MPL-2.0 is
+file-level copyleft: its obligations attach to modified MPL files, not to a
+work that merely depends on the unmodified library. pikepdf is used unmodified
+and is neither patched nor vendored, so no MPL file is distributed in a
+modified form by this project. It is recorded here rather than hidden.
+
+Optional, never installed by default:
+
+  WeasyPrint            BSD   (the [html] extra; needs system pango/cairo)
+
+Runtime-detected system binaries, invoked as separate processes and never
+bundled into the wheel:
+
+  tesseract             Apache-2.0
+  soffice / LibreOffice MPL-2.0