Repository navigation
pdf-book-to-llm v0.2.0
First release of book2md: the converter is now an installable, tested project. It is reproducible from its lockfile and robust against the mistakes users actually make.
Added
- Installable command:
uv tool install git+https://github.com/deadboyccc/pdf-book-to-llm, then runbook2md.uv run python book2md.pystill works. pyproject.toml+uv.lock, souv syncfrom a clone works as the setup guide always said. Docling 2.150 is locked.--out DIRto choose the output root (default~/study/corpus); previously you had to edit the script. Also--version.- Exit codes:
0all pages written,1failed or partial,2invalid arguments. - CI: lint, lockfile check, unit tests on Linux, macOS and Windows (Python 3.10, 3.12, 3.13), and a package build.
Fixed
- A start page past the end of the book, or a file that isn't a PDF, printed a Docling traceback and left an empty output folder behind. Now it prints one error line and writes nothing.
- A partial conversion silently wrote fewer pages and printed "Done". Now the missing pages are listed with Docling's errors, and the exit code is 1.
--scale 0or a negative scale only failed deep inside Docling. Now it's a usage error.- Both docs linked to files that did not exist (
docs/setup-and-script.md,README.md). --helpwaited seconds for Docling to import. Docling now loads only when converting.
Tested
- 0 → 48 unit tests, with Docling replaced by fakes; 99% line coverage.
- Validated from a fresh clone in a sandbox; CI green on every job.
Assets
| File | What |
|---|---|
book2md-0.2.0-py3-none-any.whl |
Wheel (uv tool install ./book2md-0.2.0-py3-none-any.whl) |
book2md-0.2.0.tar.gz |
Source distribution |
SHA256SUMS |
Checksums |