ORIONIS API REFERENCE

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 documentation

A reusable unbound handler plan; payloads never become keyword mappings.

Class Method compile Resolve annotations and classify all parameters once during boot.
Static Method _clientValue Read only parameters explicitly declared as client-controlled input.
Async Static Method _value Resolve the trusted source chosen at compile time.
Async Method invoke Inject trusted context/services while preserving generator results.
Class Variable function Unbound handler function executed by the invocation plan.
Class Variable parameters Binding plans for all handler parameters, including injected dependencies.
Class Variable receiver Whether the handler receives an instance, a class or no receiver.
def compile(cls, definition: type, method: str, payload_type: object = None, *, argument_names: tuple[str, ...] = (), uri_names: tuple[str, ...] = ()) -> McpInvoker: (source)

Resolve annotations and classify all parameters once during boot.

Parameters
definition:typeClass declaration whose metadata is being inspected.
method:strValue supplied for method.
payload_type:objectValue supplied for payload_type.
argument_names:tuple[str, ...]Value supplied for argument_names.
uri_names:tuple[str, ...]Value supplied for uri_names.
Returns
orionis.mcp.invoker.McpInvokerResult of the operation described above.
def _clientValue(parameter: _Parameter, request: McpRequest, payload: object) -> object: (source)

Read only parameters explicitly declared as client-controlled input.

Parameters
parameter:orionis.mcp.invoker._ParameterValue supplied for parameter.
request:orionis.mcp.McpRequestCurrent request and its trusted execution context.
payload:objectInput payload supplied for conversion or processing.
Returns
objectResult of the operation described above.
async def _value(parameter: _Parameter, app: IContainer, request: McpRequest, payload: object) -> object: (source)

Resolve the trusted source chosen at compile time.

Parameters
parameter:orionis.mcp.invoker._ParameterValue supplied for parameter.
app:orionis.container.contracts.container.IContainerApplication container supplying configuration and dependencies.
request:orionis.mcp.McpRequestCurrent request and its trusted execution context.
payload:objectInput payload supplied for conversion or processing.
Returns
objectResult of the operation described above.
async def invoke(self, instance: object, app: IContainer, request: McpRequest, payload: object = msgspec.UNSET) -> object: (source)

Inject trusted context/services while preserving generator results.

Parameters
instance:objectInstance supplying values or receiving the invocation.
app:orionis.container.contracts.container.IContainerApplication container supplying configuration and dependencies.
request:orionis.mcp.McpRequestCurrent request and its trusted execution context.
payload:objectInput payload supplied for conversion or processing.
Returns
objectResult of the operation described above.
function: Callable[..., object] = (source)

Unbound handler function executed by the invocation plan.

parameters: tuple[_Parameter, ...] = (source)

Binding plans for all handler parameters, including injected dependencies.

receiver: Literal['instance', 'class', 'none'] = (source)

Whether the handler receives an instance, a class or no receiver.