orionis.container.entities.invocation

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

module documentation

(source)

Undocumented

Class	`InvocationPlan`	Describe the immutable metadata needed to invoke one callable.
Function	`_callable_plan`	Validate a callable and retain its parameter and coroutine metadata.
Function	`callable_plan`	Select a plan using the callable's function and receiver mode.
Function	`constructor_plan`	Validate a concrete class and prepare its constructor metadata.
Function	`warm_controller_plan`	Prepare ordinary controller descriptors without creating an instance.

@lru_cache(maxsize=1024)

def _callable_plan(target: Callable, *, bound: bool = False) -> InvocationPlan: (source) ¶

Validate a callable and retain its parameter and coroutine metadata.

Parameters
target:`Callable`	Function underlying the callable.
bound:`bool, optional`	Whether a receiver is supplied by Python's descriptor binding.

Returns
`InvocationPlan`	Metadata reusable across different instances of the same controller.

def callable_plan(target: Callable) -> InvocationPlan: (source) ¶

Select a plan using the callable's function and receiver mode.

Parameters
target:`Callable`	Function or bound method invoked by the container.

Returns
`InvocationPlan`	Parameter plan that does not retain a bound receiver.

@lru_cache(maxsize=1024)

def constructor_plan(target: 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
`InvocationPlan`	Shared constructor parameters with resolvable class-local types restored.

def warm_controller_plan(target: type, method_name: str): (source) ¶

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.
method_name:`str`	Instance, static, or class method selected by the route.

Returns
`None`	Standard descriptor plans are cached; custom descriptors remain lazy.