Metadata-Version: 1.1
Name: mailtools
Version: 2.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'))
        
        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']
                )
        
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
