Tests automatisés avec FastAPI

Introduction à FastAPI

Matt Eckerle

Software and Data Engineering Leader

Qu'est-ce qu'un test automatisé ?

Tests unitaires

Cible : Code isolé
But : Valider le comportement
Portée : Fonction ou méthode
Environnement : Env Python isolé

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

Tests système

Cible : Opérations du système, isolées
But : Valider le fonctionnement
Portée : Point de terminaison
Environnement : Env Python avec l'app en cours d'exécution

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

Utiliser TestClient

TestClient : client HTTP pour pytest

# Importer TestClient et l'app
from fastapi.testclient import TestClient
from .main import app

# Créer un client de test avec le contexte de l'application
client = TestClient(app)


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

Tester les réponses d'erreur ou d'échec

Application

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 {}

Test

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."}

Passons à la pratique !

Introduction à FastAPI