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.