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
Receive original failures and declared failed outcomes exactly once.
| Async Method | handle |
Select deferred effects for the original exception. |
| Async Method | handle |
Select deferred effects for a declared failed result. |
async def handleFailure(self, exception:
BaseException, context: FailureContext) -> FailureHandling | None:
(source)
¶
overridden in
orionis.failure.base.BaseExceptionHandlerSelect deferred effects for the original exception.
Defer logging to the runtime and presentation to the execution owner.
| Parameters | |
exception:BaseException | Original exception instance supplied by the execution boundary. |
context:orionis.failure.entities.context.FailureContext | Immutable execution metadata describing the failure. |
| Returns | |
orionis.failure.entities.handling.FailureHandling or None | Deferred handling plan, or None to observe without logging or presentation. |
async def handleResult(self, value:
object, context: FailureContext) -> FailureHandling | None:
(source)
¶
overridden in
orionis.failure.base.BaseExceptionHandlerSelect 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:object | Original result classified as a failure by its execution owner. |
context:orionis.failure.entities.context.FailureContext | Immutable execution metadata describing the failed result. |
| Returns | |
orionis.failure.entities.handling.FailureHandling or None | Deferred handling plan, or None to observe without logging or presentation. |