FastAPI yra labai testuojama dėl TestClient (paremto Starlette/httpx) ir jos priklausomybės injekcijos sistemos, kuri daro priklausomybių Mock sudaryti trivialiu. Testai paprastai naudoja pytest ir TestClient, kad siųstų užklausas į aplikaciją be veikiančio serverio.
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 siunčia reales užklausas jūsų aplikacijai procesu (serveris nereikalingas), todėl testuojate pilną srautą — maršrutizavimą, validavimą, serializavimą — ir tvirtinate statuso kodus ir JSON atsakymus.
# 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
FastAPI dependency_overrides leidžia pakeisti bet kurią priklausomybę (duomenų bazės sesiją, autentifikavimą, išorinius servisus) test double — greitų, izoliuotų testų pagrindą, kurį daro trivialiu DI dizainas.
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
Testavimas yra būtinas patikimoms aplikacijoms, ir FastAPI yra labai testuojama — suvokti, kaip ją testuoti, svarbu tiek kodo kokybei, tiek todėl, kad šis framework'as skirtas testuojamumui.
TestClient leidžia lengvai testuoti pilną užklausos/atsakymo srautą procesu (serveris nereikalingas), patikrinant maršrutizavimą, validavimą, serializavimą ir atsakymus taip, kaip juos patiria klientai.
Išsiskirianti savybė yra priklausomybių perrašymas: kadangi FastAPI naudoja priklausomybės injekciją, galite trivialiai pakeisti bet kurią priklausomybę — duomenų bazės sesijas, autentifikavimą, išorinius servisus — test double per app.dependency_overrides, įgalinant greitus, izoliuotus testus be realios infrastruktūros (šis testuojamumas yra didelis DI dizaino pranašumas).
Žinoti, kaip naudoti TestClient, perrašyti priklausomybes izoliavimui (test duomenų bazės, mock'inti autentifikavimą/servisus), testuoti apsaugotus endpoint'us ir struktūrizuoti protingą testavimo strategiją (statuso kodai, atsakymų formos, validavimas, autentifikavimas, kraštutiniai atvejai) yra svarbi aukščiausio lygio žinios, skirtos tvirtiems FastAPI programoms kurti.
Gerai testuotos API sugauna regresijas ir suteikia pasitikėjimą refaktoravimui, o FastAPI testavimo įrankiai daro nuolatinį testavimą paprastu, todėl tai yra dažnai aktualus, profesionaliai svarbus dalykas.