Metadata-Version: 2.0
Name: tctc-envelopes
Version: 0.5
Summary: Mailing for human beings
Home-page: http://tomekwojcik.github.io/envelopes/
Author: Tomasz Wójcik
Author-email: tomek@bthlabs.pl
License: https://github.com/tomekwojcik/envelopes/blob/master/LICENSE
Download-URL: http://github.com/tomekwojcik/envelopes/tarball/v0.5
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: build
Requires-Dist: yapf; extra == 'build'
Requires-Dist: pyflakes; extra == 'build'
Requires-Dist: nose; extra == 'build'
Requires-Dist: unittest2; extra == 'build'
Provides-Extra: docs
Requires-Dist: sphinx; extra == 'docs'

Envelopes
=========

.. image:: https://travis-ci.org/vamega/envelopes.svg?branch=master
    :target: https://travis-ci.org/vamega/envelopes

Mailing for human beings.

About
-----

Envelopes is a wrapper for Python's *email* and *smtplib* modules. It aims to
make working with outgoing e-mail in Python simple and fun.

Short example
-------------

.. sourcecode:: python

    from envelopes import Envelope, GMailSMTP

    envelope = Envelope(
        from_addr=(u'from@example.com', u'From Example'),
        to_addr=(u'to@example.com', u'To Example'),
        subject=u'Envelopes demo',
        text_body=u"I'm a helicopter!"
    )
    envelope.add_attachment('/Users/bilbo/Pictures/helicopter.jpg')

    # Send the envelope using an ad-hoc connection...
    envelope.send('smtp.googlemail.com', login='from@example.com',
                  password='password', tls=True)

    # Or send the envelope using a shared GMail connection...
    gmail = GMailSMTP('from@example.com', 'password')
    gmail.send(envelope)

Features
--------

Envelopes allows you to easily:

* Provide e-mail addresses with or without name part.
* Set text, HTML or both bodies according to your needs.
* Provide any number of CC and BCC addresses.
* Set standard (e.g. ``Reply-To``) and custom (e.g. ``X-Mailer``) headers.
* Attach files of any kind without hassle.
* Use any charset natively supported by Python's *unicode* type in addresses,
  bodies, headers and attachment file names.

Project status
--------------

This project should be considered **beta**. Proceed with caution if you decide
to use Envelopes in production.

Envelopes has been developed and tested with Python 2.7. Currently, Envelopes
supports Python 2.6, 2.7 and 3.3+.

Author
------

Envelopes is developed by `Tomasz Wójcik <http://www.bthlabs.pl/>`_.

License
-------

Envelopes is licensed under the MIT License.

Source code and issues
----------------------

Source code is available on GitHub at:
`tomekwojcik/envelopes <https://github.com/tomekwojcik/envelopes>`_.

To file issue reports and feature requests use the project's issue tracker on
GitHub.


