erplibre/test/test_todo_deploy_form_lib.py
Mathieu Benoit 9767ad540f [ADD] proxmox : un écran pour déployer sur un hôte distant
Le déploiement Proxmox se faisait par vingt questions, l'une après
l'autre, sans jamais voir le plan entier. Il a maintenant le même écran
que QEMU/KVM — catalogue à gauche, plan à droite, totaux dessous — et une
touche pour revenir aux questions. Il n'en redit rien : 690 lignes contre
1 340, tout le reste vient du socle commun.

Ce que Proxmox a en propre est montré AVANT de lancer : le VMID, parce
que l'hôte ne dit « déjà pris » qu'après avoir téléchargé l'image, et
l'adresse qui s'en déduit sur un pont interne. Le stockage et le pont sont
lus sur l'hôte, jamais devinés. L'icône 🗄 distingue l'entrée du menu de
celle qui déploie ici même.

--- EN ---

Deploying on Proxmox meant twenty questions, one after another, never
seeing the whole plan. It now has the same screen as QEMU/KVM — catalogue
left, plan right, totals below — and a key to fall back to the questions.
It repeats none of it: 690 lines against 1,340, everything else comes
from the shared foundation.

What belongs to Proxmox is shown BEFORE launching: the VMID, because the
host only says "already taken" after downloading the image, and the
address derived from it on an internal bridge. Storage and bridge are read
from the host, never guessed. The 🗄 icon tells the menu entry apart from
the one that deploys right here.

Assisted-by: Claude Opus 5
2026-08-25 03:17:13 -04:00

288 lines
10 KiB
Python

#!/usr/bin/env python3
# © 2026 TechnoLibre (http://www.technolibre.ca)
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
"""Le socle commun aux deux formulaires de déploiement.
Le formulaire QEMU/KVM et le formulaire Proxmox posent le même travail :
choisir des systèmes, régler des ressources, vérifier le plan, lancer. Ce qui
est commun vit dans `deploy_form_lib` (logique pure, socle CSS, fabrique des
ressources) et `deploy_form_plan` (surcharges, verrous, exemplaires,
renommage). Ces tests gardent DEUX propriétés :
* le socle fait ce qu'il dit — une ressource libre, un verrou, un écho de
montage pris pour une saisie ;
* les deux formulaires s'en servent VRAIMENT, au lieu de le redire chacun de
son côté. C'est la seule chose qui empêche l'architecture de retomber en
deux copies qui divergent.
"""
import ast
import pathlib
import sys
import unittest
sys.argv = ["todo.py"]
from script.todo import deploy_form_lib as lib # noqa: E402
from script.todo import deploy_form_plan as plan # noqa: E402
RACINE = pathlib.Path(__file__).resolve().parent.parent
TODO_DIR = RACINE / "script" / "todo"
class TestRessourcesLibres(unittest.TestCase):
"""« autre… » ne vaut pas zéro : il révèle une saisie."""
def test_the_free_sentinel_closes_the_list(self):
choix = lib.res_choices([2, 4, 8])
self.assertEqual(choix[-1][1], lib.FREE)
self.assertEqual([v for _l, v in choix[:-1]], ["2", "4", "8"])
def test_a_formatter_shapes_the_labels(self):
choix = lib.res_choices([2048, 4096], fmt=lambda v: f"{v // 1024}G")
self.assertEqual([lbl for lbl, _v in choix[:-1]], ["2G", "4G"])
def test_free_without_typing_keeps_the_default(self):
# Le piège payé : valider un formulaire à peine ouvert rétrécissait
# les machines à zéro.
self.assertEqual(lib.res_value(lib.FREE, "", 4096), 4096)
self.assertEqual(lib.res_value(None, " ", 2), 2)
def test_a_typed_value_wins(self):
self.assertEqual(lib.res_value(lib.FREE, "12", 2), 12)
self.assertEqual(lib.res_value("8", "", 2), 8)
class TestEtatDuNom(unittest.TestCase):
"""Un nom déjà pris, un disque resté seul : deux gravités différentes."""
def test_a_defined_vm_is_skipped(self):
etat, note = lib.vm_status("erplibre-debian-13", ["erplibre-debian-13"])
self.assertEqual(etat, "exists")
self.assertTrue(note)
def test_the_orphan_probe_is_replaceable(self):
# Proxmox distant : ses disques vivent dans un stockage que seul
# l'hôte connaît, jamais dans /var/lib/libvirt.
etat, _n = lib.vm_status("x", [], orphelin=lambda _n: False)
self.assertEqual(etat, "new")
etat, _n = lib.vm_status("x", [], orphelin=lambda _n: True)
self.assertEqual(etat, "orphan")
def test_plan_rows_carries_the_probe(self):
vms = [{"name": "x", "vcpus": 2, "ram": 2048, "disk": "32G"}]
rows = lib.plan_rows(vms, [], 0, orphelin=lambda _n: True)
self.assertEqual(rows[0]["state"], "orphan")
class FauxPlan(plan.PlanMixin):
"""Le strict contrat du mixin, sans Textual : de quoi éprouver ce qui ne
touche pas à l'écran."""
def __init__(self, entrees):
self.entrees = entrees
self.copies = {}
self.overrides = {}
self.locked = set()
self.custom = {}
self.rows = []
self._gen = 0
self._shown_ids = ()
def _selected_entries(self):
return self.entrees
def entree(distro, version, arch="amd64"):
return {
"name": f"erplibre-{distro}-{version}",
"distro": distro,
"version": version,
"arch": arch,
"ram": 2048,
"disk": "32G",
}
class TestSocleDuPlan(unittest.TestCase):
def setUp(self):
self.app = FauxPlan([entree("debian", "13"), entree("ubuntu", "26.04")])
self.app.rows = [
{
"vm": {
"name": e["name"],
"distro": e["distro"],
"version": e["version"],
"arch": e["arch"],
"vcpus": 2,
"ram": 2048,
"disk": "32G",
},
"state": "new",
"note": "",
"disk_gb": 32,
}
for e in self.app.entrees
]
def test_an_override_is_written_then_dropped(self):
self.app._set_override(0, "ram", 8192)
cle = self.app._row_key(0)
self.assertEqual(self.app.overrides[cle]["ram"], 8192)
# Une saisie vidée RETIRE la surcharge : écrire zéro donnerait une VM
# à 0 vCPU.
self.app._set_override(0, "ram", 0)
self.assertNotIn(cle, self.app.overrides)
def test_a_common_setting_reclaims_the_unlocked_rows(self):
self.app._set_override(0, "ram", 8192)
self.app._set_override(1, "ram", 8192)
self.app.locked.add(self.app._row_key(1))
self.app._clear_overrides(("ram",))
self.assertNotIn(self.app._row_key(0), self.app.overrides)
self.assertIn(self.app._row_key(1), self.app.overrides)
def test_clearing_is_per_field(self):
self.app._set_override(0, "ram", 8192)
self.app._set_override(0, "disk", "64G")
self.app._clear_overrides(("ram",))
self.assertEqual(
self.app.overrides[self.app._row_key(0)], {"disk": "64G"}
)
def test_a_command_drags_its_label_along(self):
cle = self.app._row_key(0)
self.app.overrides[cle] = {
"install_cmd": "make install_odoo_18",
"install_label": "Odoo 18",
}
self.app._clear_overrides(("install_cmd",))
self.assertNotIn(cle, self.app.overrides)
def test_the_mount_echo_is_not_input(self):
# La valeur que le modèle porte déjà : c'est l'écho du montage.
self.assertTrue(self.app._row_echo(0, "ram", 2048))
self.assertFalse(self.app._row_echo(0, "ram", 4096))
# Rang hors plan : rien à appliquer.
self.assertTrue(self.app._row_echo(99, "ram", 1))
def test_copies_expand_the_selection(self):
self.app.copies[("debian", "13", "amd64")] = 1
entrees = self.app._plan_entries()
self.assertEqual(len(entrees), 3)
self.assertEqual(len(set(lib.entry_key(e) for e in entrees)), 3)
def test_the_head_line_names_what_is_special(self):
self.app.rows[0]["locked"] = True
self.assertIn("🔒", self.app._row_head(0, self.app.rows[0]))
self.app.rows[1]["custom"] = True
self.assertIn("✎", self.app._row_head(1, self.app.rows[1]))
self.assertIn("debian", self.app._row_head(0, self.app.rows[0]))
def test_locking_copies_the_resources(self):
gele = self.app._lock_fields(0)
self.assertEqual(gele["ram"], 2048)
self.assertEqual(gele["disk"], "32G")
self.assertEqual(gele["vcpus"], 2)
def membres(chemin, classe=None):
"""Noms des fonctions/méthodes définies dans un fichier (ou une classe)."""
arbre = ast.parse(pathlib.Path(chemin).read_text(encoding="utf-8"))
trouves = set()
for n in ast.walk(arbre):
if isinstance(n, ast.ClassDef) and (classe is None or n.name == classe):
trouves |= {
m.name for m in n.body if isinstance(m, ast.FunctionDef)
}
if classe is None and isinstance(n, ast.FunctionDef):
trouves.add(n.name)
return trouves
class TestPasDeDoublon(unittest.TestCase):
"""L'architecture demandée : un seul endroit par idée.
Ces tests échouent le jour où quelqu'un recopie un geste du plan dans un
formulaire plutôt que de l'appeler. C'est exactement ce qu'ils gardent.
"""
PARTAGES = {
"_plan_entries",
"_row_ids",
"_row_key",
"_is_current",
"_focused_row",
"_set_override",
"_clear_overrides",
"_set_lock",
"_add_copy",
"_rename",
"_row_free",
"_read_row_free",
"_show_free",
"_apply_free",
"_sync_free_inputs",
"_row_echo",
}
def test_the_mixin_owns_the_plan_gestures(self):
self.assertTrue(
self.PARTAGES <= membres(TODO_DIR / "deploy_form_plan.py")
)
def test_neither_form_redefines_them(self):
for fichier in ("qemu_deploy_form.py", "proxmox_deploy_form.py"):
redits = self.PARTAGES & membres(TODO_DIR / fichier)
self.assertEqual(
redits,
set(),
f"{fichier} redit ce que le socle porte déjà : {redits}",
)
def test_both_forms_inherit_the_mixin(self):
for fichier in ("qemu_deploy_form.py", "proxmox_deploy_form.py"):
src = pathlib.Path(TODO_DIR / fichier).read_text(encoding="utf-8")
self.assertIn("PlanMixin, App", src, fichier)
def test_the_pure_logic_lives_in_one_place(self):
pures = {
"parse_ram",
"parse_disk",
"positive_int",
"plan_rows",
"plan_totals",
"build_vms",
"apply_profile",
"apply_overrides",
"expand_copies",
"entry_key",
"vm_name",
"clean_hostname",
"clip_payload",
"run_deploy_progress",
}
self.assertTrue(pures <= membres(TODO_DIR / "deploy_form_lib.py"))
# Réexportées par l'ancien module : les appelants historiques (et les
# tests déjà écrits) importent encore ces noms LÀ.
from script.todo import qemu_deploy_form as ancien
for nom in pures:
self.assertTrue(hasattr(ancien, nom), nom)
def test_the_row_factory_is_shared(self):
for fichier in ("qemu_deploy_form.py", "proxmox_deploy_form.py"):
src = pathlib.Path(TODO_DIR / fichier).read_text(encoding="utf-8")
self.assertIn("res_row_widgets(", src, fichier)
def test_the_css_base_is_shared(self):
self.assertIn("#plan", lib.CSS_BASE)
self.assertIn("PreviewScreen", lib.CSS_BASE)
for fichier in ("qemu_deploy_form.py", "proxmox_deploy_form.py"):
src = pathlib.Path(TODO_DIR / fichier).read_text(encoding="utf-8")
self.assertIn("CSS_BASE", src, fichier)
# Les règles communes ne doivent PAS être recopiées à côté.
self.assertNotIn("#totals { height: auto;", src, fichier)
if __name__ == "__main__":
unittest.main(verbosity=2)