The cnotmuch module provides *notmuch*, a python reimplementation of the standard notmuch binary for two purposes: first, to allow running the standard notmuch testsuite over the cnotmuch bindings (for correctness and performance testing) and second, to give some examples as to how to use cnotmuch. 'Notmuch' provides a command line interface to your mail database.
A standard install via `easy_install cnotmuch` will not install the notmuch binary, however it is available in the `cnotmuch source code repository <http://bitbucket.org/spaetz/cnotmuch/src/>`_.
It is invoked with the following pattern: `notmuch <command> [args...]`.
Where <command> and [args...] are as follows:
**setup** Interactively setup notmuch for first use.
This has not yet been implemented, and will probably not be
implemented unless someone puts in the effort.
**new** [--verbose]
Find and import new messages to the notmuch database.
This has not been implemented yet. We cheat by calling
the regular "notmuch" binary (which must be in your path
somewhere).
**search** [options...] <search-terms> [...] Search for messages matching the given search terms.
This has been implemented but for the `--format` and
