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.
class IDefaultResponses(ABC): (source)
Known subclasses: orionis.http.default.responses.DefaultResponses
Define the contract for default responses implementations.
| Method | asset |
Return an allowlisted framework asset, or a 404 response. |
| Async Method | dump |
Wrap an escaped variable dump in the framework's diagnostic layout. |
| Async Method | error |
Return an error page or JSON response for the specified status code. |
| Async Method | exception |
Render an exception page with request and traceback details. |
| Async Method | favicon |
Return the favicon file response or a 404 response if not found. |
| Async Method | health |
Render the application health state as an HTML or JSON response. |
| Async Method | robots |
Return the robots.txt file or a 404 response if not found. |
| Async Method | sitemap |
Return the public sitemap.xml file, or a 404 response when absent. |
| Class Variable | __slots__ |
Declare that this class introduces no additional instance slots. |
orionis.http.default.responses.DefaultResponsesReturn an allowlisted framework asset, or a 404 response.
| Parameters | |
path:str | Asset path relative to the framework's public asset prefix. |
| Returns | |
orionis.http.FileResponse or orionis.http.Response | Packaged static file when allowed and present, otherwise a 404. |
orionis.http.default.responses.DefaultResponsesWrap an escaped variable dump in the framework's diagnostic layout.
| Parameters | |
content:str | Trusted HTML fragment produced by VarDumper.toHtml(). Variable values and type labels must already be escaped. |
| Returns | |
orionis.http.HTMLResponse | Uncached debug page using the shared local styles and fonts. |
int | HTTPStatus, content: str | dict, *, expects_json: bool, headers: dict[ str, str] | None = None) -> HTMLResponse | JSONResponse:
(source)
¶
orionis.http.default.responses.DefaultResponsesReturn an error page or JSON response for the specified status code.
| Parameters | |
statusint | orionis.http.enums.HTTPStatus | Integer HTTP status between 100 and 599. Unlisted codes use an HTTP <code> label on the HTML page. |
content:str | dict | Content of the error to display. A str is used as the message; a dict is serialised directly into the JSON payload or extracted via its message key for HTML rendering. The HTML description is escaped text; JSON preserves the supplied values. |
expectsbool | If True, returns a JSON response; otherwise, returns HTML. |
headers:dict[str, str] | None, optional | Additional headers to include in the response. |
| Returns | |
orionis.http.HTMLResponse or orionis.http.JSONResponse | HTMLResponse with rendered error page, or JSONResponse if expects_json is True. |
| Raises | |
TypeError | If status_code is not an integer. |
ValueError | If status_code is outside the range 100 to 599. |
str, request_method: str, exception: BaseException, status_code: int | HTTPStatus = HTTPStatus.INTERNAL_SERVER_ERROR) -> HTMLResponse:
(source)
¶
orionis.http.default.responses.DefaultResponsesRender an exception page with request and traceback details.
| Parameters | |
requeststr | Path of the request that caused the exception. |
requeststr | HTTP method of the request that caused the exception. |
exception:BaseException | Exception instance to be rendered. |
statusint | orionis.http.enums.HTTPStatus, optional | HTTP status code for the response. Defaults to 500. |
| Returns | |
orionis.http.HTMLResponse | Rendered exception page as an HTMLResponse with the given status code. |
orionis.http.default.responses.DefaultResponsesReturn the favicon file response or a 404 response if not found.
Searches for a favicon in the public storage directory using common favicon file names and content types. If not found, attempts to use the framework's internal fallback favicon. Caches the result for subsequent calls.
| Returns | |
orionis.http.FileResponse or orionis.http.Response | A FileResponse containing the favicon if found, otherwise a Response with status 404. |
orionis.http.default.responses.DefaultResponsesRender the application health state as an HTML or JSON response.
| Parameters | |
request:orionis.http.Request | The HTTP request object. |
| Returns | |
orionis.http.HTMLResponse or orionis.http.JSONResponse | HTMLResponse with the state page content or JSONResponse with the application status. Status is 200 if healthy, 503 if under maintenance. |
orionis.http.default.responses.DefaultResponsesReturn the robots.txt file or a 404 response if not found.
Search for a robots.txt file in the public storage directory. If not found, check for a fallback file. Cache the result for future calls.
| Returns | |
orionis.http.FileResponse or orionis.http.Response | FileResponse with robots.txt if found, otherwise Response with 404. |
orionis.http.default.responses.DefaultResponsesReturn the public sitemap.xml file, or a 404 response when absent.
Retain the selected path and read its current metadata for each response.
| Returns | |
orionis.http.FileResponse or orionis.http.Response | FileResponse with sitemap.xml if found, otherwise Response with status 404. |
orionis.http.default.responses.DefaultResponsesDeclare that this class introduces no additional instance slots.