:License: This module is covered under the GNU GPL v3 (or later).
-This page contains the main API overview of notmuch |release|.
+This page contains the main API overview of notmuch |release|.
Notmuch can be imported as::
:maxdepth: 1
status_and_errors
- notmuch
+ notmuch
:mod:`notmuch` -- The Notmuch interface
=================================================
.. automodule:: notmuch
-:class:`notmuch.Database` -- The underlying notmuch database
+:class:`Database` -- The underlying notmuch database
---------------------------------------------------------------------
-.. autoclass:: notmuch.Database([path=None[, create=False[, mode=MODE.READ_ONLY]]])
+.. autoclass:: Database([path=None[, create=False[, mode=MODE.READ_ONLY]]])
.. automethod:: create
.. autoattribute:: db_p
-:class:`notmuch.Query` -- A search query
+:class:`Query` -- A search query
-------------------------------------------------
-.. autoclass:: notmuch.Query
+.. autoclass:: Query
.. automethod:: create
Sort by email message ID.
SORT.UNSORTED
- Do not apply a special sort order (returns results in document id
- order).
+ Do not apply a special sort order (returns results in document id
+ order).
.. automethod:: set_sort
.. automethod:: count_messages
+ .. automethod:: count_threads
+
:class:`Messages` -- A bunch of messages
----------------------------------------
.. method:: __len__()
.. warning::
-
+
:meth:`__len__` was removed in version 0.6 as it exhausted the iterator and broke
list(Messages()). Use the :meth:`Query.count_messages` function or use `len(list(msgs))`.
.. attribute:: FLAG
- FLAG.MATCH
+ FLAG.MATCH
This flag is automatically set by a
Query.search_threads on those messages that match the
query. This allows us to distinguish matches from the rest
.. automethod:: get_flag
.. automethod:: set_flag
-
+
.. automethod:: get_date
.. automethod:: get_header
.. automethod:: __str__
-:class:`notmuch.Threads` -- Threads iterator
+:class:`Threads` -- Threads iterator
-----------------------------------------------------
-.. autoclass:: notmuch.Threads
+.. autoclass:: Threads
.. automethod:: __len__
:class:`Filenames` -- An iterator over filenames
------------------------------------------------
-.. autoclass:: notmuch.database.Filenames
+.. autoclass:: Filenames
+
+ .. automethod:: Filenames.__len__
- .. automethod:: notmuch.database.Filenames.__len__
+ .. automethod:: Filenames.as_generator
-:class:`notmuch.database.Directoy` -- A directory entry in the database
+:class:`Directoy` -- A directory entry in the database
------------------------------------------------------------------------
-.. autoclass:: notmuch.database.Directory
+.. autoclass:: Directory
- .. automethod:: notmuch.database.Directory.get_child_files
+ .. automethod:: Directory.get_child_files
- .. automethod:: notmuch.database.Directory.get_child_directories
+ .. automethod:: Directory.get_child_directories
- .. automethod:: notmuch.database.Directory.get_mtime
+ .. automethod:: Directory.get_mtime
- .. automethod:: notmuch.database.Directory.set_mtime
+ .. automethod:: Directory.set_mtime
- .. autoattribute:: notmuch.database.Directory.mtime
+ .. autoattribute:: Directory.mtime
- .. autoattribute:: notmuch.database.Directory.path
+ .. autoattribute:: Directory.path
The `next page <status_and_errors.html>`_ contains information on possible Status and Error values.