skip to navigation
skip to content

mailtools 2

Tools for constructing and sending emails

Downloads ↓

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']
)
 
File Type Py Version Uploaded on Size # downloads
mailtools-2.tar.gz (md5) Source 2010-05-15 17KB 607