Generic Typst-based report renderer. Turns structured YAML/JSON reports into sober, reproducible PDF documents.
Go to file
Dandaedre 091dfd7c5b
feat: render generic reports to PDF
2026-09-15 22:32:57 +02:00
docs feat: render generic reports to PDF 2026-09-15 22:32:57 +02:00
examples feat: define generic report v1 contract and YAML JSON validator 2026-09-15 16:32:36 +02:00
schema feat: define generic report v1 contract and YAML JSON validator 2026-09-15 16:32:36 +02:00
templates feat: render generic reports to PDF 2026-09-15 22:32:57 +02:00
tests feat: render generic reports to PDF 2026-09-15 22:32:57 +02:00
tools feat: render generic reports to PDF 2026-09-15 22:32:57 +02:00
.gitignore feat: define generic report v1 contract and YAML JSON validator 2026-09-15 16:32:36 +02:00
AGENT.md Add AGENT.md 2026-09-15 14:50:21 +02:00
AGENTS-TASKS.md feat: render generic reports to PDF 2026-09-15 22:32:57 +02:00
Jenkinsfile feat: render generic reports to PDF 2026-09-15 22:32:57 +02:00
LICENSE Initial commit 2026-09-15 14:49:58 +02:00
README.md feat: render generic reports to PDF 2026-09-15 22:32:57 +02:00
requirements.in feat: define generic report v1 contract and YAML JSON validator 2026-09-15 16:32:36 +02:00
requirements.txt feat: define generic report v1 contract and YAML JSON validator 2026-09-15 16:32:36 +02:00

README.md

Reportist

Reportist is a generic Typst-based report renderer.

It turns structured YAML/JSON report definitions into sober, reproducible PDF documents.

report.yaml
    ↓
 Reportist
    ↓
report.pdf

The project handles report structure, validation, presentation, themes and rendering. It is intentionally independent from the systems producing the information contained in a report.

Reportist originates from the reporting tooling developed for the Beffroi diagnostics workflow, but is designed to be usable independently.

Status

🚧 Early development / migration

The renderer is currently being extracted and generalized from the previous typst_reporter project.

See AGENT.md for repository ownership and development rules. AGENTS-TASKS.md tracks migration passes, completed work, acceptance criteria, and the next-pass handoff.

Render a report

Requirements: Python 3.11+, the pinned packages in requirements.txt, Typst 0.15 or newer, and the fonts selected by the report. The examples use DejaVu Sans and DejaVu Sans Mono.

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python tools/render.py examples/example-report.yaml \
  --output output/example-report.pdf

The CLI validates before rendering and works from outside the repository. It refuses an existing output unless --force is explicit. Exit 0 means a PDF was published, 1 means input, validation, asset, Typst, or I/O failure, and 2 means invalid CLI usage. Branding and logo paths come from report data; reports without branding use neutral colors and no logo.

Contract validation

The version-1 schema, standalone validator, and synthetic examples are available. See contract documentation for setup and validation commands. The first generic PDF rendering slice is implemented. Long-content visual review and clean-clone verification remain migration tasks.

License

Software source code is licensed under the MIT License.

Examples and bundled assets may be subject to their own terms where indicated.