django-ogmios 0.9.3

Just sends email. Simple, easy, multiformat.

=============
Django-Ogmios
=============
.. image:: https://travis-ci.org/fusionbox/django-ogmios.svg?branch=master
:target: https://travis-ci.org/fusionbox/django-ogmios
:alt Build Status

Just sends emails. Simple, easy, multiformat.

For those wondering, [Ogmios](https://en.wikipedia.org/wiki/Ogmios) is just the Gallic god of eloquence.

Quickstart
==========

``yourproject/templates/mail/template.html``::

from: [e-mail]
to: Jane Doe <[e-mail]>, {% for u in users %}{{ user.email }}, {% endfor %}
cc: John Doe <[e-mail]>, {{ copy_user.get_full_name }} <{{ copy_user.email }}>
bcc: [e-mail], [e-mail]
subject: The whole email is a template
content-type: markdown
headers:
Reply-To: Jaqueline <[e-mail]>
Organization: Example.org, Inc.
attachements:
- /absolute/path/file.odt
- relative/path/file.ods
- {{ file.path }}
- ['awesomereport.odt', 'mydocuments/crappy_report.odt', 'application/vnd.oasis.opendocument.text-template']
---
{% load special_filter %}

This is a list of special items:

{% for item in item_list %}
* {{ item|special }}
{% endfor %}


.. code:: python

import ogmios

ogmios.send_email('mail/template.html', {'item_list': ['Hello']})


This will render the content as markdown, and send the email with an HTML part and a Plaintext part.

Tips
====

Resend an email with different context:

.. code:: python

import functools
import ogmios

from myapp.models import User

send_registration = functools.partial(ogmios.send, 'mail/template.html')
send_registration({'user': User.objects.get(pk=1337)})


Changelog
=========

0.9.3 (2015-08-27)
------------------

- Add Django 1.7 compatibility. [Alex Bliskovsky]


0.9.2 (2015-07-16)
------------------

- Fix ``setup.py`` dependencies. [Alex Bliskovsky]
- Fix tests. [Alex Bliskovsky]
- Fix compatibility with django's cached loader. [Alex Bliskovsky]
- Fix context processing. [Alex Bliskovsky]


0.9.1 (2015-06-22)
------------------

- Fix 'From' field always being default


0.9.0 (2015-06-18)
------------------

- Initial version