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: Beyonder Deutschland
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.
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-expressor via uv:
uv add django-pony-express -
Add module to
INSTALLED_APPSwithin the main djangosettings.py:
INSTALLED_APPS = (
# ...
"django_pony_express",
)
Releasing a new version
Releases are fully automated. Push a version tag and the pipeline will build, sign with Sigstore, publish to PyPI via Trusted Publishing, and create a GitHub Release — no API tokens needed.
git tag v<version> # e.g. git tag v1.2.3
git push origin v<version>
Tags must start with v. Tags without the prefix won't trigger the pipeline.
First-time setup
Before the pipeline can run for the first time, an admin must:
-
Create GitHub Environment
pypi- Go to Settings → Environments → New environment, name it exactly
pypi - Under Deployment branches and tags, add a tag rule with pattern
v* - Optionally add required reviewers for a manual approval gate
- Go to Settings → Environments → New environment, name it exactly
-
Configure PyPI Trusted Publisher
- Go to PyPI → Project settings → Publishing → Add a new publisher
- Fill in: Owner
ambient-innovation, Repositorydjango-pony-express, Workflowrelease.yml, Environmentpypi
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.
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".
2 maintainers
Release files for django-pony-express 3.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django_pony_express-3.2.0.tar.gz | 119.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| django_pony_express-3.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 136.0 kB
Release files / django_pony_express-3.2.0.tar.gz
| Download URL | django_pony_express-3.2.0.tar.gz |
|---|---|
| Size | 119.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a6bc7c6a05aba499214b4bee3391ec33ce70b3c71387b4ba5877a621148fde92
|
|
BLAKE2b-256 checksum How to use checksums |
1736b321575fb26be1943400fe94fbf5ae388a74808d3dd821dce4d8d44a954d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency logRelease files / django_pony_express-3.2.0-py3-none-any.whl
| Download URL | django_pony_express-3.2.0-py3-none-any.whl |
|---|---|
| Size | 16.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8e199e29191c93b6a60fe8b9ded0dc3ff0fabcbf829d5ced877630ea98bf1f01
|
|
BLAKE2b-256 checksum How to use checksums |
ad37903a3e7dc16609157ffca90c2cbdec8e2464fdcf34f6c0dd307eba364944
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency log
