Skip to main content

Email utilities

Project description

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>
...

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

iw.email-0.2.1-py2.4.egg (22.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page