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 _ThreadReport: (source)
Constructor: _ThreadReport(runtime, loop, exception, context, ...)
Transfer report ownership from a worker submission to its loop task.
| Static Method | _cancel |
Forward public cancellation without releasing task ownership. |
| Method | __init__ |
Retain one submission until admission and terminal task completion. |
| Method | _admit |
Transfer a published submission to a real task on the owning loop. |
| Method | _finished |
Transfer a terminal task outcome and release loop-side ownership. |
| Method | _reject |
Close unadmitted work and settle its public future before diagnosis. |
| Method | _release |
Release a submission after admission or a terminal scheduling failure. |
| Method | submit |
Publish ownership before enqueueing the loop-side admission callback. |
| Class Variable | __slots__ |
Submission state retained through admission and terminal delivery. |
| Instance Variable | _context |
Incident metadata shared by admission and diagnosis. |
| Instance Variable | _coroutine |
Reporting coroutine owned until admitted or closed. |
| Instance Variable | _exception |
Original application failure. |
| Instance Variable | _future |
Public future that stays cancellable until task completion. |
| Instance Variable | _incident |
Claim whose unused delivery must be abandoned. |
| Instance Variable | _loop |
Event loop receiving the reporting coroutine. |
| Instance Variable | _runtime |
Runtime retaining pending report ownership. |
Forward public cancellation without releasing task ownership.
| Parameters | |
reference:weakref.ReferenceType[asyncio.Task] | Non-owning reference so a retained receipt future releases context. |
result:concurrent.futures.Future | Public future that may have been cancelled by any thread. |
| Returns | |
None | No return value. |
def __init__(self, runtime:
FailureRuntime, loop: asyncio.AbstractEventLoop, exception: BaseException, context: FailureContext, incident: _Incident):
(source)
¶
Retain one submission until admission and terminal task completion.
| Parameters | |
runtime:FailureRuntime | Runtime owning the cross-thread report. |
loop:asyncio.AbstractEventLoop | Event loop that must execute the report. |
exception:BaseException | Original failure to deliver. |
context:FailureContext | Incident metadata claimed by the originating callback. |
incident:_Incident | Pending incident to retain or abandon at completion. |
| Returns | |
None | No return value. |
Transfer a published submission to a real task on the owning loop.
| Returns | |
None | No return value. |
| Raises | |
BaseException | If task creation raises a control-flow signal after cleanup. |
Transfer a terminal task outcome and release loop-side ownership.
| Parameters | |
task:asyncio.Task | Reporting task whose actual cleanup has completed. |
| Returns | |
None | No return value. |
Close unadmitted work and settle its public future before diagnosis.
| Parameters | |
secondary:BaseException | Original failure to enqueue or create the reporting task. |
| Returns | |
None | No return value. |
Publish ownership before enqueueing the loop-side admission callback.
| Returns | |
concurrent.futures.Future or None | Cancellable delivery future, or None if enqueueing failed. |
| Raises | |
BaseException | If enqueueing raises a control-flow signal after cleanup. |