refactor: models_api.py vira ponto de entrada sobre admin/api/

A ponte JSON do app tinha 1.395 linhas e 37 comandos de oito assuntos
diferentes num arquivo só. Agora models_api.py guarda apenas a referência
dos comandos, a tabela de despacho e o main(); cada assunto virou um módulo
em admin/api/ (models, project, editing, zoom, subtitles, transcription,
voice, review), com a base comum em shared.py.

Nada muda para o app: ele continua chamando admin/models_api.py por caminho,
e os 37 comandos respondem igual — verificado rodando a ponte de verdade.

Duas coisas que a divisão obrigou a arrumar:

- A saída passa por `shared.emit` chamada pelo módulo, não pelo nome
  importado. Isso preserva a propriedade de que trocar `emit` num lugar só
  captura a saída de todos os comandos — que era acidental quando tudo
  morava no mesmo arquivo, e vira intencional agora.
- `_CANCEL` e o lock eram globais compartilhados. O registro de downloads
  foi para models.py, junto de quem o usa, com lock próprio: o antigo
  protegia ao mesmo tempo o dicionário e a escrita em stdout, duas coisas
  sem relação.

Também: admin/test_models_api.py estava fora de `testpaths` e nunca rodava.
Movido para code/tests/ e ligado ao gate — 1441 → 1454 testes
(ver Engine/docs/05_EXPERIENCIAS.md #24).

Lint zerado, 1454 testes passando.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
João Henrique
2026-08-19 21:46:47 -04:00
co-authored by Claude Opus 5
parent 4f5cf94443
commit 6090e229e9
14 changed files with 1649 additions and 1254 deletions
+7 -8
View File
@@ -20,7 +20,6 @@ import subprocess
import sys
import threading
from pathlib import Path
from typing import Optional
import flet as ft
@@ -29,8 +28,8 @@ _CODE_DIR = str(Path(__file__).resolve().parent.parent / "code")
if _CODE_DIR not in sys.path:
sys.path.insert(0, _CODE_DIR)
from fcpxml.media_intel import media_src_to_path # noqa: E402
from fcpxml.model_manager import ( # noqa: E402
from fcpxml.media_intel import media_src_to_path
from fcpxml.model_manager import (
download_model,
get_models_dir,
is_model_downloaded,
@@ -41,8 +40,8 @@ from fcpxml.model_manager import ( # noqa: E402
save_models_dir,
save_selected_model,
)
from fcpxml.parser import parse_fcpxml # noqa: E402
from fcpxml.transcribe import transcribe # noqa: E402
from fcpxml.parser import parse_fcpxml
from fcpxml.transcribe import transcribe
logger = logging.getLogger(__name__)
@@ -101,9 +100,9 @@ class ModelManagerApp:
def __init__(self, page: ft.Page) -> None:
self.page = page
self.selected = load_selected_model()
self.downloading: Optional[str] = None
self.downloading: str | None = None
self._cancel_events: dict[str, threading.Event] = {}
self._picker: Optional[ft.FilePicker] = None
self._picker: ft.FilePicker | None = None
# ── helpers ────────────────────────────────────────────────────────────
@@ -121,7 +120,7 @@ class ModelManagerApp:
self._picker = ft.FilePicker()
self._picker.on_result = self._on_file_picked
self.page.overlay.append(self._picker)
self._pending_target: Optional[dict] = None
self._pending_target: dict | None = None
def _on_file_picked(self, e) -> None:
if self._pending_target == "project":