feat: sauvegarde atomique des JSON avec schema_version et recuperation .bak

sessions.json/keys.json/settings.json etaient ecrits directement
(Path.write_text) : un crash ou une coupure de courant pendant l'ecriture
pouvait laisser un fichier tronque, sans aucun recours.

- app/storage/atomic_file.py : ecriture .tmp + flush + fsync +
  os.replace() (atomique y compris sous Windows).
- app/storage/json_store.py : load_json_document()/save_json_document().
  Chaque sauvegarde conserve la version precedente dans un .bak ; au
  chargement, un fichier principal corrompu retombe automatiquement sur ce
  .bak avant de se rabattre sur des valeurs par defaut. Chaque document porte
  un schema_version, avec une chaine de migrations (vide pour l'instant) pour
  faire evoluer le format plus tard sans invalider les fichiers existants.
- SessionStore et KeyManager utilisent ce module (schema_version=1) ; un
  fichier legacy sans schema_version reste charge normalement et n'est reecrit
  qu'a la prochaine sauvegarde naturelle (comportement de "premiere ecriture"
  inchange par rapport a avant).
- settings.json (theme.py) et known_hosts (known_hosts_manager.py, via
  paramiko.HostKeys.save() redirige vers un .tmp puis os.replace())
  beneficient aussi de l'ecriture atomique.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Florian
2026-09-05 01:42:59 +02:00
parent fd848c2025
commit 23f5aaccd1
7 changed files with 250 additions and 29 deletions

View File

@@ -0,0 +1,24 @@
"""Ecriture atomique de fichiers : un crash ou une coupure de courant pendant
l'ecriture ne doit jamais laisser un fichier tronque ou corrompu a la place de
l'ancien, valide."""
from __future__ import annotations
import os
from pathlib import Path
def atomic_write_bytes(path: Path, content: bytes) -> None:
path = Path(path)
path.parent.mkdir(parents=True, exist_ok=True)
tmp_path = path.with_name(path.name + ".tmp")
with open(tmp_path, "wb") as f:
f.write(content)
f.flush()
os.fsync(f.fileno())
# os.replace() est atomique y compris sous Windows (contrairement a os.rename(),
# qui y echoue si la destination existe deja).
os.replace(tmp_path, path)
def atomic_write_text(path: Path, content: str, encoding: str = "utf-8") -> None:
atomic_write_bytes(path, content.encode(encoding))