Tools for constructing and sending emails
Project description
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']
)
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mailtools-2.1.tar.gz
(19.7 kB
view hashes)