Testes automatizados com FastAPI

Introdução ao FastAPI

Matt Eckerle

Software and Data Engineering Leader

O que são testes automatizados?

Testes de unidade

Foco: Código isolado
Objetivo: Validar a função do código
Escopo: Função ou método
Ambiente: Ambiente Python isolado

def test_main():
    response = main()
    assert response == {"msg": "Hello"}

Testes de sistema

Foco: Operações do sistema isoladas
Objetivo: Validar a função do sistema
Escopo: Endpoint
Ambiente: Ambiente Python com o app em execução

def test_read_main():
    response = client.get("/")
    assert response.status_code == 200
    assert response.json() == {"msg": 
                               "Hello"}

Usando o TestClient

TestClient: cliente HTTP para pytest

# Importar TestClient e o app
from fastapi.testclient import TestClient
from .main import app

# Criar cliente de teste com contexto da aplicação
client = TestClient(app)


def test_main():
    response = client.get("/")
    assert response.status_code == 200
    assert response.json() == {"msg": "Hello"}

Testando respostas de erro ou falha

App

app = FastAPI()

@app.delete("/items")
def delete_item(item: Item):
    if item.id not in item_ids:
        raise HTTPException(
            status_code=404, 
            detail="Item not found.")
    else:
        delete_item_in_database(item)
        return {}

Teste

def test_delete_nonexistent_item():
    response = client.delete(
        "/items",
        json={"id": -999})
    assert response.status_code == 404
    json = response.json()
    assert json == {"detail":
                    "Item not found."}

Vamos praticar!

Introdução ao FastAPI