Metadata-Version: 2.0
Name: django-email
Version: 0.1.8
Summary: Django Email Templates made easy
Home-page: https://github.com/swappsco/django-email
Author: Andres Gonzalez
Author-email: andresgz@gmail.com
License: MIT
Keywords: django-email
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5

=============================
Django Email
=============================

.. image:: https://badge.fury.io/py/django-email.png
    :target: https://badge.fury.io/py/django-email

.. image:: https://travis-ci.org/swappsco/django-email.png?branch=master
    :target: https://travis-ci.org/swappsco/django-email

Django Email Templates made easy

Current Version 0.1.8

Django email is a thin wrapper for django's multialternative email sending. For this you will need to specify a plain text template (.txt) and an html version (.html). Django email takes your template and your context, renders it and sends the email, reducing the boilerplate required for sending an email.

We try to use defaults that make sense, but you can always adapt things to your needs. You can setup the subject, email from, email to and more.

Your templates must not have extension, but other than that we assume nothing.


Quickstart
----------

Install Django Email::

    pip install django-email

Then use it in a project::

    from django_email import djemail

    # Simple Usage
    # Admin will receive a message
    djemail.send_mail(message="My Message", subject="The Subject")

    # Send an email to a specific email
    djemail.send_mail(
	    to="email@test.com",
	    message="My Message",
	    subject="The Subject")

    # Advanced Usage
    djemail.send_email(
        to="email@test.com",
        template_name="path/to/template", # .txt and/or .html
        context={'variable': 'Variable Content'},
        subject="My Subject"
    )


Features
--------

* Send easy email to ADMINS.
* Send TXT/HTML Email using a predefined template.
* Send Email using your own custom templates. 

Running Tests
--------------

Does the code actually work?

::

    source <YOURVIRTUALENV>/bin/activate
    (myenv) $ pip install -r requirements_test.txt
    (myenv) $ python runtests.py

Credits
---------

Tools used in rendering this package:

*  Cookiecutter_
*  `cookiecutter-djangopackage`_

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cookiecutter-djangopackage`: https://github.com/pydanny/cookiecutter-djangopackage




History
-------

0.1.0 (2015-11-26)
++++++++++++++++++

* First release.

0.1.1 (2016-07-01)
++++++++++++++++++

* Fix issue with app loading on django 1.9.

0.1.2 (2016-07-20)
++++++++++++++++++

* Implement method send_email().

0.1.3 (2016-07-22)
++++++++++++++++++

* Deprecate email Template class

0.1.4 (2016-07-22)
++++++++++++++++++

* Resolve issue with deprecated function

0.1.5 (2016-07-23)
++++++++++++++++++

* Restructure project with Cookiecutter Django Package.

0.1.6 (2016-07-23)
++++++++++++++++++

* Improve send_mail() method. Add Base templates and more modes to use.

0.1.7 (2016-08-01)
++++++++++++++++++

* Bug fix for default Email template, updates example and tests.

