orionis.container.facades.facade.ScopedFacade

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

class ScopedFacade(Facade): (source)

Expose a service already bound to the caller's active scope.

Scoped services never enter the process-wide facade cache. Closing a scope also prevents access from child tasks that inherited that scope.

Async Class Method	`pin`	Validate scope availability without retaining the service globally.
Async Class Method	`resolve`	Resolve the current instance without constructing a global service.
Class Method	`scopedInstance`	Return the service bound to the active scope.
Class Method	`unpin`	Leave lifetime management to the owning scope.

Inherited from Facade:

Class Method	`getFacadeAccessor`	Return the container accessor key for this facade.
Class Variable	`_application`	Undocumented
Class Variable	`_pinned_instance`	Undocumented

overrides orionis.container.facades.Facade.pin

Validate scope availability without retaining the service globally.

Returns
`None`	Scoped attribute access is already direct.

async def resolve(cls, *_args: object, **_kwargs: object) -> object: (source) ¶

overrides orionis.container.facades.Facade.resolve

Resolve the current instance without constructing a global service.

Parameters
*_args:`object`	Unused; scoped instances are bound by their lifecycle owner.
**_kwargs:`object`	Unused; scoped instances are bound by their lifecycle owner.

Returns
`object`	Service belonging to the active scope.

Return the service bound to the active scope.

Returns
`object`	Request-local service instance.

Raises
`RuntimeError`	If no active scope contains the service.

overrides orionis.container.facades.Facade.unpin

Leave lifetime management to the owning scope.

Returns
`None`	No global instance exists to clear.