{"id":24003,"library":"maildump","title":"maildump","description":"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.","status":"active","version":"1.1.1","language":"python","source_language":"en","source_url":"https://github.com/ThiefMaster/maildump","tags":["smtp","testing","email","web-interface","rest-api","development-tools"],"install":[{"cmd":"pip install maildump","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"maildump is a command-line tool; there's no public Python API to import. Use the CLI or REST API.","wrong":"from maildump import ...","symbol":"maildump","correct":"import maildump"}],"quickstart":{"code":"maildump --ip 127.0.0.1 --port 1025 --webport 1080","lang":"bash","description":"Start the SMTP server on port 1025 and the web interface on port 1080."},"warnings":[{"fix":"Use the CLI or the REST API to interact with maildump.","message":"maildump has no Python API; you cannot import it in your code. It runs as a standalone server.","severity":"gotcha","affected_versions":"all"},{"fix":"Run `maildump --help` to see all options for customizing ports and IP bindings.","message":"The web interface and REST API are separate from the SMTP server; ensure you start maildump with the correct ports.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade to Python 3.12+.","message":"Python <3.12 is no longer supported; older versions may fail to install or run.","severity":"deprecated","affected_versions":">=1.1"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Do not import maildump; run it as a command-line tool.","cause":"Trying to import maildump in a Python script when it's only a CLI tool.","error":"ModuleNotFoundError: No module named 'maildump'"},{"fix":"Upgrade to maildump v1.1 or later: `pip install --upgrade maildump`.","cause":"Using an old version that doesn't support the --webport flag (added in v1.1).","error":"maildump: error: unrecognized arguments: --webport"},{"fix":"Ensure your SMTP client sends valid RFC 5322 emails with a Message-ID header.","cause":"Sending malformed emails (e.g., missing Message-ID header).","error":"TypeError: required field 'id' missing from message"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}