.. cnotmuch documentation master file, created by
sphinx-quickstart on Tue Feb 2 10:00:47 2010.
-.. currentmodule:: cnotmuch.notmuch
+.. currentmodule:: cnotmuch
-Welcome to notmuch's documentation!
-===================================
+Welcome to :mod:`cnotmuch`'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`.
+The classes :class:`notmuch.Database`, :class:`notmuch.Query` provide most of the core functionality, returning :class:`notmuch.Messages` and :class:`notmuch.Tags`.
.. moduleauthor:: Sebastian Spaeth <Sebastian@SSpaeth.de>
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:
+Notmuch can be imported as::
from cnotmuch import notmuch
-or:
+or::
from cnotmuch.notmuch import Query,Database
:maxdepth: 1
-
:mod:`notmuch` -- The Notmuch interface
=============================================
-Document from cnotmuch.globals import nmlib,STATUS
+.. automodule:: cnotmuch.notmuch
+
+:todo: Document nmlib,STATUS
:class:`Database` -- The underlying notmuch database
-----------------------------------------------------
Defines constants that are used as the mode in which to open a database.
- READ_ONLY
+ MODE.READ_ONLY
Open the database in read-only mode
- READ_WRITE
+ MODE.READ_WRITE
Open the database in read-write mode
.. autoattribute:: db_p
-:class:`Query` -- Represents a notmuch Query
+:class:`Query` -- A search query
-----------------------------------------------
.. autoclass:: Query
- :members:
+
+ .. automethod:: create
+
+ .. attribute:: Query.SORT
+
+ Defines constants that are used as the mode in which to open a database.
+
+ SORT.OLDEST_FIRST
+ Sort by message date, oldest first.
+
+ SORT.NEWEST_FIRST
+ Sort by message date, newest first.
+
+ SORT.MESSAGE_ID
+ Sort by email message ID
+
+ .. automethod:: set_sort
+
+ .. automethod:: search_messages
:class:`Messages` -- A bunch of messages
----------------------------------------
.. autoclass:: Messages
- :members:
+
+ .. automethod:: collect_tags
+
+ .. automethod:: __len__
:class:`Message` -- A single message
----------------------------------------
.. autoclass:: Message
:members:
-:class:`Tags` -- A bunch of notmuch tags
-----------------------------------------
+:class:`Tags` -- Notmuch tags
+-----------------------------
.. autoclass:: Tags
:members:
- .. data: '__notmuchcmd__'
+ .. automethod:: __len__
- 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.
+ .. automethod:: __str__
:exc:`NotmuchError` -- A Notmuch execution error
------------------------------------------------