Send templated emails containing HTML, plain text, or both. The function is a thin wrapper around Django's send_mail function that loads the email content from a template.

Example::

from email_utils import send_email


send_email(
    context={'foo': 'bar'},
    from_email='no-reply@myproject.com',
    recipient_list=['test@example.com'],
    subject='My Templated Email',
    template_name='myapp/template',
)

Parameters

template_name The base name of the templates to use. The function then looks for the templates {template_name}.html and {template_name}.txt.

context The context used to render the templates. Defaults to an empty dictionary.

**kwargs Additional keyword arguments to pass to Django's send_mail function.

Raises

email_utils.NoTemplatesException If neither the HTML nor plain text templates are found.

Testing

Tests are run using pytest. To run the tests, install the requirements and then execute the tests::

pip install -r requirements/test.txt
pytest

License

This project is licensed under the MIT License.

Authors

Chathan Driehuys (chathan@driehuys.com)

FAQs

What is django-email-utils?

Is django-email-utils well maintained?

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install