Files
pyssh-client/app/sftp/worker.py
Florian c39ef9c038 Qualite : pyproject.toml (ruff/pytest/pyright) + CI Gitea (lint/tests/build)
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>
2026-09-05 07:46:50 +02:00

61 lines
2.1 KiB
Python

"""Execution asynchrone des operations SFTP.
paramiko.SFTPClient n'est pas concu pour etre pilote depuis plusieurs threads a
la fois : ce module fait en sorte qu'un seul thread possede jamais un client SFTP
donne. Toute operation (listage, mkdir, rename, remove, chmod, stat, ...) est
soumise a la file de ce thread sous forme de callable ; le resultat revient sur
le thread appelant (GUI) via un signal Qt, qui les mets automatiquement en file
d'attente quand emetteur et recepteur vivent dans des threads differents.
"""
from __future__ import annotations
import queue
import threading
from collections.abc import Callable
from dataclasses import dataclass
from typing import Any
from PySide6.QtCore import QThread, Signal
@dataclass
class _Job:
request_id: int
fn: Callable[[], Any]
class SftpWorker(QThread):
"""Un worker = un canal SFTP, jamais partage avec un autre thread."""
result_ready = Signal(int, object, object) # request_id, resultat, exception|None
def __init__(self, parent=None):
super().__init__(parent)
self._queue: queue.Queue[_Job | None] = queue.Queue()
self._next_id = 0
self._lock = threading.Lock()
def submit(self, fn: Callable[[], Any]) -> int:
"""Met `fn` en file pour execution sur le thread du worker. Renvoie un
identifiant a rapprocher du signal `result_ready`."""
with self._lock:
self._next_id += 1
request_id = self._next_id
self._queue.put(_Job(request_id, fn))
return request_id
def run(self) -> None:
while True:
job = self._queue.get()
if job is None: # sentinelle posee par stop()
break
try:
result = job.fn()
self.result_ready.emit(job.request_id, result, None)
except Exception as exc: # noqa: BLE001 - remonte a l'appelant via le signal
self.result_ready.emit(job.request_id, None, exc)
def stop(self) -> None:
"""Arrete le worker une fois les jobs deja en file executes."""
self._queue.put(None)