django-naomi

What it is and what it does

django-naomi replaces Django's default email backend to capture outgoing emails and serve them as viewable messages in your web browser instead of sending them through SMTP. This is designed for development environments where you want to inspect email content without a working mail server or to debug message formatting. Emails are stored as files in a configurable temporary directory, and attachments are displayed as links.

The package requires only Django and a writable directory on disk; it has no external runtime dependencies. Setup involves adding 'naomi' to INSTALLED_APPS, setting EMAIL_BACKEND to the NaomiBackend class, and specifying an EMAIL_FILE_PATH directory. Once configured, every email your Django application sends is intercepted and made available for inspection in the browser instead of being transmitted.

Use it for:

• Debug email formatting and content during local development without access to a working SMTP server.
• Preview transactional emails (password resets, confirmations, notifications) before they reach users.
• Inspect email attachments and verify they are generated correctly without sending test messages.
• Develop and test email-heavy features in isolated environments where external mail services are unavailable.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

django-naomi is a Django email backend that intercepts outgoing emails and displays them in your web browser instead of sending them via SMTP, useful for development and debugging.

No. The package is abandoned (last release 2015-08-15, last commit 2019-12-12) and targets obsolete Python versions (2.6–3.4). Compatibility with modern Django and Python is unverified. For current projects, use actively maintained alternatives.

Install

django-naomi on PyPI

pip install django-naomi

uv add django-naomi

poetry add django-naomi

Installing django-naomi

Before you install

Installation is straightforward with no runtime dependencies, but the package is abandoned—last release was 2015-08-15 and last commit 2019-12-12. It targets Python 2.6–3.4, versions now obsolete.

License in practice

MIT license is permissive and poses no restrictions on use, modification, or distribution.

Quickstart

pip install django-naomi

Add to Django settings:
INSTALLED_APPS += ('naomi',)
EMAIL_BACKEND = "naomi.mail.backends.naomi.NaomiBackend"
EMAIL_FILE_PATH = "/path/to/writable/dir"

EMAIL_FILE_PATH directory must be writable; compatibility with modern Django and Python versions is unverified.

Verify before relying

• Compatibility with modern Django versions (3.x, 4.x, 5.x) and current Python releases.
• Whether the browser preview interface works with current web standards and browsers.
• Current maintainer status and whether pull requests or issues are being reviewed.

Package facts

Evidence: django_naomi-0.8-py2.py3-none-any.whl

Keywords: django, email

Tags

More Build Tools packages