Verificar integração com arquivos temporários

No tutorial anterior, os substitutos permitiram verificar componentes isoladamente. Agora, o foco muda: vamos exercitar a colaboração entre componentes reais e o sistema de arquivos local.

O caso condutor recebe dois caminhos explicitamente — entrada e saída — e executa este fluxo:

1. lê uma lista JSON de quantidades inteiras;
2. calcula a soma dessas quantidades;
3. grava um resumo JSON com o campo total.

O escopo continua controlado: não há banco de dados, rede ou outro serviço externo.

Um retorno correto não basta para comprovar todo o fluxo. A operação também precisa produzir o arquivo de saída no caminho recebido, com o conteúdo previsto pelo contrato.

Por isso, o resultado principal da integração é o conteúdo persistido. A verificação deve alcançar o último ponto observável do percurso, em vez de parar no valor calculado em memória.

Para receber um diretório temporário, inclua tmp_path como parâmetro da função de teste. Ao executar o teste, o pytest reconhece esse nome e fornece um objeto pathlib.Path que aponta para um diretório temporário exclusivo daquele teste.

Você não cria tmp_path nem importa uma variável com esse nome. O recurso é solicitado pela assinatura da função.

O diretório indicado por tmp_path já existe quando o teste começa. Use o operador / de Path para construir caminhos filhos, sem depender de caminhos absolutos ou específicos da sua máquina.

Construir entrada e saida não cria esses arquivos. Eles somente passarão a existir quando alguma operação gravar conteúdo neles.

Salve como tests/test_caminhos.py e execute com python -m pytest tests/test_caminhos.py.

Neste cenário, o próprio teste cria um arquivo JSON conhecido dentro de tmp_path. Em seguida, chama o leitor real e compara o resultado com uma lista esperada.

A entrada deve ser gravada diretamente pelo teste. Se usássemos o gravador da aplicação para preparar o arquivo, um defeito nele poderia interferir na verificação do leitor.

O recurso temporário participa das três etapas: o teste prepara o JSON, o leitor real acessa o arquivo e o valor carregado é comparado com a expectativa.

Na raiz de uma pasta local, crie processamento.py com o código completo abaixo. O módulo reúne leitura, processamento e persistência para os próximos testes. Nesta etapa, o foco é carregar_quantidades, que recebe o caminho explicitamente e lê texto em UTF-8.

Crie a pasta tests e, dentro dela, o arquivo test_processamento.py. O caminho entrada.json fica sob o diretório recebido por este teste. O arquivo ainda não existe quando o caminho é composto; write_text o cria com dados sintéticos e previsíveis.

No fluxo completo, a operação recebe os caminhos de entrada e saída localizados sob tmp_path, lê as quantidades, calcula a soma e grava o resumo.

A verificação não deve se limitar ao retorno da função nem apenas confirmar que a saída existe. O teste precisa abrir o arquivo realmente gravado, decodificar seu JSON e comparar o conteúdo com uma expectativa definida pelo próprio cenário.

Para evitar que erros compatíveis se escondam, confira a saída com read_text() e json.loads(), da biblioteca padrão, em vez de usar o leitor da aplicação como única forma de testar o gravador.

No arquivo de testes usado no step anterior, adicione o teste abaixo. Ajuste apenas o nome do módulo importado caso você tenha usado outro nome para o arquivo da aplicação.

Execute o teste no seu projeto com python -m pytest. Depois, altere temporariamente esperado para {"total": 21} e execute novamente: o teste deve falhar porque o conteúdo persistido não corresponde à expectativa. Restaure {"total": 20} e confirme que ele volta a passar.

Um teste de integração também deve verificar falhas previsíveis. Neste step, a operação processar_arquivo(entrada, saida) continua sendo exercitada com componentes reais, mas recebe duas entradas problemáticas:

• um caminho cujo arquivo não foi criado;
• um arquivo existente com JSON sintaticamente inválido.

Nos dois casos, a leitura falha antes que a operação abra o arquivo de saída. Portanto, além da exceção específica, o contrato deste exemplo permite verificar que a saída não foi criada.

Os dois cenários param na etapa de leitura e não chegam à gravação.

Com tmp_path, compor um caminho não cria o arquivo. Isso permite provocar FileNotFoundError sem apagar arquivos existentes nem tocar em pastas pessoais.

Adicione este teste ao arquivo de testes que já importa pytest e a operação processar_arquivo:

Agora a entrada deve existir. Grave deliberadamente um texto como [10, 20,, que começa uma lista e termina sem fechá-la. Ao tentar decodificá-lo, json.load ou json.loads gera json.JSONDecodeError, propagado pela operação integrada.

Isso é diferente de um JSON sintaticamente válido com dados inadequados ao domínio. Por exemplo, {"quantidade": "muitas"} pode ser um JSON válido, ainda que não atenda ao contrato da aplicação. Aqui, o foco é exclusivamente a falha de decodificação.

Garanta que o arquivo de testes também tenha import json:

Duas funções de teste podem criar entrada.json e saida.json com os mesmos nomes. Como cada uma recebe um diretório exclusivo por tmp_path, os caminhos completos são diferentes.

Cada teste deve preparar seus próprios dados, executar a operação e verificar seu próprio resultado. Assim, a suíte não depende da ordem de execução: nenhum teste precisa consumir um arquivo produzido por outro.

Observe que nomes de arquivo iguais não representam o mesmo recurso quando estão dentro de diretórios temporários diferentes.

Construa os caminhos sob tmp_path e passe-os explicitamente para a operação testada. O código não deve procurar entradas no diretório de trabalho nem depender de um caminho específico da sua máquina.

O pytest administra a retenção e a limpeza dos diretórios temporários conforme sua política e configuração. Portanto, não presuma que todo diretório será apagado imediatamente após o teste. Resíduos podem permanecer no disco, mas novas execuções não devem reutilizá-los como entrada.

Crie uma pasta vazia no seu computador. Dentro dela, crie processamento.py e a pasta tests, contendo test_integracao.py. O exemplo é completo e usa arquivos reais sob o diretório exclusivo recebido por cada teste.

Este módulo lê uma lista JSON, calcula o total e persiste o resumo. A entrada é lida e processada antes da abertura da saída.

Cada teste prepara seu próprio cenário sob tmp_path. O caso de sucesso confere o JSON com a biblioteca padrão; os casos de falha exigem exceções específicas e ausência de saída.

Abra o terminal na pasta que contém processamento.py. Execute primeiro cada cenário, depois a suíte completa e, por fim, repita a execução completa. A repetição deve continuar aprovada porque nenhum teste depende dos arquivos produzidos por outro.

Execute os comandos na ordem apresentada.