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!

MailBot: execute callback on mail reception

Project Description

MailBot: register callbacks to be executed on mail reception.


Setup your environment:

git clone
cd mailbot

Hack and run the tests using Tox to test on all the supported python versions:

make test

There’s also a live test suite, that you may run using the following command:

make livetest

Please note that to run live tests, you need to create a file with the following content:

# mandatory
HOST = 'your host here'
USERNAME = 'your username here'
PASSWORD = 'your password here'

# optional
# check
PORT = 143  # port number, usually 143 or 993 if ssl is enabled
USE_UID = True
SSL = False
STREAM = False

For convenience, you can copy the provided sample, and modify it:

$ cp


0.3 (2013-03-28)

  • compatible python 3.3

0.2 (2013-03-28)

  • automatically decode headers, allowing for unicode subjects, senders, recipients, CCs and body
  • new timeout parameter: mails in the processing state for longer than this timeout will be reprocessed
  • use SEEN and FLAGGED to manage mail states (not processed, processing, processed)
  • captures from the rules’ regexps available in Callback.matches (previously, this was storing MatchObjects)

0.1 (2013-03-20)

  • first version

Release History

This version
History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(16.6 kB) Copy SHA256 Hash SHA256
2.7 Wheel Nov 14, 2013
(11.5 kB) Copy SHA256 Hash SHA256
Source Jul 28, 2013

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting