Repository navigation
PageLedger 0.9.0 is the candidate for 1.0. It writes down the contract that 1.0 will keep (commands and options, exit codes, configuration keys, the adapter protocol, artifact schemas, warning codes and holds) and tests the package against it; see stability. 0.8.0 was prepared but never published, so its changes ship here too; if you come from 0.7, read both sections of the changelog.
- Start without a config.
pageledger process SOURCE --out DIRreads a PDF, page images or a text file with local tools only, shows progress, and stops cleanly on Ctrl-C with theresumecommand. - New sources. Page images and IIIF items (
fetch); a library's own OCR (ALTO) can be used as a witness. - Reading. Dense pages read in tiles; Latin-script print (
latin-print-0.1) alongside Russian; image-stage pages read concurrently in batches (from 0.8). - Review. An HTML review view with corrections, alongside the review sheet; reviewed jobs export only what was checked.
- Received folders don't run code. A job, run or bundle someone sends you can't make PageLedger import code or contact a server you didn't name. Custom adapters load only from the folder given with
--adapter-path, a vision server off this machine needs--trust-endpoint, and a refusal leaves the folder byte-identical. See jobs, runs and bundles you receive and SECURITY.md. - Verification.
verifyre-derives a run's normalized pages, grades and review queues, so a one- or two-file edit fails, and names the file that changed. - Text fidelity. Text sources keep their line endings byte for byte, right-to-left rows are no longer reversed, engine agreement keeps combining marks inside words, and numbers like
1,5and12 34are recorded as conversion errors instead of being misread. - Single-word commands.
inspect,verify,review,export,initand the rest; the earlier names still work as hidden aliases.
Before release the branch had six independent reviews (package and schemas; tests, docs and packaging; untrusted input; a newcomer installing from PyPI; text fidelity; and a review of the fixes). Each of about 130 findings was reproduced before it was fixed. Every fixture written by 0.5.2 to 0.8.0 still verifies byte for byte. Known limits are listed in capabilities and limits.
Validation: the full suite passed with and without the pdf extra (2,686 and 2,502 tests) with Ruff and mypy clean, CI passed on Python 3.10 to 3.14, wheel and source-package inventories passed, and both maintained tutorials passed against isolated installations of both packages. The wheel built byte-identically in the local build, the verify run and the publication run.
Install with pip install pageledger==0.9.0, or pip install "pageledger[pdf]==0.9.0" for PDFs; pageledger[rapidocr] adds the RapidOCR engine and pageledger[ru] the Russian lexicon. Scanned PDFs also need separately installed OCR tools. pypdf is pinned below 7, which changes extracted text.
The attached distributions and SHA256SUMS are the exact artifacts from the protected PyPI publication workflow (run 43745291786).
04e48e264a9286fe38b10fd8db543fca1ca3944a3b94a06a7c4c54ecd504716e pageledger-0.9.0-py3-none-any.whl
7145b880ed8b27602d3cc92295690c1320d50275fc0864f8842b836b0777a22a pageledger-0.9.0.tar.gz