O cliente de testes e os dispositivos de teste

Os testes permitem alterar o código sem medo. Com pytest, você comprova em segundos que cada rota continua funcionando, em vez de navegar manualmente pelo aplicativo. 🧪

O Flask inclui um navegador simulado chamado cliente de testes. Ele chama suas rotas na memória, sem servidor real nem rede.

Crie o cliente chamando app.test_client(). Ele retorna um objeto cujos métodos correspondem aos verbos HTTP reais, como get e post.

Chamar client.get('/') retorna um objeto de resposta. Você o inspeciona como faria com uma resposta real, mas tudo é executado instantaneamente dentro do Python.

Um acessório de teste é um código de configuração reutilizável que o pytest executa antes de um teste. Em vez de recriar o cliente em todos os lugares, defina-o uma vez e reutilize-o.

Decore uma função com @pytest.fixture e produza um cliente de testes. Qualquer teste que o nomeie como argumento receberá um cliente novo.

Para usar um acessório, basta adicionar seu nome como um argumento do teste. O Pytest encontra a correspondência e injeta o valor automaticamente.

Usar yield permite executar a limpeza depois que o teste termina. O código antes de yield prepara o ambiente; o código depois de yield desfaz tudo.

Coloque os acessórios compartilhados em um arquivo chamado conftest.py. O Pytest o encontra automaticamente, então todos os arquivos de teste podem usar esses acessórios sem importação.

O Pytest encontra arquivos que começam com test_ e funções com nomes no mesmo padrão. Siga essa convenção e seus testes serão executados com um único comando.

Na raiz do projeto, execute pytest no terminal. Ele reúne todos os arquivos de teste, executa-os e exibe um resumo claro de aprovação ou falha.

Você conheceu o cliente de teste em memória e aprendeu a compartilhá-lo com uma fixture em conftest.py. Agora todo teste começa com um cliente pronto. 🎉