Skip to content

email_channel

diapason.channels.email_channel

EmailChannel — SMTP/IMAP email adapter (stdlib only, zero extra deps).

EmailChannel

Bases: BaseChannel

Email channel adapter using stdlib smtplib and imaplib.

Parameters

smtp_host: SMTP server hostname. smtp_port: SMTP server port (default 587 for STARTTLS). imap_host: IMAP server hostname for incoming messages. imap_port: IMAP server port (default 993 for SSL). username: Email username. Falls back to EMAIL_USERNAME env var. password: Email password. Falls back to EMAIL_PASSWORD env var. use_tls: Whether to use TLS (default True). bus: Optional event bus for publishing channel events.

connect()

Start IMAP polling for incoming messages (if configured).

disconnect()

Stop the IMAP listener thread.

list_channels()

Return available channel identifiers.

on_message(handler)

Register a callback for incoming email messages.

send(channel, content, *, conversation_id='', metadata=None)

Send an email via SMTP. channel is the recipient address.

status()

Return the current connection status.