notmuch/docs/source/index.rst

85 lines
2.3 KiB
ReStructuredText
Raw Normal View History

.. cnotmuch documentation master file, created by
sphinx-quickstart on Tue Feb 2 10:00:47 2010.
.. currentmodule:: cnotmuch.notmuch
Welcome to notmuch's documentation!
===================================
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`.
.. moduleauthor:: Sebastian Spaeth <Sebastian@SSpaeth.de>
:License: This module is covered under the GNU GPL v3 (or later).
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
.. toctree::
:maxdepth: 1
:mod:`notmuch` -- The Notmuch interface
=============================================
Document from cnotmuch.globals import nmlib,STATUS,NotmuchError
:class:`Database` -- The underlying notmuch database
-----------------------------------------------------
.. autoclass:: Database
:members:
:class:`Query` -- Represents a notmuch Query
-----------------------------------------------
.. autoclass:: Query
:members:
.. note:: A Thread is what a call to notmuch.show() will return, containing a bunch of :class:`Message`\ s.
:class:`Messages` -- A bunch of messages
----------------------------------------
.. autoclass:: Messages
:members:
:class:`Message` -- A single message
----------------------------------------
.. autoclass:: Message
:members:
:class:`Tags` -- A bunch of notmuch tags
----------------------------------------
.. autoclass:: Tags
: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`