Search the Mailman email archives with Django
Switch branches/tags
Nothing to show
Clone or download
Failed to load latest commit information.
archive/files Initial import Apr 12, 2014
django_mailman_search Initial import Apr 12, 2014
emails Initial import Apr 12, 2014
templates Initial import Apr 12, 2014
.gitignore Initial import Apr 12, 2014
LICENSE Initial commit Apr 12, 2014 Added more info and TODOs Apr 13, 2014 Initial import Apr 12, 2014
pip_requirements.txt Initial import Apr 12, 2014


A Django project to search the Mailman email archives.


Install the Python/Django dependencies as

pip install pip_requirements.txt

followed by

python syncdb

to create the database.


  • The landing page can be accessed at /emails/ where you can search by your keyword(s).
  • The query search is sent to /search/ where the search results are displayed
  • Details of a particular search result (i.e., a specific email) can be viewed at /emails/id/

The HTML templates have been kept minimum so that the essential code for searching and display can be easily understood.

Indexing the archives

Two management commands are provided -- load_archive and clear_archive. The former parses the email archives and loads the corresponding entries into the database. The latter one removes all existing records from the database. The Django app emails handles these.

To load email archives into the database:

python load_archive

This should be done before the first use and every time you have some new archive. Note that the archive files are not automagically downloaded -- you should ensure that those files are stored at the archive/files/ directory. If you change this location, update the script accordingly.

Currently, a few emails (and references) could not be loaded into the database due to some malformed attributes including, but not limited to, email address. However, this would be a very low percentage.

To build the index:

python rebuild_index

To update the index:

python update_index

For advanced users

The file defines two models -- Email and References. The former abstracts an email together with its contents. However, in a mailing list, one can reply to an email, which can be further replied to. Such emails refer to the previous emails by their message IDs.

Additionally, such emails also have a Reply to field, which, however, is not handled currently.


  • Display an entire email chain
  • Add test cases