orionis.mail.pending

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.

module documentation

(source)

Undocumented

Function	`_assert_declaration`	Reject invalid synchronous declarations without leaking coroutines.
Function	`_is_mailable_class`	Check whether a value is a Mailable subclass.
Async Function	`_run_callback`	Run one configurator exactly once and await an asynchronous result.

def _assert_declaration(value: object, expected: type, label: str): (source) ¶

Reject invalid synchronous declarations without leaking coroutines.

Parameters
value:`object`	Declaration result.
expected:`type`	Required runtime type.
label:`str`	Declaration method or field name.

Returns
`None`	Accept only the required type.

Raises
`MailCompositionException`	If the declared value violates its synchronous contract.

def _is_mailable_class(value: object) -> TypeGuard[type[Mailable]]: (source) ¶

Check whether a value is a Mailable subclass.

Parameters
value:`object`	Value to inspect.

Returns
`bool`	Whether `value` is a class derived from `Mailable`.

async def _run_callback(callback: object, message: Message): (source) ¶

Run one configurator exactly once and await an asynchronous result.

Parameters
callback:`object`	Function, method, or callable object supplied by the caller.
message:`Message`	Configurator exclusive to the current operation.

Returns
`None`	Apply the callback mutations to the supplied message.

Raises
`MailCompositionException`	If the callback is not callable, fails, or returns another value.