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 = 'This is a plain text message' mailer.send_plain( 'sender@example.com', ['recipient@example.com'], 'hi', message )
Sending an HTML message:
message = '<html><body>Look! HTML!</body></html>' mailer.send_html( 'sender@example.com', ['recipient@example.com'], 'hi', message )
Adding attachments:
message = 'index.rst is attached to this message' mailer.send_plain( 'sender@example.com', ['recipient@example.com'], 'hi', message, attachments=['index.rst'] )
CHANGELOG
3.0.1 (released 2019-11-06)
- Fixed PyPI package metadata
3.0.0 (released 2019-11-06)
- Added Python 3 support
- Dropped Python 2 support
Version 2.1
- Added a ThreadedMailer.shutdown method (thanks to Andrew Nelis for an initial implementation and advice on the design of this feature)
Version 2
- Added TLS/STARTTLS support (thanks to w31rd0 for the implementation of this)
Version 1
- Initial release
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size mailtools-3.0.1-py3-none-any.whl (13.9 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size mailtools-3.0.1.tar.gz (16.4 kB) | File type Source | Python version None | Upload date | Hashes View |
Close
Hashes for mailtools-3.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fcb8dc584c6f62c70b537305aa28c96ce02e4d6eb978578a1db08d2a998d1e70 |
|
MD5 | 28813643687fa396dd698cba447d988b |
|
BLAKE2-256 | 7d32584696ba39b65e3f6c82f8d344081bdddb7a7d81250372008771b9d47bda |