Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Pure-python library to capture emails into a dropbox

Project Description

Readme File for smtpdropbox

Smtpdropbox is a subclass of the smtpd module. It allows a user to set up an smtp daemon on a random port and send emails to it. When the daemon receives an email, it parses it and saves the parsed data structure to a file on the filesystem. This file is saved in JSON format (using the standard JSON library of Python) to help users easily recreate / use the data from the email.

Common uses for this module are for testing software that sends automated emails. If that software points to this smtp server, the emails can be trapped and parsed automatically, verifying that the email was sent and what is in the email.


This library does not save file attachments (yet). An enhancement would be to make it save any/all attachments as individual files, hopefully named the same as they were in the email.

Also, future work includes adding the ability to save the mail message received as a plain text file as well as a json file. it currently does not do so, though it hasn’t been done yet.


When instantiating this class, you specify the boxname (really, this is localhost or and port number to listen on, the boxname to forward messages to (as yet unimplemented), the names of the textfile and json file, and the number of messages to process before exiting (0=infinite).

The test has a complete example of usage.

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(6.6 kB) Copy SHA256 Hash SHA256
Source None Oct 31, 2011
(6.4 kB) Copy SHA256 Hash SHA256
Source None Oct 31, 2011
(8.6 kB) Copy SHA256 Hash SHA256
Source None Oct 31, 2011

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting