orionis.mail.transports.SmtpTransport

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.

Explore modules View classes

class documentation

class SmtpTransport(IMailTransport): (source)

Constructor: SmtpTransport(settings)

View In Hierarchy

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

Cancelling the awaiting task does not stop the worker and does not prove that the server refused the message. There are no automatic retries.

Method	`__init__`	Retain validated settings without opening a connection.
Method	`_result`	Report exactly the recipients accepted by a completed transaction.
Method	`_sendSync`	Connect, negotiate, authenticate, transmit, and always close.
Async Method	`send`	Run the complete blocking SMTP cycle outside the event loop.
Class Variable	`__slots__`	Undocumented
Instance Variable	`_settings`	Undocumented

def __init__(self, settings: SmtpSettings): (source) ¶

Retain validated settings without opening a connection.

Parameters
settings:`SmtpSettings`	Immutable effective connection options.

Returns
`None`	Store transport configuration only.

def _result(self, message: PreparedMail, mailer: str, driver: str, refused: Mapping[str, tuple[int, bytes | str]]) -> MailResult: (source) ¶

Report exactly the recipients accepted by a completed transaction.

Parameters
message:`PreparedMail`	Intended recipient union and message identifier.
mailer:`str`	Selected configuration name.
driver:`str`	Registered driver name.
refused:`Mapping[str, tuple[int, bytes \| str]]`	Recipient rejections returned after the transaction succeeded.

Returns
`MailResult`	Accepted or partial, with sanitized immutable rejection metadata.

Raises
`MailTransportException`	If no recipient was accepted.

def _sendSync(self, message: PreparedMail, mailer: str, driver: str) -> MailResult: (source) ¶

Connect, negotiate, authenticate, transmit, and always close.

Parameters
message:`PreparedMail`	Complete operation-local message.
mailer:`str`	Selected configuration name.
driver:`str`	Registered driver name.

Returns
`MailResult`	Confirmed recipient acceptance after a successful transaction.

Raises
`MailTransportException`	Sanitized failure identifying stage, exception type, and SMTP code.

async def send(self, message: PreparedMail, *, mailer: str, driver: str) -> MailResult: (source) ¶

Run the complete blocking SMTP cycle outside the event loop.

Parameters
message:`PreparedMail`	Already materialized MIME and a validated separate envelope.
mailer:`str`	Configuration name reported in the result.
driver:`str`	Registered transport name reported in the result.

Returns
`MailResult`	Total or partial acceptance confirmed by the SMTP transaction.

Raises
`MailTransportException`	If the transaction fails or every recipient is rejected.

__slots__: tuple[str, ...] = (source) ¶

Undocumented

_settings = (source) ¶

Undocumented