mailtools

Writing a web application? Want to send some emails from it? Mailtools can help!

• Simple API for sending plain text messages, HTML and messages with attachments.

• ThreadedMailer sends emails in the background and returns control to your application immediately, even when talking to slow remote servers.

• Temporary sending failures are automatically retried.

• Running your application in test mode? The RedirectMessages wrapper routes emails to a test address and not to live email addresses.

Usage

Creating a simple SMTP mailer:

from mailtools import SMTPMailer
mailer = SMTPMailer('127.0.0.1')

This mailer will block until messages are sent and won’t retry failures. Use ThreadedMailer to fix this:

mailer = ThreadedMailer(SMTPMailer('127.0.0.1'))

A mailer with TLS/STARTTLS support:

mailer = SMTPMailer('127.0.0.1', 465, transport_args={'security': 'TLS'})
mailer = SMTPMailer('127.0.0.1', transport_args={'security': 'STARTTLS'})

Sending a plain text message:

message = u'This is a plain text message'
mailer.send_plain(
        u'sender@example.com',
        [u'recipient@example.com'],
        u'hi',
        message
)

Sending an HTML message:

message = u'<html><body>Look! HTML!</body></html>'
mailer.send_html(
        u'sender@example.com',
        [u'recipient@example.com'],
        u'hi',
        message
)

Adding attachments:

message = u'index.rst is attached to this message'
mailer.send_plain(
        u'sender@example.com',
        [u'recipient@example.com'],
        u'hi',
        message,
        attachments=['index.rst']
)