Metadata-Version: 1.0
Name: mailtools
Version: 1
Summary: Tools for constructing and sending emails
Home-page: UNKNOWN
Author: Oliver Cope
Author-email: oliver@redgecko.org
License: BSD
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'))
        
        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']
        )
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Communications :: Email
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
