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.
Group the auth context components and public imports.
| Module | context |
Hold the authenticated state of one request. |
| Module | functions |
Provide auth context operations. |
From __init__.py:
| Class | |
Hold the authenticated state of one request. |
| Function | __dir__ |
List loaded attributes and declared public exports. |
| Function | __getattr__ |
Resolve and cache a public package export. |
| Function | bind |
Bind an authentication context to the current scope. |
| Function | current |
Return the authentication context bound to the current scope. |
| Constant | _EXPORTS |
Public export names mapped to their defining modules and attributes. |
| Constant | GUEST |
Shared context handed to every request nobody authenticated. It carries no identity and resolves to the empty snapshot, so sharing is safe. |
Resolve and cache a public package export.
| Parameters | |
name:str | Public attribute requested from this package. |
| Returns | |
object | Exported object from its defining module. |
| Raises | |
AttributeError | If the requested attribute is not exported. |
Bind an authentication context to the current scope.
| Parameters | |
context:orionis.auth.contracts.IAuthenticationContext | Context resolved for the running request. |
| Returns | |
None | No return value. |
| Raises | |
orionis.auth.AuthException | When no container scope is active, which means the caller is not inside a request and has nowhere to store the context. |
Return the authentication context bound to the current scope.
The context lives in the container scope the HTTP kernel opens for every request, which is backed by contextvars. Code running outside a request, such as a console command, always sees the shared guest context.
| Returns | |
orionis.auth.contracts.IAuthenticationContext | Context of the running request, or the shared guest context when no scope is active or nothing was bound yet. |
Public export names mapped to their defining modules and attributes.
| Value |
|
Shared context handed to every request nobody authenticated. It carries no identity and resolves to the empty snapshot, so sharing is safe.
| Value |
|