The cnotmuch module provides an interface to the notmuch functionality, directly interfacing with a shared notmuch library. Notmuch provides a maildatabase that allows for extremely quick searching and filtering of your email according to various criteria.
The documentation for the latest cnotmuch release can be viewed online.
The classes notmuch.Database, notmuch.Query provide most of the core functionality, returning notmuch.Messages and notmuch.Tags.
Installation and Deinstallation
cnotmuch is packaged on http://pypi.python.org. This means you can do "easy_install cnotmuch" (or using pip) on your linux box and it will get installed into:
For uninstalling, you will need to remove the "cnotmuch-0.1-py2.x.egg" directory and delete one entry refering to cnotmuch in the "easy-install.pth" file in that directory. There should be no trace left of cnotmuch then.
You need to have notmuch installed (or rather libnotmuch.so.1). The release version 0.1 should work fine. Also, cnotmuch makes use of the ctypes library, and has only been tested with python 2.5. It will not work on earlier python versions.