Skip to main content

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.

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distributions (8.6 kB view hashes)

Uploaded source

smtpdropbox-1.0.tar.gz (6.4 kB view hashes)

Uploaded source

smtpdropbox-1.0.tar.bz2 (6.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page