2010-03-16 20:54:43 +01:00
.. cnotmuch documentation master file, created by
2010-03-16 20:36:04 +01:00
sphinx-quickstart on Tue Feb 2 10:00:47 2010.
2010-03-16 20:54:43 +01:00
.. currentmodule :: cnotmuch.notmuch
2010-03-16 20:36:04 +01:00
Welcome to notmuch's documentation!
===================================
2010-03-16 20:54:43 +01:00
The :mod: `cnotmuch` module provides an interface to the `notmuch <http://notmuchmail.org> `_ functionality, directly interfacing to a shared notmuch library.
The classes :class: `Database` , :class: `Query` provide most of the core functionality, returning :class: `Messages` and :class: `Tags` .
2010-03-16 20:36:04 +01:00
.. moduleauthor :: Sebastian Spaeth <Sebastian@SSpaeth.de>
2010-03-16 20:54:43 +01:00
:License: This module is covered under the GNU GPL v3 (or later).
2010-03-16 20:36:04 +01:00
2010-03-16 20:54:43 +01:00
This page contains the main API overview. More information on specific topics can be found on the following pages: (none here yet)
Notmuch can be imported as:
from cnotmuch import notmuch
or:
from cnotmuch.notmuch import Query,Database
2010-03-16 20:36:04 +01:00
.. toctree ::
:maxdepth: 1
:mod: `notmuch` -- The Notmuch interface
=============================================
2010-03-16 20:54:43 +01:00
Document from cnotmuch.globals import nmlib,STATUS,NotmuchError
2010-03-16 20:36:04 +01:00
2010-03-16 20:54:43 +01:00
:class: `Database` -- The underlying notmuch database
-----------------------------------------------------
.. autoclass :: Database
2010-03-16 20:36:04 +01:00
:members:
2010-03-16 20:54:43 +01:00
:class: `Query` -- Represents a notmuch Query
2010-03-16 20:36:04 +01:00
-----------------------------------------------
2010-03-16 20:54:43 +01:00
.. autoclass :: Query
2010-03-16 20:36:04 +01:00
:members:
.. note :: A Thread is what a call to notmuch.show() will return, containing a bunch of :class: `Message` \ s.
2010-03-16 20:54:43 +01:00
:class: `Messages` -- A bunch of messages
----------------------------------------
.. autoclass :: Messages
:members:
:class: `Message` -- A single message
----------------------------------------
.. autoclass :: Message
:members:
:class: `Tags` -- A bunch of notmuch tags
----------------------------------------
2010-03-16 20:36:04 +01:00
2010-03-16 20:54:43 +01:00
.. autoclass :: Tags
2010-03-16 20:36:04 +01:00
:members:
.. data: '__notmuchcmd__'
This is the actual binary that will be executed in order to run a notmuch command. This is set to *notmuch* and should usually not be changed.
:exc: `NotmuchError` -- A Notmuch execution error
------------------------------------------------
.. autoexception :: NotmuchError
:members:
This execption inherits directly from :exc: `Exception` and is raised on errors during the notmuch execution.
Indices and tables
==================
* :ref: `genindex`
* :ref: `search`