erplibre/script/todo/qemu_deploy_form.py
Mathieu Benoit 95e70150c3 [REF] todo : un fichier par sujet, un socle par formulaire
todo.py passait 13 000 lignes : plus personne n'y trouvait où une chose
vivait. Il en garde 4 400 — les menus et les aides générales — et six
fichiers portent chacun un sujet, assemblés en mixins sur la classe TODO.
Aucun membre perdu : 438 avant, 438 après, et treize sources modifiées
seulement là où un appel de classe devait changer de nom.

Les deux formulaires de déploiement posent le même travail : ils partagent
maintenant la logique pure, le CSS, la fabrique des rangées de ressources
et les gestes du plan (surcharges, verrous, exemplaires, renommage).
Vérifié en rendant le formulaire QEMU avant et après, sur neuf gestes :
même écran au SVG près, même état, même spec.

--- EN ---

todo.py had passed 13,000 lines: nobody could find where anything lived.
It keeps 4,400 — the menus and the general helpers — and six files each
own one subject, assembled as mixins on the TODO class. No member lost:
438 before, 438 after, and thirteen sources changed only where a
class-level call had to change name.

Both deployment forms do the same work: they now share the pure logic, the
CSS, the resource-row factory and the plan's gestures (overrides, locks,
copies, renaming). Verified by rendering the QEMU form before and after
across nine gestures: same screen down to the SVG, same state, same spec.

Assisted-by: Claude Opus 5
2026-08-25 03:16:07 -04:00

1338 lines
60 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env python3
# © 2021-2026 TechnoLibre (http://www.technolibre.ca)
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
"""Formulaire Textual de déploiement QEMU, et vue de progression.
Deux interfaces mènent au même déploiement : les invites en ligne de
`todo.py` et ce formulaire. Toutes deux produisent la MÊME structure — la
« spec » — que `TODO._qemu_run_spec` consomme. Rien n'est décidé ici qui ne
puisse l'être là-bas, et réciproquement.
- build_vms(...) / plan_rows(...) : logique pure, testable sans terminal.
- run_deploy_form(ctx, run_app=True) : le formulaire ; renvoie une spec ou None.
- run_deploy_progress(jobs, ...) : blocs repliables par VM pendant le
déploiement, avec copie du log vers le presse-papiers (OSC 52).
Le formulaire ne lance AUCUNE commande privilégiée ni réseau : tout appel
`virsh` passe par sudo et une invite de mot de passe casserait l'affichage
Textual. Les données coûteuses (domaines existants, branches distantes) sont
préchargées par l'appelant et arrivent dans `ctx`.
"""
from __future__ import annotations
import os
import re
try:
from script.todo.todo_i18n import t
except Exception: # pragma: no cover - repli si i18n indisponible
def t(key: str) -> str:
return key
from script.todo.deploy_form_lib import ( # noqa: F401
CLIP_LIMIT,
CSS_BASE,
FREE,
INPUT_TO_FIELD,
RES_FIELDS,
RES_FMT,
SELECT_TO_FIELD,
apply_overrides,
apply_profile,
build_spec,
build_vms,
clean_hostname,
clip_payload,
copy_name,
disk_gb,
entry_key,
expand_copies,
fmt_dur,
parse_disk,
parse_ram,
plan_rows,
plan_totals,
positive_int,
res_choices,
res_labels,
res_row_widgets,
res_value,
run_deploy_progress,
vm_name,
vm_status,
)
# Le socle commun aux deux formulaires (QEMU/KVM et Proxmox VE). Réexporté
# tel quel : les appelants historiques importent encore ces noms ICI.
from script.todo.deploy_form_plan import ( # noqa: F401
PlanMixin,
preview_screen,
rename_screen,
)
# --------------------------------------------------------------------------- #
# Formulaire Textual
# --------------------------------------------------------------------------- #
def run_deploy_form(ctx, run_app: bool = True):
"""Formulaire de déploiement. Renvoie une spec, ou None si annulé.
`run_app=False` renvoie l'instance sans la lancer (tests headless)."""
from textual.app import App, ComposeResult
from textual.containers import Horizontal, Vertical, VerticalScroll
from textual.widgets import (
Button,
Checkbox,
Footer,
Header,
Input,
RadioButton,
RadioSet,
Select,
SelectionList,
Static,
)
# Textual 8 a ramené Select.BLANK à un alias déprécié valant False ; le
# sentinelle « rien de choisi » est Select.NULL. Comparer à BLANK ne
# filtrait donc plus rien, et NoSelection — dépourvu de __bool__, donc
# tenu pour vrai — passait pour une valeur jusque dans les totaux.
SELECT_NULL = getattr(Select, "NULL", Select.BLANK)
catalog = ctx["catalog"]
arches = ctx["arches"]
domains = set(ctx.get("domains") or [])
profiles = ctx.get("install_profiles") or []
branches = ctx.get("branches") or ["master"]
host_cpu = ctx.get("host_cpu") or 2
free_ram = ctx.get("free_ram") or 0
base_vcpus = ctx.get("base_vcpus") or 2
extra_disk = ctx.get("extra_disk_gb") or 0
desktop_disk = ctx.get("desktop_disk_gb") or 0
# [(clé, libellé)] — la liste vient de todo.py, source unique.
desktops = list(ctx.get("desktops") or [])
# {clé de saveur: suffixe de nom}, fourni par todo.py qui décrit les
# saveurs — on ne le redéfinit pas ici.
desktop_suffixes = dict(ctx.get("desktop_suffixes") or {})
# Outils de développement d'une VM graphique : [(clé, libellé, indice)] et
# leurs contraintes, toutes décrites dans todo.py — le formulaire ne fait
# que les afficher et rendre les cases cochées.
vm_tools = list(ctx.get("vm_tools") or [])
tool_disk = dict(ctx.get("vm_tool_disk") or {})
tool_arches = dict(ctx.get("vm_tool_arches") or {})
tool_desktops = dict(ctx.get("vm_tool_desktops") or {})
tool_needs_desktop = dict(ctx.get("vm_tool_needs_desktop") or {})
tool_families = dict(ctx.get("vm_tool_families") or {})
distro_family = dict(ctx.get("distro_family") or {})
# Architectures pour lesquelles mise publie un binaire.
mise_arches = set(ctx.get("mise_arches") or ())
# [(clé, libellé)] des magasins d'applications, et les distributions qui
# livrent snapd — la question n'a de sens que pour celles-là, graphiques.
app_stores = list(ctx.get("app_stores") or [])
snap_distros = set(ctx.get("snap_distros") or ())
# Fuseaux proposés, celui de l'hôte en tête (voir todo.py).
timezones = list(ctx.get("timezones") or [])
defaults = ctx.get("defaults") or {}
result = {"spec": None}
AUTO = "__auto__"
# « Serveur » est un CHOIX, pas une absence de choix : lui donner « » le
# rendrait indistinguable de la sentinelle « rien de sélectionné ».
SERVER = "__server__"
def entry_label(e):
star = " *" if e.get("default") else ""
return (
f"{e['distro']} {e['version']}{star} [{e['arch']}] "
f"RAM≥{e['ram']}Mo {e['disk']}"
)
class DeployForm(PlanMixin, App):
# Le socle porte la mise en page et les modales ; ne reste ici que ce
# qui nomme les widgets propres à QEMU/KVM.
CSS = (
CSS_BASE
+ """
SelectionList { height: 10; border: solid $panel; }
RadioSet { height: auto; layout: horizontal; }
/* Ces deux règles portent « .vmrow Select » EN PLUS de leur classe :
« .vmrow Select » (une classe + un type) l'emporte sur « .vmbranch »
(une classe) par spécificité CSS. Écrites simplement, elles étaient
silencieusement écrasées à 15 — et le test, qui ne vérifiait que la
présence de la classe, passait sans rien prouver. La branche porte des
noms longs (« 1.6.0 », « develop », « feature/xyz ») : trop étroite, la
liste les tronque et on ne sait plus ce qu'on a choisi. */
.vmrow Select.vmbranch { width: 34; }
.vmrow Select.vmprof { width: 40; }
"""
)
# Touches de fonction plutôt que ctrl+lettre : ctrl+p est pris par la
# palette de commandes de Textual, et une lettre seule serait avalée
# par le champ de saisie qui a le focus.
BINDINGS = [
("f5", "deploy", t("Deploy")),
("f4", "clear_vm", t("Reset VM")),
("f3", "preview", t("Preview")),
("f9", "dump_state", t("Diagnostic dump")),
("f6", "select_all", t("All")),
("f7", "select_main", t("Main versions")),
("f8", "select_none", t("None")),
("escape", "cancel", t("Cancel")),
]
def __init__(self):
super().__init__()
self.arch = ctx.get("native") or arches[0]
self.profile = "1"
self.custom = {}
self._free = {}
self.overrides = {}
# Vrai pendant qu'on repositionne les widgets nous-mêmes : sans
# ce verrou, poser une valeur déclencherait on_select_changed, qui
# réécrirait une surcharge — une boucle qui se nourrit seule.
self._syncing = False
# Jeu de VM actuellement monté dans le panneau droit.
self._shown_ids = ()
# Génération du jeu de rangées monté. Les identifiants de widgets
# portent un RANG, et le rang se décale quand on coche ou décoche
# une entrée : un événement émis par un widget déjà détruit
# s'appliquerait alors à la VM qui a pris sa place. Chaque widget
# de rangée retient sa génération ; ceux d'une génération périmée
# sont ignorés.
self._gen = 0
# VM dont les ressources sont FIGÉES, par identité de catalogue.
# Distinct des surcharges : une VM peut être modifiée sans être
# verrouillée, et le verrou fige TOUT, pas seulement ce qu'on a
# touché.
self.locked = set()
# {clé de base: nombre d'exemplaires EN PLUS du premier}.
self.copies = {}
self.rows = []
self.vms = []
self.rows = []
# -- construction de l'écran ----------------------------------- #
def compose(self) -> ComposeResult:
yield Header()
with Horizontal(id="body"):
with VerticalScroll(id="fields"):
yield Static(t("Architecture"), classes="grouptitle")
with RadioSet(id="f_arch"):
for a in arches:
label = a if a != "all" else t("all archs")
yield RadioButton(label, value=a == self.arch)
yield Static(t("Catalog"), classes="grouptitle")
yield SelectionList(id="f_catalog")
yield Static(
t("Resources — applied to ALL VMs"),
classes="grouptitle",
)
with RadioSet(id="f_profile"):
for label in ("x1", "x2", "x3", "x4"):
yield RadioButton(label, value=label == "x1")
yield RadioButton(t("custom"))
# Chaque ressource offre ses suggestions plus « libre… »,
# qui révèle une saisie. C'est l'équivalent TUI de la règle
# de la CLI : une lettre choisit une suggestion, un chiffre
# vaut pour lui-même.
yield Select(
[(str(c), c) for c in ctx["cpu_presets"]]
+ [(t("free value…"), FREE)],
prompt=t("vCPU"),
id="f_vcpus",
disabled=True,
)
yield Input(
placeholder=t("vCPU"),
id="c_vcpus",
classes="freeval",
disabled=True,
)
yield Select(
[
(f"{m} ({m // 1024}G)", m)
for m in ctx["ram_presets"]
]
+ [(t("free value…"), FREE)],
prompt=t("RAM: 2048 or 8G"),
id="f_ram",
disabled=True,
)
yield Input(
placeholder=t("RAM: 2048 or 8G"),
id="c_ram",
classes="freeval",
disabled=True,
)
yield Select(
[(d, d) for d in ctx["disk_presets"]]
+ [(t("free value…"), FREE)],
prompt=t("Disk"),
id="f_disk",
disabled=True,
)
yield Input(
placeholder=t("Disk (e.g. 250G, 1.5T)"),
id="c_disk",
classes="freeval",
disabled=True,
)
yield Static(
f" {t('The profile and these fields change EVERY VM.')}"
f"\n {t('A VM edited on the right (marked) keeps its own.')}",
id="scopetarget",
)
# Serveur par défaut : c'est ce que sert une image cloud,
# et GNOME ajoute une à deux heures sur une architecture
# émulée. Le plan annonce le surcoût disque.
yield Static(t("VM type (default):"), classes="grouptitle")
with RadioSet(id="f_type"):
yield RadioButton(
t("Server (no graphical interface)"),
value=not defaults.get("desktop", ""),
)
for key, label in desktops:
yield RadioButton(
f"{t('Graphical (server + desktop):')} {label}",
value=defaults.get("desktop", "") == key,
)
if app_stores:
yield Static(
t("Application store:"), classes="grouptitle"
)
with RadioSet(id="f_store"):
for i, (_k, label) in enumerate(app_stores):
yield RadioButton(label, value=i == 0)
yield Static("", id="storewarn")
if vm_tools:
# Une case par outil, et non une liste déroulante : ils
# sont indépendants, et chacun se prend ou se laisse.
yield Static(
t("Development tools:"), classes="grouptitle"
)
for key, label, hint in vm_tools:
gb = tool_disk.get(key, 0)
yield Checkbox(
f"{label} +{gb} Go — {hint}",
value=key in (defaults.get("tools") or ()),
id=f"f_tool_{key}",
)
yield Static("", id="toolwarn")
yield Static("ERPLibre", classes="grouptitle")
yield Checkbox(
t("Install ERPLibre"),
value=defaults.get("install", True),
id="f_install",
)
yield Select(
[(b, b) for b in branches],
value=(
"develop" if "develop" in branches else branches[0]
),
allow_blank=False,
id="f_branch",
)
yield Select(
[(lbl, i) for i, (lbl, _c) in enumerate(profiles)],
value=0 if profiles else SELECT_NULL,
allow_blank=not profiles,
id="f_profile_install",
)
yield Checkbox(
t("Production (/opt, confined)"),
value=defaults.get("prod", False),
id="f_prod",
)
yield Checkbox(
t("Monitoring dashboard"),
value=defaults.get("monitor", True),
id="f_monitor",
)
yield Static(t("Timezone"), classes="grouptitle")
# Une liste plutôt qu'une saisie : un nom IANA mal
# orthographié n'est pas refusé par cloud-init, il est
# IGNORÉ — la VM reste en UTC et on ne s'en aperçoit
# qu'aux horodatages. « libre… » garde la porte ouverte
# aux six cents autres fuseaux de la base.
yield Select(
[(z, z) for z in timezones]
+ [(t("free value…"), FREE)],
value=(timezones[0] if timezones else SELECT_NULL),
allow_blank=False,
id="f_tz_sel",
)
yield Input(
value=ctx.get("timezone") or "",
placeholder=t("Timezone for the VMs"),
id="f_tz",
classes="freeval",
)
yield Static("SSH", classes="grouptitle")
yield Input(
value=ctx.get("ssh_key") or "",
placeholder=t("SSH public key path"),
id="f_key",
)
yield Checkbox(
t("Add each VM to ~/.ssh/config"),
value=defaults.get("add_ssh_config", True),
id="f_sshcfg",
)
# mise pose un CPython précompilé, pyenv le compile.
# Grisé quand AUCUNE des VM retenues n'est sur une
# architecture que mise sert.
yield Static(
t("Python interpreter:"), classes="grouptitle"
)
with RadioSet(id="f_python"):
yield RadioButton(
t("mise (precompiled, faster)"), value=True
)
yield RadioButton(t("pyenv (compiles from source)"))
yield Static("", id="miswarn")
yield Static(t("Parallelism"), classes="grouptitle")
# Cochée, la case donne une exécution PAR installation :
# le plafond du nombre de CPU ne s'applique plus. Décochée,
# le nombre reprend la main, et son défaut suit l'hôte —
# la CLI comptait déjà les CPU, la TUI restait figée à 4.
yield Checkbox(
t("One run per install"),
value=defaults.get("par_per_install", True),
id="f_par_all",
)
yield Select(
[(str(n), n) for n in range(1, host_cpu + 1)],
value=host_cpu,
allow_blank=False,
disabled=True,
id="f_par",
)
with Vertical(id="right"):
# Une liste de widgets, pas un tableau : chaque VM porte
# SES listes déroulantes, modifiables sur place. Un
# DataTable ne sait pas héberger de widget.
yield VerticalScroll(id="plan")
yield Static("", id="totals")
yield Footer()
def on_mount(self) -> None:
self.title = t("Deploy ERPLibre VM(s)!")
self._reload_catalog(first_load=True)
# -- catalogue et recalcul ------------------------------------- #
def _entries(self):
return catalog.get(self.arch, [])
def _reload_catalog(self, first_load=False):
"""(Re)charge la liste à cocher.
RIEN n'est coché d'avance : déployer coûte cher, et une case
pré-cochée ferait créer une VM que personne n'a demandée. Le « * »
marque toujours la version principale, et F7 les coche toutes.
Après un changement d'architecture, les cases déjà cochées sont
conservées quand l'entrée existe encore — l'identité est
(distro, version, archi), pas le rang dans la liste."""
widget = self.query_one("#f_catalog", SelectionList)
keep = (
set()
if first_load
else {
entry_key(self._entries_before[i])
for i in widget.selected
if i < len(self._entries_before)
}
)
widget.clear_options()
entries = self._entries()
for i, e in enumerate(entries):
widget.add_option((entry_label(e), i, entry_key(e) in keep))
self._entries_before = entries
self._recompute()
def _selected_entries(self):
widget = self.query_one("#f_catalog", SelectionList)
entries = self._entries()
return [entries[i] for i in sorted(widget.selected)]
# ------------------------------------------------------------ #
# Ce que le socle du plan attend de nous
# ------------------------------------------------------------ #
def _presets(self):
"""Choix offerts par ressource. Le socle s'en sert pour savoir
quand une valeur est « libre »."""
return {
"vcpus": ctx["cpu_presets"],
"ram": ctx["ram_presets"],
"disk": ctx["disk_presets"],
}
def _auto_name(self, index):
"""Le nom du catalogue, suffixé du bureau : ce que la VM
reprendrait si on effaçait son nom."""
return vm_name(
self._plan_entries()[index]["name"],
self.rows[index]["vm"].get("desktop"),
desktop_suffixes,
)
def _lock_fields(self, index):
"""TOUT ce que la VM tient d'un choix commun est recopié, pas
seulement les ressources : la branche et le profil Odoo en font
partie. Les oublier laissait une VM « figée » changer de version
d'ERPLibre dès qu'on touchait au choix générique, ce qui vide le
mot de son sens.
Les deux se résolvent AVANT d'être figés : « » y signifie « celle
du formulaire », et geler une chaîne vide ne gèlerait rien."""
vm = self.rows[index]["vm"]
return {
"vcpus": vm["vcpus"],
"ram": vm["ram"],
"disk": vm["disk"],
"desktop": vm.get("desktop") or "",
"branch": vm.get("branch") or self._branch(),
"install_cmd": vm.get("install_cmd") or self._profile_cmd(),
"install_label": (
vm.get("install_label")
or (
profiles[self._row_profile_index(index)][0]
if profiles
else ""
)
),
}
def _recompute(self):
entries = self._plan_entries()
self.vms = build_vms(
entries,
self.profile,
base_vcpus,
host_cpu,
self.custom,
self.overrides,
self._default_desktop(),
desktop_suffixes,
)
# ERPLibre et GNOME pèsent chacun sur le disque, et se cumulent.
grow = 0
if self.query_one("#f_install", Checkbox).value:
grow += extra_disk
self.rows = plan_rows(self.vms, domains, grow)
# Le bureau pèse sur le disque de la VM QUI LE PORTE, et d'elle
# seule : un supplément commun mentait dès que les types
# différaient d'une machine à l'autre.
tools = self._vm_tools()
for row in self.rows:
if row["vm"].get("desktop"):
row["disk_gb"] += desktop_disk
# Même règle pour les outils, et pour la même raison : ils ne
# pèsent que sur les VM qui les reçoivent réellement. Android
# Studio n'existe qu'en x86_64, les extensions GNOME n'ont de
# sens que sous GNOME — une VM qui ne les aura pas ne doit pas
# se voir gonfler son disque.
row["disk_gb"] += sum(
tool_disk.get(k, 0)
for k in self._tools_for_vm(row["vm"], tools)
)
# Le plan doit MONTRER qu'une VM a été personnalisée : sans marque,
# deux lignes aux ressources différentes n'ont aucune explication à
# l'écran, et la surcharge est oubliée à la relecture. Le drapeau
# vit sur la ligne d'affichage, jamais sur la VM : celle-ci part
# telle quelle dans la spec, que la CLI produit à l'identique.
for row, entry in zip(self.rows, entries):
key = entry_key(entry)
row["custom"] = bool(self.overrides.get(key))
row["locked"] = key in self.locked
self._render_plan()
self._render_mise()
self._render_store()
self._render_tools()
def _vm_tools(self):
"""Clés des outils cochés, dans l'ordre de la liste."""
picked = []
for key, _label, _hint in vm_tools:
try:
if self.query_one(f"#f_tool_{key}", Checkbox).value:
picked.append(key)
except Exception:
continue
return tuple(picked)
def _tools_for_vm(self, vm, tools):
"""Outils qu'une VM donnée recevra vraiment.
Même filtre que todo.py côté déploiement : une VM ARM ne verra
jamais Android Studio, une VM Cinnamon jamais les extensions GNOME,
un serveur aucun des IDE — mais un serveur reçoit bien la
compilation mobile, qui n'a rien à afficher, et une distribution
sans apt ne la reçoit pas, son installateur n'existant que là."""
out = []
for key in tools:
arches = tool_arches.get(key) or ()
desks = tool_desktops.get(key) or ()
fams = tool_families.get(key) or ()
if tool_needs_desktop.get(key) and not vm.get("desktop"):
continue
if arches and vm["arch"] not in arches:
continue
if desks and vm.get("desktop") not in desks:
continue
if fams and distro_family.get(vm["distro"], "") not in fams:
continue
out.append(key)
return out
def _render_tools(self):
"""Grise chaque case qu'AUCUNE VM retenue ne peut recevoir, et
NOMME ce qui sera écarté.
Une case par outil, et non un blocage en bloc : sur un parc de
serveurs les IDE se grisent, la compilation mobile reste offerte.
Cocher Android Studio sur un parc ARM ne produit rien — le dire ici
évite de le découvrir dans le journal d'installation."""
if not vm_tools:
return
for key, _label, _hint in vm_tools:
usable = any(self._tools_for_vm(vm, (key,)) for vm in self.vms)
self.query_one(f"#f_tool_{key}", Checkbox).disabled = (
not usable
)
picked = self._vm_tools()
skipped = sorted(
{
vm["name"]
for vm in self.vms
for k in picked
if k not in self._tools_for_vm(vm, picked)
}
)
self.query_one("#toolwarn", Static).update(
f" ⚠ {t('Partly skipped (arch or desktop):')} "
f"{', '.join(skipped)}"
if skipped
else ""
)
def _render_mise(self):
"""Grise le choix quand aucune VM retenue n'est servie par mise,
et nomme les architectures qui retomberont sur pyenv."""
usable = self._mise_usable()
self.query_one("#f_python", RadioSet).disabled = not usable
skipped = sorted(
{
vm["arch"]
for vm in self.vms
if vm["arch"] not in mise_arches
}
)
msg = ""
if skipped:
msg = (
f" ⚠ {t('mise has no binary for:')} "
f"{', '.join(skipped)} — {t('those VMs use pyenv')}"
)
self.query_one("#miswarn", Static).update(msg)
def _python_provider(self):
"""« mise », « pyenv », ou rien — c'est-à-dire « automatique ».
Rien, et surtout pas « pyenv », quand mise n'est servi par aucune
architecture retenue. « mise est indisponible » ne veut pas dire
« l'utilisateur exige pyenv » : la nuance décide de tout, puisqu'un
choix EXPLICITE écarte le Python de la distribution. Sur s390x,
renvoyer « pyenv » forçait la compilation de CPython — celle dont
gcc 15.2 ne revient pas."""
if not self._mise_usable():
return ""
index = self.query_one("#f_python", RadioSet).pressed_index
return "pyenv" if index == 1 else "mise"
def _app_store(self):
"""Magasin retenu. Sans VM concernée, la réponse est « deb » :
elle ne change rien, et laisser passer « snap » réactiverait snapd
pour rien."""
if not app_stores or not self._app_store_needed():
return "deb"
index = self.query_one("#f_store", RadioSet).pressed_index
if index is None or not (0 <= index < len(app_stores)):
return app_stores[0][0]
return app_stores[index][0]
def _app_store_needed(self):
"""Au moins une VM graphique sur une distribution qui livre snapd."""
return any(
vm.get("desktop") and vm["distro"] in snap_distros
for vm in self.vms
)
def _render_store(self):
"""Grise le choix quand aucune VM ne le concerne, et dit pourquoi."""
if not app_stores:
return
needed = self._app_store_needed()
self.query_one("#f_store", RadioSet).disabled = not needed
self.query_one("#storewarn", Static).update(
""
if needed
else f" {t('No graphical VM on a snap-based distro.')}"
)
def _mise_usable(self):
return any(vm["arch"] in mise_arches for vm in self.vms)
def _profile_cmd(self):
"""Commande du profil choisi en haut : le défaut de chaque VM."""
if not profiles:
return ""
index = self.query_one("#f_profile_install", Select).value
return profiles[index if isinstance(index, int) else 0][1]
def _row_profile_index(self, i):
"""Rang du profil que la rangée doit AFFICHER."""
cmd = ""
if i < len(self.rows):
cmd = self.rows[i]["vm"].get("install_cmd") or ""
cmd = cmd or self._profile_cmd()
for k, (_lbl, c) in enumerate(profiles):
if c == cmd:
return k
return 0
def _branch(self):
"""Branche du formulaire : le défaut de chaque VM."""
value = self.query_one("#f_branch", Select).value
return value if isinstance(value, str) else branches[0]
def _default_desktop(self):
"""« » pour un serveur, sinon la clé de la saveur choisie."""
"""Type de VM par défaut. Chaque rangée peut s'en écarter."""
index = self.query_one("#f_type", RadioSet).pressed_index
if index is None or index < 1 or index > len(desktops):
return ""
return desktops[index - 1][0]
# -- panneau droit : une rangée de widgets par VM ---------------- #
def _type_options(self):
return [(t("Server"), SERVER)] + [
(label, key) for key, label in desktops
]
def _mount_rows(self) -> None:
"""(Re)construit le panneau droit.
Le verrou couvre TOUT le montage : poser « value= » sur un Select
fait émettre un Changed à Textual, que on_select_changed prenait
pour une saisie. Résultat mesuré — les trois champs de CHAQUE VM
recevaient une surcharge dès l'affichage, le profil x1..x4 ne
pouvait plus rien changer, et toutes les lignes portaient la
marque ✎. Il est relâché après le rafraîchissement, une fois ces
messages consommés."""
self._syncing = True
self._gen += 1
plan = self.query_one("#plan", VerticalScroll)
plan.remove_children()
widgets = []
for i, r in enumerate(self.rows):
vm = r["vm"]
item = self._plan_entries()[i]
key = entry_key(item)
row = Horizontal(
# « + » ajoute un exemplaire de CETTE entrée ; « - » ne
# s'affiche que sur une copie, pour qu'on ne puisse pas
# retirer l'original par mégarde.
Button("+", id=f"p{i}", classes="vmcopy"),
Button("✎", id=f"r{i}", classes="vmcopy"),
Button(
"🔒" if key in self.locked else "🔓",
id=f"l{i}",
variant="success" if key in self.locked else "default",
classes="vmlock",
),
# Le triplet vCPU / RAM / disque vient du socle
# commun : c'est la partie que le formulaire Proxmox pose
# à l'identique, et la seule que les deux dupliquaient.
*res_row_widgets(
i,
vm,
{
"vcpus": ctx["cpu_presets"],
"ram": ctx["ram_presets"],
"disk": ctx["disk_presets"],
},
labels={"vcpus": "vCPU"},
null=SELECT_NULL,
),
(
Button("−", id=f"m{i}", classes="vmcopy")
if item.get("instance")
else Static("", classes="vmcopy")
),
Select(
[(b, b) for b in branches],
classes="vmbranch",
# Repli sur la branche du FORMULAIRE, jamais sur
# branches[0] : les rangées sont remontées dès que le
# jeu de VM change (une entrée cochée, une copie
# ajoutée, un renommage), et elles retombaient alors
# toutes sur « develop » quel que soit le choix commun.
value=(
self.rows[i]["vm"].get("branch")
if i < len(self.rows)
else ""
)
or self._branch(),
allow_blank=False,
id=f"v{i}_branch",
),
(
Select(
[(lbl, i) for i, (lbl, _c) in enumerate(profiles)],
value=self._row_profile_index(i),
allow_blank=False,
classes="vmprof",
id=f"v{i}_prof",
)
if profiles
else Static("", classes="vmprof")
),
Select(
self._type_options(),
value=vm.get("desktop") or SERVER,
allow_blank=False,
id=f"v{i}_type",
),
classes="vmrow",
)
widgets.append(
Vertical(
Static(self._row_head(i, r), id=f"h{i}"),
row,
# Pas d'id sur la carte : « remove_children() » est
# ASYNCHRONE, les anciennes sont encore là au montage
# et Textual refuse deux frères de même id. Les ids
# des champs vivent un niveau plus bas, dans un parent
# neuf — la collision ne les touche pas. On atteint
# donc la carte par son RANG.
classes=(
"vmcard locked" if key in self.locked else "vmcard"
),
)
)
# Marque de génération, posée sur CHAQUE widget de rangée.
# « walk_children() » ne voit RIEN avant le montage : les enfants
# passés au constructeur attendent dans « _pending_children ».
def mark(node):
node._el_gen = self._gen
for child in getattr(node, "_pending_children", None) or []:
mark(child)
for card in widgets:
mark(card)
# Le montage vient APRÈS le marquage, jamais avant : « mount_all »
# consomme « _pending_children » et le vide. Marquer ensuite était
# une COURSE — gagnée sur une machine, perdue sur une autre. Perdue,
# les listes des rangées n'avaient plus de génération, TOUS les
# changements par VM étaient rejetés en silence, et seuls les
# réglages globaux semblaient agir.
if widgets:
plan.mount_all(widgets)
self._shown_ids = self._row_ids()
# Les saisies libres ne se révèlent qu'après le montage : leur
# style ne peut pas être touché avant qu'elles existent.
self.call_after_refresh(self._after_mount_rows)
def _after_mount_rows(self) -> None:
self._sync_free_inputs()
self._syncing = False
def _refresh_row_widgets(self) -> None:
"""Remet les listes de chaque rangée sur ce que la VM vaut MAINTENANT.
Sans cela, changer le profil x1..x4 mettait les totaux à jour mais
laissait les listes sur leurs anciennes valeurs : l'écran affichait
8192 pendant que la VM valait 4096. Les rangées ne sont remontées
que si le JEU de VM change — pour ne pas voler le focus — donc ce
rafraîchissement doit se faire à la main.
Aucun risque de boucle : on_select_changed ignore une valeur déjà
égale à celle du modèle, et le modèle vient précisément d'être
recalculé."""
for i, r in enumerate(self.rows):
vm = r["vm"]
for field, presets in (
("vcpus", ctx["cpu_presets"]),
("ram", ctx["ram_presets"]),
("disk", ctx["disk_presets"]),
):
try:
sel = self.query_one(f"#v{i}_{field}", Select)
except Exception:
continue
# Une liste posée sur « libre… » ne doit PAS être remise
# sur une valeur : l'utilisateur vient de la choisir, et
# tant qu'il n'a rien tapé la VM vaut encore celle du
# profil — on la lui reprendrait sous les doigts.
if sel.value is FREE:
continue
# Une valeur libre déjà saisie n'est dans aucune liste :
# liste vide, la saisie à côté porte le nombre.
sel.value = (
vm[field] if vm[field] in presets else SELECT_NULL
)
for wid, value in (
(f"#v{i}_type", vm.get("desktop") or SERVER),
(f"#v{i}_branch", vm.get("branch") or self._branch()),
(f"#v{i}_prof", self._row_profile_index(i)),
):
try:
self.query_one(wid, Select).value = value
except Exception:
pass
self._sync_free_inputs()
def _render_plan(self):
# Le JEU de VM a-t-il changé ? Si oui on remonte les widgets, sinon
# on se contente des titres : remonter à chaque frappe volerait le
# focus au champ en cours de saisie.
if self._row_ids() != self._shown_ids:
self._mount_rows()
else:
for i, r in enumerate(self.rows):
try:
self.query_one(f"#h{i}", Static).update(
self._row_head(i, r)
)
except Exception:
pass
self._refresh_row_widgets()
if not self.rows:
# Rien de coché : un total à zéro n'apprend rien, on dit
# plutôt comment remplir la liste.
self.query_one("#totals", Static).update(
f" {t('Tick what to deploy')} — "
f"{t('F7 main versions · F6 all')}"
)
return
n, cpus, ram, disk = plan_totals(self.rows)
warn = ""
if free_ram and ram > free_ram:
warn = f" ⚠ {t('> host free RAM')}"
elif cpus > host_cpu:
warn = f" ⚠ {t('> host cores')} ({host_cpu})"
dupes = len({vm["name"] for vm in self.vms}) != len(self.vms)
dup_txt = (
f"\n ⚠ {t('Duplicate names detected; keeping as entered.')}"
if dupes
else ""
)
# Une VM DÉJÀ DÉFINIE n'est pas recréée : elle ne consomme rien
# de neuf, donc plan_totals l'écarte. Mais un total à zéro sans
# explication se lit comme un bogue — on a cru que les réglages
# par VM n'avaient aucun effet, alors qu'ils portaient sur une
# machine qui ne sera pas créée.
skipped = sum(1 for r in self.rows if r["state"] == "exists")
skip_txt = (
f" ({skipped} {t('already defined, not counted')})"
if skipped
else ""
)
self.query_one("#totals", Static).update(
f" {n} {t('VMs')} · {cpus} vCPU · {ram} Mo · ~{disk} G"
f"{skip_txt}{warn}{dup_txt}"
)
# -- réactions aux champs -------------------------------------- #
def on_radio_set_changed(self, event) -> None:
if event.radio_set.id == "f_arch":
self.arch = arches[event.radio_set.pressed_index]
self._reload_catalog()
elif event.radio_set.id == "f_type":
self._clear_overrides(("desktop",))
# Recalcul : le disque annonce inclut le bureau, et la
# colonne Statut affiche le type de VM.
self._recompute()
elif event.radio_set.id == "f_profile":
index = event.radio_set.pressed_index
self.profile = "custom" if index == 4 else str(index + 1)
# Un multiplicateur x1..x4 ne touche QUE les vCPU et la RAM —
# apply_profile y laisse le disque du catalogue. Y effacer une
# taille de disque réglée à la main la faisait disparaître sans
# rien mettre à la place : on revenait à 20G sans l'avoir
# demandé. Le disque n'est rendu au commun que par le profil
# « personnalisé », qui en porte un.
fields = ("vcpus", "ram")
if self.profile == "custom":
fields += ("disk",)
self._clear_overrides(fields)
custom = self.profile == "custom"
for field, (sel, _inp) in RES_FIELDS.items():
self.query_one(sel, Select).disabled = not custom
self._show_free(field, custom and self._free.get(field))
self._recompute()
# -- rangées du panneau droit ------------------------------- #
def on_selection_list_selected_changed(self, event) -> None:
self._recompute()
def on_select_changed(self, event) -> None:
if self._syncing:
return
wid = event.select.id or ""
row = re.match(r"v(\d+)_(vcpus|ram|disk|type|branch|prof)$", wid)
if row and not self._is_current(event.select):
# Widget d'une génération périmée : son rang ne désigne plus
# la même VM. L'appliquer écraserait le réglage d'une voisine.
return
if row:
index, field = int(row.group(1)), row.group(2)
if index >= len(self.rows):
return
# Poser « value= » au montage fait émettre un Changed que
# Textual délivre APRÈS coup : un verrou temporel ne l'attrape
# pas — mesuré, les trois champs de chaque VM se retrouvaient
# surchargés dès l'affichage et le profil x1..x4 devenait
# inopérant. On compare donc à ce que le modèle dit déjà : une
# valeur identique n'est pas une saisie, c'est l'écho.
#
# Cas limite assumé : choisir explicitement la valeur que le
# profil donne déjà n'enregistre pas de surcharge. La VM
# suivra donc le profil s'il change — ce qui est aussi le plus
# attendu quand on n'a rien changé de visible.
vm_now = self.rows[index]["vm"]
if field == "prof":
label, cmd = profiles[event.value]
if cmd == (
vm_now.get("install_cmd") or self._profile_cmd()
):
return
same = cmd == self._profile_cmd()
self._set_override(
index, "install_cmd", "" if same else cmd
)
self._set_override(
index, "install_label", "" if same else label
)
self._recompute()
return
if field == "branch":
# « la branche du formulaire » n'est pas une surcharge :
# la VM doit suivre si on la change en haut.
current = vm_now.get("branch") or self._branch()
if event.value == current:
return
self._set_override(
index,
"branch",
"" if event.value == self._branch() else event.value,
)
self._recompute()
return
if field == "type":
new_desk = "" if event.value == SERVER else event.value
if new_desk == (vm_now.get("desktop") or ""):
return
elif (
event.value is not FREE and event.value is not SELECT_NULL
):
if self._row_echo(index, field, event.value):
return
if field == "type":
self._set_override(
index,
"desktop",
"" if event.value == SERVER else event.value,
)
# « Serveur » est un choix légitime, pas un retrait : on le
# note explicitement pour qu'il tienne face au défaut.
if event.value == SERVER:
key = self._row_key(index)
if key is not None:
self.overrides.setdefault(key, {})["desktop"] = ""
elif event.value is FREE:
self._row_free(index, field, True)
self._set_override(
index, field, self._read_row_free(index, field)
)
elif event.value is not SELECT_NULL:
self._row_free(index, field, False)
self._set_override(index, field, event.value)
self._recompute()
return
# Les choix GLOBAUX de branche et de profil ne portent aucune
# valeur de ressource : ils tombaient donc dans le « return »
# ci-dessous sans rien recalculer, et les rangées restaient sur
# l'ancienne version. Elles n'en gardent pas de copie — « » y
# veut dire « celle du formulaire » — il suffit de redessiner.
if event.select.id == "f_tz_sel":
# « libre… » révèle la saisie ; un fuseau choisi la referme et
# y recopie le nom, seule valeur que lisent _form_values et la
# spec — un seul endroit porte la réponse.
free = event.value is FREE
field = self.query_one("#f_tz", Input)
field.display = free
field.disabled = not free
if free:
field.focus()
elif isinstance(event.value, str):
field.value = event.value
return
if event.select.id in ("f_branch", "f_profile_install"):
self._clear_overrides(
("branch",)
if event.select.id == "f_branch"
else ("install_cmd",)
)
self._recompute()
return
field = SELECT_TO_FIELD.get(event.select.id)
if not field:
return
if event.value is FREE:
# La valeur retenue est celle de la saisie, pas ce choix-ci.
self._free[field] = True
self._show_free(field, True)
self.query_one(RES_FIELDS[field][1], Input).focus()
self._apply_free(field)
elif event.value is not SELECT_NULL:
self._free[field] = False
self._show_free(field, False)
self.custom[field] = event.value
self._clear_overrides((field,))
self._recompute()
def on_input_changed(self, event) -> None:
if self._syncing:
return
wid = event.input.id or ""
row = re.match(r"c(\d+)_(vcpus|ram|disk)$", wid)
if row and not self._is_current(event.input):
return
if row:
index, field = int(row.group(1)), row.group(2)
self._set_override(
index, field, self._read_row_free(index, field)
)
self._recompute()
return
field = INPUT_TO_FIELD.get(event.input.id)
if field:
self._apply_free(field)
self._recompute()
def on_button_pressed(self, event) -> None:
match = re.match(r"([pm])(\d+)$", event.button.id or "")
if match:
self._add_copy(
int(match.group(2)), 1 if match.group(1) == "p" else -1
)
return
match = re.match(r"r(\d+)$", event.button.id or "")
if match:
self._rename(int(match.group(1)))
return
match = re.match(r"l(\d+)$", event.button.id or "")
if match:
index = int(match.group(1))
key = self._row_key(index)
if key is not None:
self._set_lock(index, key not in self.locked)
def on_checkbox_changed(self, event) -> None:
if event.checkbox.id == "f_install":
self._recompute() # le disque annoncé inclut le +5 G ERPLibre
elif event.checkbox.id == "f_par_all":
self.query_one("#f_par", Select).disabled = event.value
elif str(event.checkbox.id or "").startswith("f_tool_"):
# Un IDE de plus, c'est un disque plus grand : le plan doit le
# montrer AVANT de déployer, pas après une heure d'installation.
self._recompute()
# -- actions ---------------------------------------------------- #
def action_select_all(self) -> None:
self.query_one("#f_catalog", SelectionList).select_all()
def action_select_none(self) -> None:
self.query_one("#f_catalog", SelectionList).deselect_all()
def action_select_main(self) -> None:
"""Une VM par distro : la version marquée par défaut."""
widget = self.query_one("#f_catalog", SelectionList)
widget.deselect_all()
for i, e in enumerate(self._entries()):
if e.get("default"):
widget.select(i)
def action_clear_vm(self) -> None:
"""Rend au profil commun la VM dont un widget a le focus. Sans
cette sortie, un réglage posé par erreur ne se défaisait qu'en
rouvrant le formulaire."""
index = self._focused_row()
if index is None:
return
key = self._row_key(index)
if key is None or key not in self.overrides:
return
self.overrides.pop(key)
# Les widgets de la rangée portent encore l'ancienne valeur : on
# les remonte pour qu'ils disent la vérité.
self._recompute()
self._mount_rows()
def _form_values(self):
install = None
if self.query_one("#f_install", Checkbox).value and profiles:
index = self.query_one("#f_profile_install", Select).value
label, cmd = profiles[index if isinstance(index, int) else 0]
install = {
"branch": self.query_one("#f_branch", Select).value,
"prod": self.query_one("#f_prod", Checkbox).value,
"label": label,
"cmd": cmd,
"monitor": self.query_one("#f_monitor", Checkbox).value,
}
key = self.query_one("#f_key", Input).value.strip()
return {
# Le suivi est demandé au NIVEAU DU DÉPLOIEMENT, pas de
# l'installation : décocher ERPLibre emportait la case avec
# elle, et le tableau de bord ne s'ouvrait plus du tout.
"monitor": self.query_one("#f_monitor", Checkbox).value,
"res_label": (
t("custom")
if self.profile == "custom"
else f"x{self.profile}"
),
"ssh_key": os.path.expanduser(key) if key else "",
# Un champ vidé retombe sur le fuseau de l'hôte plutôt que sur
# rien : sans valeur, la VM démarrerait en UTC.
"timezone": self.query_one("#f_tz", Input).value.strip()
or ctx.get("timezone")
or "",
"desktop": self._default_desktop(),
"vm_tools": self._vm_tools(),
"python_provider": self._python_provider(),
"app_store": self._app_store(),
"install": install,
"add_ssh_config": self.query_one("#f_sshcfg", Checkbox).value,
# Une exécution par installation : le nombre de VM retenues
# fait foi. Le déploiement le borne ensuite à ce même nombre,
# donc une valeur haute ne crée jamais de travailleur inutile.
"parallelism": (
max(1, len(self.vms))
if self.query_one("#f_par_all", Checkbox).value
else self.query_one("#f_par", Select).value
),
}
def action_preview(self) -> None:
spec = build_spec(self.vms, domains, self._form_values())
build = ctx.get("build_command")
if not build:
return
lines = [build(vm, spec, True) for vm in spec["vms"]]
self.push_screen(
preview_screen()(lines or [t("Nothing selected.")])
)
def action_dump_state(self) -> None:
"""Écrit l'état COMPLET dans un fichier, widgets ET modèle.
Une capture d'écran ne dit pas si l'écart vient de ce qu'on voit
ou de ce qui sera déployé. Ce vidage met les deux côte à côte, VM
par VM : si la liste affiche 16384 et que le modèle dit 1024, le
défaut est dans la prise en compte ; s'ils s'accordent et que la
VM déployée diffère, il est en aval."""
path = os.path.expanduser("~/.erplibre/deploy-form-dump.txt")
os.makedirs(os.path.dirname(path), exist_ok=True)
out = [
"=== formulaire de deploiement ===",
f"profil={self.profile} custom={self.custom}",
f"verrous={sorted(self.locked)}",
f"surcharges={self.overrides}",
f"generation={self._gen} jeu_monte={self._shown_ids}",
f"branche_globale={self._branch()}",
f"profil_odoo_global={self._profile_cmd()}",
"",
" # widget -> modele, VM par VM",
]
for i, r in enumerate(self.rows):
vm = r["vm"]
shown = {}
for f in ("vcpus", "ram", "disk", "type", "branch", "prof"):
try:
shown[f] = self.query_one(f"#v{i}_{f}", Select).value
except Exception:
shown[f] = "-"
try:
free = self.query_one(f"#c{i}_{f}", Input)
if free.display:
shown[f] = f"libre:{free.value!r}"
except Exception:
pass
out.append(f" [{i}] {vm['name']} etat={r['state']}")
out.append(f" widgets = {shown}")
out.append(
f" modele = vcpus={vm['vcpus']} ram={vm['ram']} "
f"disk={vm['disk']} desktop={vm.get('desktop')!r} "
f"branch={vm.get('branch')!r} cmd={vm.get('install_cmd')!r}"
)
spec = build_spec(self.vms, domains, self._form_values())
out.append("")
out.append(" # spec qui partirait au deploiement")
for vm in spec["vms"]:
out.append(
f" {vm['name']}: ram={vm['ram']} vcpus={vm['vcpus']} "
f"disk={vm['disk']}"
)
out.append(f" ignorees (existent deja) = {spec['existing']}")
with open(path, "w", encoding="utf-8") as fh:
fh.write("\n".join(out) + "\n")
self.notify(f"{t('State written to')} {path}")
def action_deploy(self) -> None:
if not self.vms:
self.notify(t("Nothing selected."), severity="warning")
return
spec = build_spec(self.vms, domains, self._form_values())
if not spec["vms"]:
self.notify(
t("Nothing to create - every VM already exists."),
severity="warning",
)
return
orphans = [r for r in self.rows if r["state"] == "orphan"]
if orphans and not getattr(self, "_orphan_ack", False):
# Un qcow2 orphelin fait échouer deploy_qemu : on prévient une
# première fois, F5 à nouveau vaut confirmation.
self._orphan_ack = True
self.notify(
t("orphan disk - will FAIL")
+ f" ({len(orphans)}) — "
+ t("press F5 again to confirm"),
severity="error",
timeout=10,
)
return
result["spec"] = spec
self.exit()
def action_cancel(self) -> None:
self.exit()
app = DeployForm()
# Exposé pour les tests headless (run_app=False), qui pilotent l'app
# eux-mêmes et ont besoin de lire la spec produite.
app._result = result
if not run_app:
return app
app.run()
return result["spec"]
# --------------------------------------------------------------------------- #
# Vue de progression : un bloc repliable par VM
# --------------------------------------------------------------------------- #