facturization

Generate high-quality PDF invoices from a YAML specification.

Background

I needed an invoice generator for my business with high quality typesetting, but I did not like any of the LaTeX templates I could find, and I wanted full control and greater flexibility compared to the projects I had seen. And so here we are.

Requirements

• A TeX distribution providing pdflatex (e.g. TeX Live) with a few common packages: geometry, ragged2e, booktabs, tabularx, enumitem, hyperref, and babel. These ship with a full TeX Live install.

Installation

Run it directly with uv:

uv run facturization path/to/input.yml --output-dir out/

Or install it as a standalone command-line tool:

uv tool install facturization

Pip is also supported:

pip install facturization

Usage

facturization path/to/input.yml

The only mandatory argument is the path to the input YAML file. --output-dir (-o) defaults to the current directory. For an input named foo.yml the tool writes foo.tex and foo.pdf (alongside pdflatex's .aux/.log) into the output folder.

Example

Try out the example from the repo:

uv run facturization example/details.yml --output-dir example

This renders example/details.yml to example/details.pdf:

Input schema

Top-level keys

Party

Used for both from and to.

Service

Each entry in the service list is one line item.

Development

Linting and type checking are handled by Ruff and ty, configured in pyproject.toml. Both are part of the dev dependency group, so uv sync installs them.

# Lint
uv run ruff check .

# Verify formatting (no changes written)
uv run ruff format --check .

# Apply auto-fixes and reformat
uv run ruff check --fix .
uv run ruff format .

# Type check (strict mode, all rules as errors)
uv run ty check .

Credits

Inspired by mrzool/invoice-boilerplate. This project takes the same idea of invoice typesetting from a plain data file, but replaces the heavy pandoc dependency with a small uv + Python + Jinja2 pipeline that renders a LaTeX template and compiles it with pdflatex.

License

MIT