Response¶

future.response.Response is a mutable builder. Controllers return self.response.…(...) (same instance Future injected).

Builders¶

self.response.json(data, status=200)
self.response.html(html)
self.response.text("ok")
self.response.empty(status=204)
self.response.redirect("/x")
self.response.file(body_bytes, content_type="application/octet-stream")
self.response.image(body_bytes, content_type="image/png")
self.response.set_cookie("a", "b", max_age=3600, domain="example.com")
self.response.delete_cookie("a")

Each builder sets status, body, and headers, then returns self so you can chain cookies:

return self.response.json({"ok": True}).set_cookie("sid", token, httponly=True)

Errors¶

from future.exceptions import HTTPException
raise HTTPException("Not Found", 404)

Streaming¶

StreamingResponse is a separate class (same module as WebSocketResponse). Chunked HTTP bodies are not folded into Response yet.

from future.response import StreamingResponse

return StreamingResponse(["hello", " ", "world"], content_type="text/plain")

WebSocket sessions use WebSocketResponse — see WebSockets.