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.

module documentation

Use one verified SMTP connection per message, entirely on a worker.

Function _mail_options Require advertised SMTPUTF8 support for international mailbox addresses.
Function _tls_context Require trusted certificates, hostname verification, and TLS 1.2 or newer.
Constant _BATCH_WORKERS Batch workers used by smtp.
Constant _MAX_BATCH Max batch value used by smtp.
Constant _SMTP_READY Smtp ready value used by smtp.
def _mail_options(client: smtplib.SMTP, message: PreparedMail) -> list[str]: (source)

Require advertised SMTPUTF8 support for international mailbox addresses.

Parameters
client:smtplib.SMTPConnection after EHLO and any required TLS negotiation.
message:orionis.mail.entities.PreparedMailPrepared message with its UTF-8 requirement.
Returns
list[str]Explicit MAIL FROM extensions, empty for ASCII mailboxes.
Raises
orionis.mail.exceptions.MailTransportExceptionIf an international mailbox cannot be transmitted without loss.
def _tls_context() -> ssl.SSLContext: (source)

Require trusted certificates, hostname verification, and TLS 1.2 or newer.

Returns
ssl.SSLContextA client context using the system trust store.
_BATCH_WORKERS = (source)

Batch workers used by smtp.

Value
BoundedExecutor(4,
                max_pending=16, name='orionis-smtp-batch')
_MAX_BATCH: int = (source)

Max batch value used by smtp.

Value
100
_SMTP_READY: int = (source)

Smtp ready value used by smtp.

Value
220