Skip to content

pdf-book-to-llm v0.2.0

Choose a tag to compare

@deadboyccc deadboyccc released this 17 Nov 19:39
· 6 commits to main since this release

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 run book2md. uv run python book2md.py still works.
  • pyproject.toml + uv.lock, so uv sync from a clone works as the setup guide always said. Docling 2.150 is locked.
  • --out DIR to choose the output root (default ~/study/corpus); previously you had to edit the script. Also --version.
  • Exit codes: 0 all pages written, 1 failed or partial, 2 invalid 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 0 or 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).
  • --help waited 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