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.
Describe the immutable metadata needed to invoke one callable.
| Class | |
Describe the immutable metadata needed to invoke one callable. |
| Function | _callable |
Validate a callable and retain its parameter and coroutine metadata. |
| Function | _clear |
Discard plans derived from explicitly invalidated reflection metadata. |
| Function | _positional |
Read positional-only names from the shared signature cache. |
| Function | _resolve |
Resolve one class-local constructor hint without rejecting other parameters. |
| Function | callable |
Select a plan using the callable's function and receiver mode. |
| Function | constructor |
Validate a concrete class and prepare its constructor metadata. |
| Function | warm |
Prepare ordinary controller descriptors without creating an instance. |
Callable, *, bound: bool = False) -> InvocationPlan:
(source)
¶
Validate a callable and retain its parameter and coroutine metadata.
| Parameters | |
target:collections.abc.Callable | Function underlying the callable. |
bound:bool, optional | Whether a receiver is supplied by Python's descriptor binding. |
| Returns | |
orionis.container.entities.invocation.InvocationPlan | Metadata reusable across different instances of the same controller. |
str, globalns: dict[ str, object], localns: dict[ str, object]) -> object:
(source)
¶
Resolve one class-local constructor hint without rejecting other parameters.
| Parameters | |
annotation:str | Deferred annotation from the constructor signature. |
globalns:dict[str, object] | Defining module namespace. |
localns:dict[str, object] | Class namespace including its own name. |
| Returns | |
object | Resolved annotation, or None when its references remain unavailable. |
Select a plan using the callable's function and receiver mode.
| Parameters | |
target:collections.abc.Callable | Function or bound method invoked by the container. |
| Returns | |
orionis.container.entities.invocation.InvocationPlan | Parameter plan that does not retain a bound receiver. |
type, constructor: object) -> InvocationPlan:
(source)
¶
Validate a concrete class and prepare its constructor metadata.
| Parameters | |
target:type | Concrete class instantiated by the container. |
constructor:object | Current __init__ descriptor, included in the cache identity. |
| Returns | |
orionis.container.entities.invocation.InvocationPlan | Shared constructor parameters with resolvable class-local types restored. |
Prepare ordinary controller descriptors without creating an instance.
Notes
Static lookup does not execute custom descriptor getters. Only ordinary Python functions and built-in constructor descriptors are inspected. Dependencies and controller instances are always resolved at request time. Plans remain subject to the bounded LRU capacity.
| Parameters | |
target:type | Controller whose constructor and action will run during requests. |
methodstr | Instance, static, or class method selected by the route. |
| Returns | |
None | This function does not return a value. |