FastAPI este extrem de testabil datorită TestClient (construit pe Starlette/httpx) și sistemului său de injectare a dependențelor, care face mock-ul dependențelor trivial. Testele utilizează de obicei pytest și TestClient pentru a trimite cereri către aplicație fără un server în funcțiune.
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
TestClient trimite cereri reale către aplicația ta în-proces (nu este necesar un server), deci testezi fluxul complet — rutare, validare, serializare — și faci aserțiuni asupra codurilor de stare și răspunsurilor 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
dependency_overrides al FastAPI te lasă să înlocuiești orice dependență (sesiune bază de date, autentificare, servicii externe) cu un test double — fundamentul testelor rapide și izolate, făcut trivial de design-ul 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
Testarea este esențială pentru aplicații fiabile, iar FastAPI este remarcabil de testabil — înțelegerea modului în care să-l testezi este importantă atât pentru calitatea codului, cât și pentru că framework-ul este conceput pentru testabilitate.
TestClient face ușor să testezi fluxul complet request/response în-proces (nu este necesar un server), verificând rutare, validare, serializare și răspunsuri exact așa cum le-ar experimenta clienții.
Funcționalitatea remarcabilă este suprascrierea dependențelor: deoarece FastAPI folosește injectarea dependențelor, poți ușor să înlocuiești orice dependență — sesiuni bază de date, autentificare, servicii externe — cu test doubles via app.dependency_overrides, permițând teste rapide și izolate fără infrastructură reală (această testabilitate este un beneficiu major al design-ului DI).
A ști cum să folosești TestClient, să suprascrii dependențele pentru izolare (baze de date de test, autentificare/servicii mock), să testezi endpoint-uri protejate și să structurezi o strategie de testare sensibilă (coduri de stare, forme de răspuns, validare, autentificare, cazuri limită) este cunoaștere importantă la nivel senior pentru construirea aplicațiilor FastAPI robuste.
API-urile bine testate prind regresii și permit refactoring cu încredere, iar instrumentele de testare ale FastAPI fac testarea amănunțită directă, făcând aceasta un subiect frecvent relevant și profesional important.