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

class IBaseExceptionHandler(ABC): (source)

Known subclasses: orionis.failure.base.BaseExceptionHandler

View In Hierarchy

Receive original failures and declared failed outcomes exactly once.

Async Method handleFailure Select deferred effects for the original exception.
Async Method handleResult Select deferred effects for a declared failed result.
async def handleFailure(self, exception: BaseException, context: FailureContext) -> FailureHandling | None: (source)

Select deferred effects for the original exception.

Defer logging to the runtime and presentation to the execution owner.

Parameters
exception:BaseExceptionOriginal exception instance supplied by the execution boundary.
context:orionis.failure.entities.context.FailureContextImmutable execution metadata describing the failure.
Returns
orionis.failure.entities.handling.FailureHandling or NoneDeferred handling plan, or None to observe without logging or presentation.
async def handleResult(self, value: object, context: FailureContext) -> FailureHandling | None: (source)

Select deferred effects for a declared failed result.

Preserve the original result without constructing an exception. Defer logging to the runtime and presentation to the execution owner.

Parameters
value:objectOriginal result classified as a failure by its execution owner.
context:orionis.failure.entities.context.FailureContextImmutable execution metadata describing the failed result.
Returns
orionis.failure.entities.handling.FailureHandling or NoneDeferred handling plan, or None to observe without logging or presentation.