django-dramatiq-email 1.4.1

A Django email backend using Dramatiq to send emails using background workers

Django Dramatiq Email

Email backend for Django sending emails via Dramatiq.

This package is tested up to Django 4.2.

Installation

To enable django-dramatiq-email, modify your project settings.py:

• Add "django_dramatiq_email" to INSTALLED_APPS below "django_dramatiq",
• Set EMAIL_BACKEND to "django_dramatiq_email.backends.DramatiqEmailBackend",
• Set DRAMATIQ_EMAIL_BACKEND to the actual email backend you want to use (SMTP, Anymail, etc),
• Optionally, add the DRAMATIQ_EMAIL_TASK_CONFIG dict as shown below.

Configuration

The dramatiq.actor args (reference, user guide) for send_email can be set via the DRAMATIQ_EMAIL_TASK_CONFIG dict in your settings.py.

The default args are here - most notably, the default queue_name is django_email.

Example configuration (using the Retry middleware):

DRAMATIQ_EMAIL_TASK_CONFIG = {
    "max_retries": 20,
    "min_backoff": 15000,
    "max_backoff": 86400000,
    "queue_name": "my_custom_queue"
}

Bulk emails

Bulk emails are send using individual Dramatiq tasks. Doing so these tasks can be restarted individually.

Maintainer

Tim Drijvers