PyVELM v1.2.0¶

Release date: 2026-06-10

Minor release after v1.1.1: fluent ORM field builders, nested create dialogs, geo bootstrap seeding, and expanded view widget hints.

Highlights¶

Fluent ORM field builders¶

Chain field options on model classes:

name = Char().required().string("Name").tracking()
country_id = Many2one("res.country").ondelete("SET NULL")

Constructor kwargs (Char(required=True)) still work. Use Char.bare() in tests outside a model class. See Declaring models → Fluent field chains.

Nested create dialogs¶

Creating a related record inside a PvDialog (e.g. Create Africa while composing a country) now restores the parent dialog on save instead of closing both layers.

Geo bootstrap¶

Install / Sync seeds 7 continents plus your detected country (PYVELM_GEO_COUNTRY, TZ, or locale) — not the full ~250-country set.
Seed geography data on the Countries list runs the full import in the background and shows an immediate toast.

Widget hints on `Char` fields¶

WidgetHint now includes text, html, code, file_url, color, and related values for IDE autocomplete. A Char column can use Field.make("notes").widget("text") for a textarea.

Upgrade¶

pip install -U "pyvelm==1.2.0"
pyvelm db migrate

Sync geo_data after upgrade if you use geography reference data.

See CHANGELOG for the full list.