incuna-mail 4.1.1

Pythonic utility for sending template based emails with Django.

Incuna Mail

Pythonic utility for sending template based emails with Django.

Installation

Install the package:

pip install incuna_mail

Usage

Import the send function and call it:

from incuna_mail import send

send(
    to='[e-mail]',
    subject='Example email',
    template_name='plaintext_email.txt',
)

Supports cc and bcc...

send(
    to='[e-mail]',
    cc='[e-mail]',
    bcc='[e-mail]',
    ...
)

... lists of recipients...

send(
    to=['[e-mail]', '[e-mail]'],
    cc=['[e-mail]', '[e-mail]'],
    ...
)

... multi-part emails...

send(
    ...
    template_name='plaintext_email.txt',
    html_template_name='html_email.html',
)

... template context...

send(
    ...
    context={'user': user},
)

... template lists...

send(
    ...
    # Uses the first template found.
    template_name=['might-exist.html', 'will-exist.html'],
)

... reply-to addresses...

send(
    ...
    reply_to=['[e-mail]'],
)

... and custom email headers:

send(
    ...
    headers={'Extra-Header': 'This will appear among the email headers'}
)

The email sender can be set globally with settings.DEFAULT_FROM_EMAIL, and will default to settings.SERVER_EMAIL. It can be explicitly set on each call, if required:

send(
    ...
    sender='[e-mail]',
)