FastAPI est hautement testable grâce à son TestClient (basé sur Starlette/httpx) et son système d'injection de dépendances, ce qui rend le mocking des dépendances trivial. Les tests utilisent généralement pytest et le TestClient pour envoyer des requêtes à l'app sans serveur en cours d'exécution.
from fastapi.testclient import TestClient
from main import app
client = TestClient(app)
def test_read_item():
response = client.get("/items/5") # send a request to the app in-process
assert response.status_code == 200
assert response.json() == {"item_id": 5}
def test_create_item():
response = client.post("/items", json={"name": "Phone", "price": 999})
assert response.status_code == 201
assert response.json()["name"] == "Phone"
def test_validation_error():
response = client.post("/items", json={"name": "Phone"}) # missing price
assert response.status_code == 422 # FastAPI validates automatically
Le TestClient envoie des requêtes réelles à votre app en-process (aucun serveur nécessaire), vous testez donc le flux complet — routage, validation, sérialisation — et assertez sur les codes de statut et les réponses JSON.
# override a dependency with a mock/test version — no real database needed
def override_get_db():
return test_db_session
app.dependency_overrides[get_db] = override_get_db # swap the real dependency
def test_with_test_db():
response = client.get("/users")
# uses the test database via the override
app.dependency_overrides.clear() # reset after
Le dependency_overrides de FastAPI vous permet de remplacer n'importe quelle dépendance (session de base de données, auth, services externes) par un test double — la fondation des tests rapides et isolés, rendue triviale par la conception DI.
def test_protected():
# override the auth dependency to simulate a logged-in user
app.dependency_overrides[get_current_user] = lambda: fake_user
response = client.get("/me")
assert response.status_code == 200
✓ Use a TEST database (separate, or transactions rolled back per test)
✓ Override dependencies (DB, auth, external APIs) for isolation
✓ Test: status codes, response shapes, validation (422s), auth/permissions, edge cases
✓ For async-specific code, use httpx.AsyncClient / pytest-asyncio
✓ Tools: pytest, factory libraries for test data, coverage.py
Le test est essentiel pour les applications fiables, et FastAPI est particulièrement testable — comprendre comment le tester est important à la fois pour la qualité du code et parce que le framework est conçu pour la testabilité.
Le TestClient facilite le test du flux requête/réponse complet en-process (aucun serveur nécessaire), en vérifiant le routage, la validation, la sérialisation et les réponses exactement comme les clients les expérimentent.
La fonctionnalité remarquable est la surcharge de dépendances : parce que FastAPI utilise l'injection de dépendances, vous pouvez trivialement remplacer n'importe quelle dépendance — sessions de base de données, authentification, services externes — par des test doubles via app.dependency_overrides, permettant des tests rapides et isolés sans infrastructure réelle (cette testabilité est un avantage majeur de la conception DI).
Savoir comment utiliser le TestClient, surcharger les dépendances pour l'isolation (bases de données de test, auth/services simulés), tester les endpoints protégés et structurer une stratégie de test sensée (codes de statut, formes de réponse, validation, auth, cas limites) est une connaissance importante au niveau senior pour construire des applications FastAPI robustes.
Les APIs bien testées détectent les régressions et permettent une refactorisation confiante, et les outils de test de FastAPI rendent les tests approfondis simples, ce qui en fait un sujet fréquemment pertinent et professionnellement important.