https://github.com/tomekwojcik/envelopes

Mailing for human beings
https://github.com/tomekwojcik/envelopes

Last synced: 3 days ago
JSON representation

Mailing for human beings

• Host: GitHub
• URL: https://github.com/tomekwojcik/envelopes
• Owner: tomekwojcik
• License: mit
• Created: 2013-08-06T15:04:04.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2019-03-07T15:28:44.000Z (over 5 years ago)
• Last Synced: 2024-09-15T01:46:57.237Z (about 2 months ago)
• Language: Python
• Homepage: http://tomekwojcik.github.io/envelopes/
• Size: 482 KB
• Stars: 590
• Watchers: 21
• Forks: 57
• Open Issues: 23
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE

Awesome Lists containing this project

• starred-awesome - envelopes - Mailing for human beings (Python)

README

        
Envelopes

=========

.. image:: https://travis-ci.org/tomekwojcik/envelopes.png?branch=master

    :target: https://travis-ci.org/tomekwojcik/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'[email protected]', u'From Example'),

        to_addr=(u'[email protected]', 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='[email protected]',

                  password='password', tls=True)

    # Or send the envelope using a shared GMail connection...

    gmail = GMailSMTP('[email protected]', '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 `_.

License

-------

Envelopes is licensed under the MIT License.

Source code and issues

----------------------

Source code is available on GitHub at:

`tomekwojcik/envelopes `_.

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

GitHub.