Metadata-Version: 1.0
Name: iw.email
Version: 0.2.1
Summary: Email utilities
Home-page: UNKNOWN
Author: Ingeniweb
Author-email: support@ingeniweb.com
License: GPL
Description: ========
        iw.email
        ========
        
        .. contents::
        
        What is iw.email ?
        ==================
        
        Provide a clean way to generate emails.
        
        How to use iw.email ?
        =====================
        
        MultipartMail
        -------------
        
        We need some html::
        
        >>> umail = unicode('''<html><body>
        ... corps du maiil avec caractère unicode:
        ... utf-8: é à î ö
        ... cp552: \xe2\x80\x93 \xe2\x80\x99
        ... </body></html>''', 'utf-8')
        
        
        And a smtp server::
        
        >>> from smtplib import SMTP
        >>> server = SMTP('localhost')
        
        Now we can use the MultipartMail class to generate an email::
        
        >>> from iw.email import MultipartMail
        
        >>> mail = MultipartMail(html=umail,
        ...             mfrom='sender@ingeniweb.com',
        ...             mto='recipient@ingeniweb.com',
        ...             subject=unicode('sujèéèt','utf-8'))
        
        And send it::
        
        >>> server.sendmail('sender@ingeniweb.com','recipient@ingeniweb.com', mail)
        Content-Type: multipart/related; charset="iso-8859-1";
        boundary="...
        MIME-Version: 1.0
        To: recipient@ingeniweb.com
        From: sender@ingeniweb.com
        Subject: =?iso-8859-1?q?suj=E8=E9=E8t?=
        Date: ...
        X-Mailer: iw.email
        <BLANKLINE>
        --===============...
        Content-Type: multipart/alternative; charset="iso-8859-1";
        boundary="...
        MIME-Version: 1.0
        <BLANKLINE>
        --===============...
        Content-Type: text/html; charset="iso-8859-1"
        MIME-Version: 1.0
        Content-Transfer-Encoding: quoted-printable
        <BLANKLINE>
        <html><body>
        corps du maiil avec caract=E8re unicode:
        utf-8: =E9 =E0 =EE =F6 =
        <BLANKLINE>
        cp552: - '
        </body></html>
        --===============...
        --===============...
        
        Ok, that's cool but sometimes we want to add images.
        So, just do it::
        
        >>> image = open(os.path.join(testdir, 'bullet.gif'))
        >>> image.read()
        'GIF89a\x05\x00\r\x00\x80\x00\x00c\x8c\x9c\xff\xff\xff!\xf9\x04\x01\x00\x00\x01\x00,\x00\x00\x00\x00\x05\x00\r\x00\x00\x02\t\x8c\x8f\xa9\xbb\xe0\x0f\xa3\x84\xa9\x00;'
        >>> image.seek(0)
        
        >>> mail.addImage(image, filename='bullet.gif', content_type='image/gif')
        >>> mail.images
        [<email.MIMEImage.MIMEImage instance at ...>]
        >>> print mail.images[0].as_string()
        Content-Type: image/gif; name="bullet.gif"
        MIME-Version: 1.0
        Content-Transfer-Encoding: base64
        Content-ID: <bullet.gif>
        <BLANKLINE>
        R0lGODlhBQANAIAAAGOMnP///yH5BAEAAAEALAAAAAAFAA0AAAIJjI+pu+APo4SpADs=
        
        CheetahMail
        -----------
        
        We can also use Cheetah template to generate an email::
        
        >>> from iw.email import CheetahMail
        
        Path is the path to the cheetah template::
        
        >>> path = os.path.join(testdir, 'mail.tmpl')
        
        We need a few arguments::
        
        >>> umail = unicode('''
        ... corps du maiil avec caractère unicode:
        ... utf-8: é à î ö
        ... cp552: \xe2\x80\x93 \xe2\x80\x99
        ... ''', 'utf-8')
        
        Then we can use the CheetahMail to generate an email from the template::
        
        >>> mail = CheetahMail(path=path,
        ...             title='nice title',
        ...             paragraph=umail,
        ...             mfrom='sender@ingeniweb.com',
        ...             mto='recipient@ingeniweb.com',
        ...             subject=unicode('sujèéèt','utf-8'))
        >>> server.sendmail('sender@ingeniweb.com','recipient@ingeniweb.com', mail)
        Content-Type: multipart/related; charset="iso-8859-1";
        ...
        To: recipient@ingeniweb.com
        From: sender@ingeniweb.com
        ...
        <body>
        <div class=3D"document" id=3D"nice-title">
        <h1 class=3D"title">nice title</h1>
        <p>corps du maiil avec caract=E8re unicode:
        iso-8859-1: =E9 =E0 =EE =F6
        cp552: - '</p>
        </div>
        </body>
        </html>
        <BLANKLINE>
        ...
        
        
        
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
