Skip to main content

Email History for Django Anymail

Project description

anymail-history - Email History (database storage) for Django Anymail

CI tests codecov Documentation MIT License

Keep history of all emails sent by Django Anymail


anymail-history implements database storage for Django Anymail.



  • Store sent emails
  • Store tracking events
  • Display Admin
  • html templating ?


  • Django >=3.2
  • Python >=3.8

How to

  1. Install Anymail

  2. Install

    $ pip install "django-anymail-history"
  3. Register anymail_history in your list of Django applications:

        # ...
        # ...
  4. Then migrate the app to create the database table migrate

  5. 🎉 Voila!


You can add settings to your project’s either as a single ANYMAIL dict, or by breaking out individual settings prefixed with ANYMAIL_. So this settings dict:

    "STORE_HTML": True,

…is equivalent to these individual settings:


Available settings

  • ANYMAIL_STORE_FAILED_SEND: (default: False) Store message even if esp didn't returned a message-id.
  • ANYMAIL_STORE_HTML: (default: False) Store html alternatives.



  • Simple for developers to get up-and-running
  • Consistent style (black, ruff)
  • Future-proof (pyupgrade)
  • Full type hinting (mypy)

Coding style

We use pre-commit to run code quality tools. Install pre-commit however you like (e.g. pip install pre-commit with your system python) then set up pre-commit to run every time you commit with:

> pre-commit install

You can then run all tools:

> pre-commit run --all-files

It includes the following:

  • poetry for dependency management
  • Ruff, black and pyupgrade linting
  • mypy for type checking
  • Github Actions for builds and CI

There are default config files for the linting and mypy.


Tests package

The package tests themselves are outside of the main library code, in a package that is itself a Django app (it contains models, settings, and any other artifacts required to run the tests (e.g. urls).) Where appropriate, this test app may be runnable as a Django project - so that developers can spin up the test app and see what admin screens look like, test migrations, etc.

Running tests

The tests themselves use pytest as the test runner. If you have installed the poetry evironment, you can run them thus:

$ poetry run pytest


$ poetry shell
(anymail-history-py3.10) $ pytest


  • .github/workflows/lint.yml: defines and ensure coding rules on Github.

  • .github/workflows/test.yml: Runs tests on all compatible combinations of Django (3.2+) & Anymail(8.4+), Python (3.8+)in a Github matrix.

  • .github/workflows/coverage.yml: Calculates the coverage on an up to date version.

Download files

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

Source Distribution

anymail_history-0.1.8.tar.gz (7.5 kB view hashes)

Uploaded source

Built Distribution

anymail_history-0.1.8-py3-none-any.whl (7.5 kB view hashes)

Uploaded py3

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