maildump

library1.1.1pypypi✓ verified 84d ago

An SMTP server that captures all received mails and exposes them via a web interface and REST API. Current version 1.1.1 (requires Python >=3.12). Released with irregular cadence.

communication http-networking web-framework

pip install maildump

github ↗package ↗

INSTALL

IMPORT

SIG · MAILDUMP

maildump

communicationpythonv1.1.1

Install

4.3s avg

Import

1305ms

Disk

50MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 4.6s

py 3.11

✓ —

✓ 4.3s

py 3.12

✓ —

✓ 4.1s

py 3.13

✓ —

✓ 4.2s

py 3.9

✕ build_error

50MB installed

● package 50MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

maildump

✓ import maildump

✗ from maildump import ...

maildump is a command-line tool; there's no public Python API to import. Use the CLI or REST API.

Start the SMTP server on port 1025 and the web interface on port 1080.

maildump --ip 127.0.0.1 --port 1025 --webport 1080

maildump --version

Debug

Known issues

gotchamaildump has no Python API; you cannot import it in your code. It runs as a standalone server.

fix

Use the CLI or the REST API to interact with maildump.

affects: all

gotchaThe web interface and REST API are separate from the SMTP server; ensure you start maildump with the correct ports.

fix

Run `maildump --help` to see all options for customizing ports and IP bindings.

affects: all

deprecatedPython <3.12 is no longer supported; older versions may fail to install or run.

fix

Upgrade to Python 3.12+.

affects: >=1.1

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'maildump'

Trying to import maildump in a Python script when it's only a CLI tool.

fix

Do not import maildump; run it as a command-line tool.

maildump: error: unrecognized arguments: --webport

Using an old version that doesn't support the --webport flag (added in v1.1).

fix

Upgrade to maildump v1.1 or later: `pip install --upgrade maildump`.

TypeError: required field 'id' missing from message

Sending malformed emails (e.g., missing Message-ID header).

fix

Ensure your SMTP client sends valid RFC 5322 emails with a Message-ID header.

Upgrade

Version history

1.1.1latest on PyPI · released Apr 15, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/ThiefMaster/maildump ↗

packagehttps://pypi.org/project/maildump/ ↗