Skip to main content

A reusable Django application and EmailBackend that allows email configuration to be changed while the server is running.

Project description

image1 image2 image3 image4

A reusable Django application, admin panel, and EmailBackend that allows email configuration to be changed while the server is running. The goal of the project is to be the absolute easiest way to get email configured across multiple environments.

image5

Quickstart

  • Install Django Dynamic Email Settings:

    $ pip install django-des
  • Add it to your `INSTALLED_APPS`:

    INSTALLED_APPS = (
        ...
        'des',
        ...
    )
  • Add the dynamic email configuration email backend to settings.py

    EMAIL_BACKEND = 'des.backends.ConfiguredEmailBackend'
  • Run manage.py migrate des

  • To enable test email support, add Django DES’s URL patterns:

    from des import urls as des_urls
    
    
    urlpatterns = [
        ...
        url(r'^django-des/', include(des_urls)),
    ]

Settings

  • DES_TEST_SUBJECT: Set to override the default test email subject line. (Default: "Test Email")

    Example:

    DES_TEST_SUBJECT = "My New Subject"
  • DES_TEST_TEXT_TEMPLATE: Set to override the template used for text test emails. Note that this is a template file location, not a template string. (Default: "des/test_email.txt")

    Example:

    DES_TEST_TEXT_TEMPLATE = "myapp/email/test_email.txt"
  • DES_TEST_HTML_TEMPLATE: Set to enable HTML emails and use the template provided as the text/html content. (Default: None)

    Example:

    DES_TEST_HTML_TEMPLATE = "myapp/email/test_email.html"

Features

  • Configure email on the fly, no need to restart the server

  • Send test emails from the Django Admin panel

  • Test text and HTML email sending

  • Supports third party mail packages like django-mailer

Support

Python

  • 2.7

  • 3.4

  • 3.5

  • 3.6

Django

  • 1.8

  • 1.9

  • 1.10

  • 1.11

  • 2.0

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install -r requirements_dev.txt
(myenv) $ pip install -r requirements_test.txt
(myenv) $ tox

Credits

Tools used in rendering this package:

History

0.1.0 (2017-12-06)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-des-2.4.1.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

django_des-2.4.1-py2.py3-none-any.whl (11.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-des-2.4.1.tar.gz.

File metadata

  • Download URL: django-des-2.4.1.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-des-2.4.1.tar.gz
Algorithm Hash digest
SHA256 3b8611c4367bfee8216b424d428040ba3b1492773c32d7ba63b38a35a13ce1ff
MD5 57330d00090c6aad545c438de30b436c
BLAKE2b-256 3792a52ac66fd4aa470069da26306e2d6ca9e75db3186d07f31c7a541c8ebc9e

See more details on using hashes here.

File details

Details for the file django_des-2.4.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_des-2.4.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 7e8a5d109e62a72451b6f298f232a483fd1bbd78126127fb48177822559ac6c9
MD5 a12b4a72bf53a3ae49aaf5639e978dbe
BLAKE2b-256 634edd69434f72ba3e336f9097998b92fc4b1b1fb18f74e3a5486988b06b096b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page