Skip to content

PyVELM v0.25.0

Release date: 2026-05-29

Minor release: bundled document layouts & PDF printing, per-company navigation layout in core base, and a stricter CI coverage gate.

Highlights

Document layouts (document_layout)

Odoo-style external document layout on res.company — logo, address block, accent colours, paper format, and eight layout variants (light, boxed, bold, folder, …). Business modules register printable documents; the framework wraps body HTML and renders PDF via wkhtmltopdf.

  • Settings UI + live layout designer (Settings → Organization → Layout & Print)
  • Routes: /report/pdf/{key}/{id}, /report/html/…, layout preview/designer
  • API: document_layout.api.register_document, render_html, render_pdf

Guide: document-layout.md

Per-company navigation layout (base 0.31)

res.company.menu_layout lets each company choose apps or sidebar shell chrome independently of the global PYVELM_MENU_LAYOUT env var. Middleware in base.web resolves the active company per request.

Configure on Settings → Companies → Branding & white-label → Navigation layout.

Guide: navigation.md#per-company-override

Developer experience

  • CI coverage floor raised to 90%
  • Unit tests for document_layout and menu layout resolution

Upgrade

pip install -U pyvelm==0.25.0

Run migrations after upgrade (adds menu_layout on res.company):

pyvelm db migrate

Install document_layout from Apps (or add to your module DEPENDS) when you need PDF printing. Install wkhtmltopdf on the server for PDF routes.