🔄 Atualizador#

O sistema de atualização do Codis (src/updater/) é modular e usa apenas a stdlib: faz backup antes de qualquer mudança, aceita cancelamento a qualquer momento e restaura o backup se algo falhar. O diálogo de atualização (src/updater/dialog.py, aberto por open_update_dialog) mostra progresso, changelog e a escolha do modo.

Modos de Atualização#

Todos os modos passam por UpdateManager.update(mode) e devolvem um UpdateResult.

Os estados possíveis de um resultado (UpdateStatus) são UP_TO_DATE, UPDATE_AVAILABLE, SUCCESS, PENDING_RESTART, ERROR e CANCELLED.

Arquitetura#

Proteção de Dados#

Os caminhos em _PROTECTED (manager.py) são verificados antes de qualquer escrita ou remoção; nenhum modo os modifica.

API#

Verificação silenciosa na inicialização (não bloqueia a UI; roda em thread daemon):

from src.updater import UpdateManager, UpdateMode
from src.constants import APP_VERSION

mgr = UpdateManager(APP_VERSION)

def _on_result(result):
    if result.update_available:
        self.after(0, lambda: self._notify_update(result))

mgr.run_in_thread(mode=UpdateMode.CHECK_ONLY, callback=_on_result)

Atualização com progresso:

def _on_progress(message: str, percent: float) -> None:
    progressbar.set(percent)
    status_label.config(text=message)

mgr = UpdateManager(
    current_version="1.0.0",
    github_token=config.get("github_token", ""),
    on_progress=_on_progress,
)

result = mgr.update(UpdateMode.SMART)

if result.ok and result.restart_required:
    if messagebox.askyesno("Reiniciar?", "Atualização aplicada. Reiniciar agora?"):
        UpdateManager.restart_app()

Simulação (dry_run), sem modificar nada:

result = mgr.update(UpdateMode.SMART, dry_run=True)
print(f"Arquivos que seriam atualizados: {result.files_updated}")

BackupManager como context manager:

from src.updater.backup import BackupManager
from pathlib import Path

with BackupManager(Path("/caminho/para/codis")) as bm:
    bm.create(label="pre-update")
    # Se uma exceção ocorrer aqui, restore() é chamado automaticamente
    perform_risky_operation()
# Sem exceção -> cleanup() remove o backup temporário

Segurança: Backup → Aplicar → Confirmar → Limpar#

1. Backup automático: BackupManager.create() copia o diretório do app para um diretório temporário (sem __pycache__ nem .pyc).
2. Aplicação com checagem de cancelamento: o evento _cancelled é verificado a cada arquivo; se cancelado, a operação para e o backup é restaurado.
3. Confirmação: só após todas as operações terminarem, backup.cleanup() remove o snapshot.
4. Rollback em falha: qualquer exceção dispara restore() + cleanup() e o erro vira UpdateStatus.ERROR.

Configuração#

Sem token, a API do GitHub permite 60 requisições por hora por IP; com um PAT, o limite sobe para 5.000 por hora.

Testes#

tests/test_updater.py (87 casos) roda 100% offline: o canal é mockado com unittest.mock e os ZIPs são gerados em memória.

pytest tests/test_updater.py -v

Veja também Builds & Empacotamento e Arquitetura.