c39ef9c038
pyproject.toml devient le point d'entree unique de configuration des outils
(pytest.ini supprime, sa config y est deplacee). Les dependances restent dans
requirements.txt/requirements-dev.txt (deja utilises par setup.bat) plutot que
dupliquees ici : ce projet se distribue par PyInstaller, pas par "pip install".
ruff : configure puis passe sur tout app/ + tests/ (154 corrections
automatiques, purement mecaniques - tri des imports, imports multiples sur une
ligne separes, alias depreciees) suivies de 7 corrections manuelles ciblees :
- app/ssh_connection.py : `raise ... from None` pour le refus explicite de
passphrase (ce n'est pas un echec a diagnostiquer).
- app/controllers/workspace_manager.py : zip() sans strict= documente en
commentaire (deliberement tolerant a un workspace legerement perime).
- tests/test_ai_redaction.py : nom de variable ambigu renomme.
- E702 (construction compacte "widget = X(); widget.setY(...)" dans
sftp_panel.py/tunnel_dialog.py) et E402 (quelques tests qui importent un
symbole juste avant la section qui l'utilise) : ignores explicitement, ce
sont des styles deliberes preexistants, pas des oublis.
`ruff check app main.py tests` est desormais propre.
pyright : mode "basic" (le code n'a jamais ete type). Plus de 200 signalements
sur ~300 etaient le meme faux positif connu de l'ecosysteme PySide6 (acces
plat aux enums Qt, ex. Qt.UserRole, valide a l'execution mais que les stubs ne
reconnaissent que sous leur forme imbriquee) : desactive avec justification en
commentaire. Reste un socle de 77 signalements reels (surtout des acces
Optional non filtres dans app/ui/tabs.py et app/ssh_connection.py) : non
corrige dans cette phase - resserrer le typage la ou pyright a raison est un
travail a part, pas une consequence automatique de l'ajout de l'outil. La CI
le lance en mode informatif (continue-on-error) tant que ce socle n'est pas
resorbe.
.gitea/workflows/ci.yml : lint (ruff, bloquant), tests (pytest, bloquant),
typecheck (pyright, informatif), build (PyInstaller, sur main uniquement,
artefact du dossier portable). Necessite un runner Gitea Actions Windows
enregistre - PySide6/pywinpty/Credential Manager/ACL NTFS sont Windows
uniquement, comme l'application elle-meme ; non verifiable depuis ce poste.
Suite complete revalidee apres coup (33/33) pour confirmer qu'aucune des 154
corrections automatiques n'a modifie de comportement.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
82 lines
3.1 KiB
Python
82 lines
3.1 KiB
Python
"""Chargement/sauvegarde de documents JSON versionnes (sessions, cles, ...).
|
|
|
|
Chaque document porte un `schema_version`. `migrations` associe une version de
|
|
depart a une fonction qui transforme le document vers la version suivante ; le
|
|
chargement applique la chaine jusqu'a `current_version`, ce qui permet de faire
|
|
evoluer le format plus tard sans invalider les fichiers existants.
|
|
|
|
La sauvegarde est atomique (voir atomic_file) et conserve la version precedente
|
|
dans un `.bak` : si l'ecriture suivante produit un fichier corrompu (crash,
|
|
disque plein), le chargement suivant retombe automatiquement sur cette sauvegarde
|
|
plutot que de perdre les donnees de l'utilisateur.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
from collections.abc import Callable
|
|
from pathlib import Path
|
|
|
|
from app.storage.atomic_file import atomic_write_bytes
|
|
|
|
MigrationMap = dict[int, Callable[[dict], dict]]
|
|
|
|
|
|
def _bak_path(path: Path) -> Path:
|
|
return path.with_name(path.name + ".bak")
|
|
|
|
|
|
def _migrate(document: dict, current_version: int, migrations: MigrationMap) -> dict:
|
|
version = int(document.get("schema_version", 0) or 0)
|
|
while version < current_version:
|
|
migrate = migrations.get(version)
|
|
if migrate is None:
|
|
break # pas de chemin de migration connu : le document est garde tel quel
|
|
document = migrate(document)
|
|
version = int(document.get("schema_version", version + 1))
|
|
document["schema_version"] = current_version
|
|
return document
|
|
|
|
|
|
def load_json_document(
|
|
path: Path,
|
|
*,
|
|
default: dict,
|
|
current_version: int,
|
|
migrations: MigrationMap | None = None,
|
|
) -> tuple[dict, str | None]:
|
|
"""Renvoie (document, avertissement). `avertissement` est None si le fichier
|
|
principal a ete lu normalement ; sinon il decrit la recuperation effectuee
|
|
(restauration depuis .bak, ou repli sur les valeurs par defaut)."""
|
|
migrations = migrations or {}
|
|
warning: str | None = None
|
|
|
|
for candidate, is_backup in ((Path(path), False), (_bak_path(Path(path)), True)):
|
|
if not candidate.exists():
|
|
continue
|
|
try:
|
|
raw = json.loads(candidate.read_text(encoding="utf-8"))
|
|
except (OSError, json.JSONDecodeError, UnicodeDecodeError) as exc:
|
|
warning = f"{candidate.name} illisible ({exc})"
|
|
continue
|
|
if not isinstance(raw, dict):
|
|
warning = f"{candidate.name} invalide (contenu inattendu)"
|
|
continue
|
|
if is_backup:
|
|
warning = f"{Path(path).name} illisible, restaure depuis {candidate.name}"
|
|
return _migrate(raw, current_version, migrations), warning
|
|
|
|
if warning is None and not Path(path).exists():
|
|
pass # premier lancement : pas d'avertissement, juste les valeurs par defaut
|
|
return _migrate(dict(default), current_version, migrations), warning
|
|
|
|
|
|
def save_json_document(path: Path, document: dict) -> None:
|
|
path = Path(path)
|
|
if path.exists():
|
|
try:
|
|
atomic_write_bytes(_bak_path(path), path.read_bytes())
|
|
except OSError:
|
|
pass
|
|
payload = json.dumps(document, indent=2, ensure_ascii=False)
|
|
atomic_write_bytes(path, payload.encode("utf-8"))
|