orionis.http.Response

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

Explore modules View classes

class documentation

class Response(IResponse): (source)

Known subclasses: orionis.http.HTMLResponse, orionis.http.JSONResponse, orionis.http.PlainTextResponse, orionis.http.RedirectResponse, orionis.http.StreamingResponse

Constructor: Response(content, status_code, headers, media_type, ...)

View In Hierarchy

Undocumented

Method	`__init__`	Initialize the BaseResponse object.
Method	`addHeader`	Add a header to the response.
Method	`deleteCookie`	Delete a cookie by setting its expiration to the past.
Method	`getBody`	Return the response body as bytes.
Method	`getFlashData`	Return the data queued by `withFlash()` for the session flash bag.
Method	`getHeader`	Get the values for a header.
Method	`getMediaType`	Return the media type of the response.
Method	`getRawHeaders`	Return the headers as a list of (key, value) byte tuples.
Method	`getStatusCode`	Return the HTTP status code of the response.
Method	`getStream`	Return the response stream if present.
Method	`getStringHeaders`	Return the headers as a list of (key, value) string tuples.
Method	`hasHeader`	Check if a header is present.
Method	`hasStream`	Check if the response has a stream.
Method	`removeHeader`	Remove a header from the response.
Method	`render`	Render the content to bytes.
Async Method	`runBackground`	Run the background task if it exists.
Method	`setCookie`	Set a cookie header in the response.
Method	`setHeader`	Set a header, replacing any existing values.
Method	`withCookie`	Attach a cookie and return the response for chaining.
Method	`withCookies`	Attach several cookies at once and return the response.
Method	`withErrors`	Flash validation errors for the next request.
Method	`withFlash`	Flash a status message into the session and return the response.
Method	`withInput`	Flash the submitted payload so the next request can repopulate it.
Method	`withoutCookie`	Expire a cookie and return the response for chaining.
Class Variable	`__slots__`	Undocumented
Class Variable	`charset`	Undocumented
Instance Variable	`_body`	Undocumented
Instance Variable	`_flash`	Undocumented
Instance Variable	`_headers`	Undocumented
Instance Variable	`_raw_headers`	Undocumented
Instance Variable	`_stream`	Undocumented
Instance Variable	`background`	Undocumented
Instance Variable	`media_type`	Undocumented
Instance Variable	`status_code`	Undocumented

def __init__(self, content: Any = None, status_code: HTTPStatus | int = 200, headers: Mapping[str, str] | None = None, media_type: str | None = None, background: BackgroundTask | None = None): (source) ¶

overridden in orionis.http.HTMLResponse, orionis.http.JSONResponse, orionis.http.PlainTextResponse, orionis.http.RedirectResponse, orionis.http.StreamingResponse

Initialize the BaseResponse object.

Parameters
content:`Any, optional`	The response content or stream.
status_code:`HTTPStatus \| int, optional`	The HTTP status code for the response.
headers:`Mapping[str, str] \| None, optional`	The headers to include in the response.
media_type:`str \| None, optional`	The media type of the response.
background:`BackgroundTask \| None, optional`	The background task to run after response.

Returns
`None`	This method does not return a value.

def addHeader(self, key: str, value: str): (source) ¶

overrides orionis.http.contracts.response.IResponse.addHeader

Add a header to the response.

Parameters
key:`str`	The header name.
value:`str`	The header value.

Returns
`None`	This method does not return a value.

def deleteCookie(self, key: str, *, path: str = '/', domain: str | None = None): (source) ¶

overrides orionis.http.contracts.response.IResponse.deleteCookie

Delete a cookie by setting its expiration to the past.

Parameters
key:`str`	The name of the cookie to delete.
path:`str, default "/"`	The path for which the cookie is valid.
domain:`str \| None, optional`	The domain for which the cookie is valid.

Returns
`None`	This method does not return a value.

def getBody(self) -> bytes | None: (source) ¶

overrides orionis.http.contracts.response.IResponse.getBody

Return the response body as bytes.

Returns
`bytes \| None`	The response body as bytes, or None if not set.

def getFlashData(self) -> dict[str, Any] | None: (source) ¶

overrides orionis.http.contracts.response.IResponse.getFlashData

Return the data queued by withFlash() for the session flash bag.

Returns
`dict[str, Any] \| None`	The queued key-value pairs, or None when nothing was queued.

def getHeader(self, key: str) -> list[str] | None: (source) ¶

overrides orionis.http.contracts.response.IResponse.getHeader

Get the values for a header.

Parameters
key:`str`	The header name.

Returns
`list[str] \| None`	The list of header values, or None if not present.

def getMediaType(self) -> str | None: (source) ¶

overrides orionis.http.contracts.response.IResponse.getMediaType

Return the media type of the response.

Returns
`str \| None`	The media type, or None if not set.

def getRawHeaders(self) -> list[tuple[bytes, bytes]]: (source) ¶

overrides orionis.http.contracts.response.IResponse.getRawHeaders

overridden in orionis.http.EventStreamResponse

Return the headers as a list of (key, value) byte tuples.

Returns
`list of tuple of (bytes, bytes)`	The headers as (key, value) pairs encoded in latin-1.

def getStatusCode(self) -> int: (source) ¶

overrides orionis.http.contracts.response.IResponse.getStatusCode

Return the HTTP status code of the response.

Returns
`int`	The HTTP status code.

def getStream(self) -> AsyncIterable[bytes] | None: (source) ¶

overrides orionis.http.contracts.response.IResponse.getStream

overridden in orionis.http.EventStreamResponse

Return the response stream if present.

Returns
`AsyncIterable[bytes] \| None`	The response stream, or None if not set.

def getStringHeaders(self) -> list[tuple[str, str]]: (source) ¶

overridden in orionis.http.EventStreamResponse

Return the headers as a list of (key, value) string tuples.

Returns
`list of tuple of str`	The headers represented as (key, value) string pairs.

def hasHeader(self, key: str) -> bool: (source) ¶

overrides orionis.http.contracts.response.IResponse.hasHeader

Check if a header is present.

Parameters
key:`str`	The header name.

Returns
`bool`	True if the header is present, False otherwise.

def hasStream(self) -> bool: (source) ¶

overrides orionis.http.contracts.response.IResponse.hasStream

Check if the response has a stream.

Returns
`bool`	True if a stream is present, False otherwise.

def removeHeader(self, key: str): (source) ¶

overrides orionis.http.contracts.response.IResponse.removeHeader

Remove a header from the response.

Parameters
key:`str`	The header name.

Returns
`None`	This method does not return a value.

def render(self, content: Any) -> bytes: (source) ¶

overrides orionis.http.contracts.response.IResponse.render

overridden in orionis.http.JSONResponse

Render the content to bytes.

Parameters
content:`Any`	The content to render.

Returns
`bytes`	The rendered content as bytes.

async def runBackground(self): (source) ¶

overrides orionis.http.contracts.response.IResponse.runBackground

Run the background task if it exists.

Returns
`None`	This method does not return a value.

overrides orionis.http.contracts.response.IResponse.setCookie

Set a cookie header in the response.

Parameters
key:`str`	The cookie name.
value:`str, optional`	The cookie value. Defaults to an empty string.
max_age:`int \| None, optional`	The maximum age of the cookie in seconds.
expires:`datetime \| str \| int \| None, optional`	The expiration date of the cookie.
path:`str \| None, optional`	The path for which the cookie is valid.
domain:`str \| None, optional`	The domain for which the cookie is valid.
secure:`bool, optional`	Whether the cookie is secure.
http_only:`bool, optional`	Whether the cookie is HTTP only.
same_site:`str \| None, optional`	The SameSite policy for the cookie.
partitioned:`bool, optional`	Whether the cookie is partitioned.

Returns
`None`	This method does not return a value.

def setHeader(self, key: str, value: str): (source) ¶

overrides orionis.http.contracts.response.IResponse.setHeader

Set a header, replacing any existing values.

Parameters
key:`str`	The header name.
value:`str`	The header value.

Returns
`None`	This method does not return a value.

def withCookie(self, key: str, value: str = '', *, max_age: int | None = None, expires: datetime | str | int | None = None, path: str | None = '/', domain: str | None = None, secure: bool = False, http_only: bool = False, same_site: Literal['lax', 'strict', 'none'] | None = 'lax', partitioned: bool = False) -> Self: (source) ¶

overrides orionis.http.contracts.response.IResponse.withCookie

Attach a cookie and return the response for chaining.

Parameters
key:`str`	The cookie name.
value:`str, optional`	The cookie value. Defaults to an empty string.
max_age:`int \| None, optional`	The maximum age of the cookie in seconds.
expires:`datetime \| str \| int \| None, optional`	The expiration date of the cookie.
path:`str \| None, optional`	The path for which the cookie is valid.
domain:`str \| None, optional`	The domain for which the cookie is valid.
secure:`bool, optional`	Whether the cookie is secure.
http_only:`bool, optional`	Whether the cookie is HTTP only.
same_site:`str \| None, optional`	The SameSite policy for the cookie.
partitioned:`bool, optional`	Whether the cookie is partitioned.

Returns
`Self`	The same response instance, allowing fluent chaining.

def withCookies(self, cookies: Mapping[str, str | Mapping[str, Any]]) -> Self: (source) ¶

overrides orionis.http.contracts.response.IResponse.withCookies

Attach several cookies at once and return the response.

Parameters
cookies:`Mapping[str, str \| Mapping[str, Any]]`	Mapping of cookie names to either a plain value or a mapping of keyword arguments accepted by `setCookie`.

Returns
`Self`	The same response instance, allowing fluent chaining.

def withErrors(self, errors: Mapping[str, Any] | Exception) -> Self: (source) ¶

overrides orionis.http.contracts.response.IResponse.withErrors

Flash validation errors for the next request.

Errors are read back in templates through the errors global.

Parameters
errors:`Mapping[str, Any] \| Exception`	Mapping of field to message(s), or a validation exception.

Returns
`Self`	The same response instance, allowing fluent chaining.

def withFlash(self, key: str, value: Any = None) -> Self: (source) ¶

overrides orionis.http.contracts.response.IResponse.withFlash

Flash a status message into the session and return the response.

The value survives for exactly one subsequent request and is read back in templates through the flash() global.

Parameters
key:`str`	Flash data key.
value:`Any, optional`	Value to flash.

Returns
`Self`	The same response instance, allowing fluent chaining.

def withInput(self, values: Mapping[str, Any]) -> Self: (source) ¶

overrides orionis.http.contracts.response.IResponse.withInput

Flash the submitted payload so the next request can repopulate it.

Values are read back in templates through the old() global. Credential-like fields such as password are stripped.

Parameters
values:`Mapping[str, Any]`	Submitted form payload to remember.

Returns
`Self`	The same response instance, allowing fluent chaining.

def withoutCookie(self, key: str, *, path: str = '/', domain: str | None = None) -> Self: (source) ¶

overrides orionis.http.contracts.response.IResponse.withoutCookie

Expire a cookie and return the response for chaining.

Parameters
key:`str`	The name of the cookie to delete.
path:`str, default "/"`	The path for which the cookie is valid.
domain:`str \| None, optional`	The domain for which the cookie is valid.

Returns
`Self`	The same response instance, allowing fluent chaining.

__slots__: tuple[str, ...] = (source) ¶

overrides orionis.http.contracts.response.IResponse.__slots__

overridden in orionis.http.HTMLResponse, orionis.http.JSONResponse, orionis.http.PlainTextResponse, orionis.http.RedirectResponse, orionis.http.StreamingResponse

Undocumented

charset: ClassVar[str] = (source) ¶

Undocumented

_body: bytes | None = (source) ¶

overridden in orionis.http.StreamingResponse

Undocumented

_flash: dict[str, Any] | None = (source) ¶

Undocumented