Estratégias de Teste para Temporal em Python

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

Quando Usar Esta Habilidade

• Testes unitários de workflows - Testes rápidos com salto de tempo
• Testes de integração - Workflows com atividades mockadas
• Testes de replay - Validar determinismo contra históricos de produção
• Desenvolvimento local - Configurar servidor Temporal e pytest
• Integração CI/CD - Pipelines de teste automatizados
• Estratégias de cobertura - Alcançar ≥80% de cobertura de teste

Filosofia de Teste

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

• Escrever a maioria como testes de integração
• Usar pytest com fixtures assíncronas
• O salto de tempo permite feedback rápido (workflows de um mês → segundos)
• Mockar atividades para isolar a lógica do workflow
• Validar determinismo com testes de replay

Três Tipos de Teste:

1. Unitário: Workflows com salto de tempo, atividades com ActivityEnvironment
2. Integração: Workers com atividades mockadas
3. End-to-end: Servidor Temporal completo com atividades reais (usar 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 salto de tempo
• 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 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 Docker Compose
• Configuração e ajuste do pytest
• Integração de 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. Salto de Tempo - Workflows de um mês testados em segundos
2. Mock de Atividades - Isolar a lógica do workflow de dependências externas
3. Teste de Replay - Validar 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:

• "Mostre-me padrões de teste unitário" → Carregar resources/unit-testing.md
• "Como faço mock de atividades?" → Carregar resources/integration-testing.md
• "Configurar servidor Temporal local" → Carregar resources/local-setup.md
• "Validar determinismo" → Carregar resources/replay-testing.md

Referências Adicionais

• Teste do SDK Python: docs.temporal.io/develop/python/testing-suite

…