Estratégias de Teste para Temporal Python

Abordagens abrangentes de teste para workflows Temporal usando pytest, recursos de divulgação progressiva para cenários de teste específicos.

Não use esta habilidade quando

• A tarefa não estiver relacionada a estratégias de teste Temporal Python
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique as melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.

Use esta habilidade quando

• Testes unitários de workflows - Testes rápidos com "time-skipping" (avanço de tempo)
• Testes de integração - Workflows com atividades mockadas (simuladas)
• Testes de replay - Valide a determinismo contra históricos de produção
• Desenvolvimento local - Configure o servidor Temporal e o pytest
• Integração CI/CD - Pipelines de teste automatizados
• Estratégias de cobertura - Alcance ≥80% de cobertura de teste

Filosofia de Teste

Abordagem Recomendada (Fonte: docs.temporal.io/develop/python/testing-suite):

• Escreva a maioria como testes de integração
• Use pytest com "async fixtures"
• O "time-skipping" permite feedback rápido (workflows de um mês → segundos)
• Mocke atividades para isolar a lógica do workflow
• Valide o determinismo com testes de replay

Três Tipos de Teste:

1. Unitário: Workflows com "time-skipping", atividades com ActivityEnvironment
2. Integração: Workers com atividades mockadas
3. End-to-end: Servidor Temporal completo com atividades reais (use com moderação)

Recursos Disponíveis

Esta habilidade fornece orientação detalhada através de divulgação progressiva. Carregue recursos específicos com base nas suas necessidades de teste:

Recursos de Teste Unitário

Arquivo: resources/unit-testing.md Quando carregar: Testando workflows ou atividades individuais isoladamente Contém:

• WorkflowEnvironment com "time-skipping"
• ActivityEnvironment para teste de atividades
• Execução rápida de workflows de longa duração
• Padrões de avanço manual de tempo
• Fixtures e padrões do pytest

Recursos de Teste de Integração

Arquivo: resources/integration-testing.md Quando carregar: Testando workflows com dependências externas mockadas Contém:

• Estratégias de mock de atividades
• Padrões de injeção de erros
• Teste de workflow com múltiplas atividades
• Teste de sinais e consultas
• Estratégias de cobertura

Recursos de Teste de Replay

Arquivo: resources/replay-testing.md Quando carregar: Validando determinismo ou implantando alterações de workflow Contém:

• Validação de determinismo
• Replay de histórico de produção
• Padrões de integração CI/CD
• Teste de compatibilidade de versão

Recursos de Desenvolvimento Local

Arquivo: resources/local-setup.md Quando carregar: Configurando o ambiente de desenvolvimento Contém:

• Configuração do Docker Compose
• Configuração e ajuste do pytest
• Integração da ferramenta de cobertura
• Workflow de desenvolvimento

Guia de Início Rápido

Teste Básico de Workflow

import pytest
from temporalio.testing import WorkflowEnvironment
from temporalio.worker import Worker

@pytest.fixture
async def workflow_env():
    env = await WorkflowEnvironment.start_time_skipping()
    yield env
    await env.shutdown()

@pytest.mark.asyncio
async def test_workflow(workflow_env):
    async with Worker(
        workflow_env.client,
        task_queue="test-queue",
        workflows=[YourWorkflow],
        activities=[your_activity],
    ):
        result = await workflow_env.client.execute_workflow(
            YourWorkflow.run,
            args,
            id="test-wf-id",
            task_queue="test-queue",
        )
        assert result == expected

Teste Básico de Atividade

from temporalio.testing import ActivityEnvironment

async def test_activity():
    env = ActivityEnvironment()
    result = await env.run(your_activity, "test-input")
    assert result == expected_output

Metas de Cobertura

Cobertura Recomendada (Fonte: melhores práticas do docs.temporal.io):

• Workflows: ≥80% de cobertura de lógica
• Atividades: ≥80% de cobertura de lógica
• Integração: Caminhos críticos com atividades mockadas
• Replay: Todas as versões de workflow antes da implantação

Princípios Chave de Teste

1. Time-Skipping - Workflows de um mês testados em segundos
2. Mock de Atividades - Isole a lógica do workflow de dependências externas
3. Teste de Replay - Valide o determinismo antes da implantação
4. Alta Cobertura - Meta de ≥80% para workflows de produção
5. Feedback Rápido - Testes unitários executados em milissegundos

Como Usar os Recursos

Carregue o recurso específico quando necessário:

…