⏳ Timer Thread em Python com prompt_toolkit

Este repositório contém uma série de exemplos que demonstram a criação de uma classe de Timer assíncrona baseada em threading.Thread em Python, culminando em uma aplicação interativa de múltiplos timers usando a biblioteca prompt_toolkit.

A implementação foca em:

• Herança de Thread: Estendendo threading.Thread para encapsular a lógica do timer.
• Controle de Fluxo: Utilização de threading.Event (_stop_event e _running_event) para gerenciar os estados Stop, Pause e Resume.
• Precisão: Uso de time.monotonic_ns para cálculos de tempo mais precisos, compensando o overhead do loop.
• Interface Gráfica: Construção de uma interface de console interativa com prompt_toolkit (no exemplo final code008.py).

---

⚙️ Como Executar

Para executar o código principal, que demonstra a interface interativa de múltiplos timers, use o seguinte comando no Linux ou macOS:

clear ; PYTHON_GIL=1 uv run src/conc_lessons/lesson003/code008.py

Nota: É crucial definir PYTHON_GIL=1 para garantir que o Global Interpreter Lock (GIL) esteja ativado durante a execução de threads em ambientes que usam o uv (como o uv run), garantindo o comportamento esperado da aplicação multithread. O caminho src/conc_lessons/lesson003/ deve ser ajustado para a estrutura do seu projeto.

🔑 Teclas de Atalho na Aplicação Interativa (code008.py) ⏸️ Pausar / Continuar (Toggle Pause) Timer 1 (45s): Tecla 1

Timer 2 (3600s): Tecla 2

Timer 3 (2800s): Tecla 3

Timer 4 (60s): Tecla 4

🛑 Parar (Stop) Timer 1 (45s): Tecla F1

Timer 2 (3600s): Tecla F2

Timer 3 (2800s): Tecla F3

Timer 4 (60s): Tecla F4

🚪 Sair da Aplicação Aperte Ctrl + Q 📁 Arquivos Principais code001.py

Descrição: Exemplo básico de herança de threading.Thread.

Conceitos: threading.Thread por herança.

code002.py

Descrição: Extensão da Thread para passar funções alvo (target) e obter um resultado simples.

Conceitos: Passagem de target e recuperação de self.result.

code003.py

Descrição: Implementação aprimorada com ParamSpec (typing) para capturar o resultado e exceções.

Conceitos: ParamSpec, tratamento de resultados e exceções da Thread.

code005.py

Descrição: Introdução de threading.Event para gerenciar Pause e Stop do loop principal.

Conceitos: Controle de fluxo com Event.set(), Event.clear(), Event.is_set() e Event.wait().

code006.py

Descrição: Refatoração para um Timer funcional com cálculo de tempo preciso (time.monotonic_ns) e compensação de loop overhead.

Conceitos: Compensação de Drift (desvio de tempo), time.monotonic_ns.

code007.py

Descrição: Versão do Timer que demonstra a atualização do estado visual no console (interface simples) e uso de threading.Timer para agendar ações.

Conceitos: Atualização de console, uso de threading.Timer.

code008.py (Aplicação Final)

Descrição: Implementa 4 timers paralelos em uma interface interativa usando a biblioteca prompt_toolkit.

Conceitos: Threads em IGUIs de terminal (TUI), prompt_toolkit, lambdas para renderização dinâmica de conteúdo.

📚 Tecnologias Utilizadas Python: Linguagem principal.

threading: Módulo para programação concorrente.

time: Módulo para medição de tempo (monotonic_ns, sleep).

prompt_toolkit: Biblioteca para construir aplicações de linha de comando interativas (TUI).