title: Testing Client API
description: "API reference for the test client in JustAPI, the FastAPI alternative — in-process HTTP test client for testing routes without a server."
keywords: [testing client, fastapi alternative, justapi, test client, justapitestclient, integration testing]

JustAPITestClient

The test client sends HTTP requests to your application without starting a real server, using tokio duplex streams.

from justapi import JustAPITestClient

client = JustAPITestClient(app)

Methods

response = client.get("/items/42")
response = client.post("/items/", body={"name": "Item"})
response = client.put("/items/42", body={"name": "Updated"})
response = client.patch("/items/42", body={"name": "Patched"})
response = client.delete("/items/42")

Response Object

Example Test

from justapi import JustAPIApp, JustAPITestClient

app = JustAPIApp()

@app.get("/ping")
def ping(request):
    return {"status": "ok"}

client = JustAPITestClient(app)
response = client.get("/ping")
assert response.status == 200
assert response.json() == {"status": "ok"}

See Also

• Testing Guide — Writing tests for JustAPI
• JustAPIApp — App configuration