Welcome to the django-pony-express - class-based emails for Django shipping with a full test suite.

Similar to class-based view in Django core, this package provides a neat, DRY and testable (!) way to handle your emails in Django.

PyPI | GitHub | Full documentation

Creator & Maintainer: Ambient Digital

Features

• Class-based structure for emails
  • Avoid duplicate low-level setup
  • Utilise inheritance and OOP benefits
  • No duplicated templates for HTML and plain-text
• Test suite to write proper unit-tests for your emails
  • Access your test outbox like a Django queryset

Etymology

The Pony Express was an American express mail service that used relays of horse-mounted riders. [...] During its 18 months of operation, the Pony Express reduced the time for messages to travel between the east and west US coast to about 10 days.

https://en.wikipedia.org/wiki/Pony_Express

The name of this package combines the Django mascot (a pony) with a once quite successful mail service in the US. Ingenious, right?

Installation

• Install the package via pip:

  pip install django-pony-express

  or via uv:

  uv add django-pony-express

• Add module to INSTALLED_APPS within the main django settings.py:

INSTALLED_APPS = (
    # ...
    "django_pony_express",
)

Publish to ReadTheDocs.io

• Fetch the latest changes in GitHub mirror and push them
• Trigger new build at ReadTheDocs.io (follow instructions in admin panel at RTD) if the GitHub webhook is not yet set up.

Preparation and building

This package uses uv for dependency management and building.

• Update documentation about new/changed functionality

• Update the CHANGES.md

• Increment version in main __init__.py

• Create pull request / merge to "master"

• This project uses uv to publish to PyPI. This will create distribution files in the dist/ directory.

  uv build

Publishing to PyPI

To publish to the production PyPI:

uv publish

To publish to TestPyPI first (recommended for testing):

uv publish --publish-url https://test.pypi.org/legacy/

You can then test the installation from TestPyPI:

uv pip install --index-url https://test.pypi.org/simple/ ambient-package-update

Maintenance

Please note that this package supports the ambient-package-update. So you don't have to worry about the maintenance of this package. This updater is rendering all important configuration and setup files. It works similar to well-known updaters like pyupgrade or django-upgrade.

To run an update, refer to the documentation page of the "ambient-package-update".