mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-11-26 20:57:58 +01:00
2dd0cf8f5b
Rather than hardcoding the version in various places, we export it from the module itself. Also improve the README somewhat.
54 lines
1.9 KiB
Text
54 lines
1.9 KiB
Text
cnotmuch -- The python interface to notmuch.so
|
|
==============================================
|
|
|
|
This module makes the functionality of the notmuch library
|
|
(`http://notmuchmail.org`_) available to python. Successful import of
|
|
this modul depends on a libnotmuch.so|dll being available on the
|
|
user's system.
|
|
|
|
If you have downloaded the full source tarball, you can create the
|
|
documentation with sphinx installed, go to the docs directory and
|
|
"make html". A static version of the documentation is available at:
|
|
|
|
`http://spaetz.bitbucket.org`_
|
|
|
|
The current source code is being hosted at
|
|
http://bitbucket.org/spaetz/cnotmuch which also provides an issue
|
|
tracker, and release downloads. This package is tracked by the python
|
|
package index repository at `http://pypi.python.org/pypi/cnotmuch`_ and can thus be installed on a user's computer easily via "sudo easy_install cnotmuch" (you will still need to install the notmuch shared library separately as it is not included in this package).
|
|
|
|
The original source has been provided by (c)Sebastian Spaeth, 2010.
|
|
All code is available under the GNU GPLv3+ (see docs/COPYING) unless specified otherwise.
|
|
|
|
|
|
Usage
|
|
-----
|
|
For more examples of how to use the cnotmuch interface, have a look at the
|
|
notmuch "binary" and the generated documentation.
|
|
|
|
Example session:
|
|
>>>from cnotmuch import notmuch
|
|
>>>db = notmuch.Database("/home/spaetz/mail")
|
|
db.get_path()
|
|
'/home/spaetz/mail'
|
|
>>>tags = db.get_all_tags()
|
|
>>>for tag in tags:
|
|
>>> print tag
|
|
inbox
|
|
...
|
|
maildir::draft
|
|
#---------------------------------------------
|
|
|
|
q = notmuch.Query(db,'from:Sebastian')
|
|
count = len(q.search_messages())
|
|
1300
|
|
|
|
#---------------------------------------------
|
|
|
|
>>>db = notmuch.Database("/home/spaetz/mailHAHA")
|
|
NotmuchError: Could not open the specified database
|
|
|
|
#---------------------------------------------
|
|
|
|
>>>tags = notmuch.Database("/home/spaetz/mail").get_all_tags()
|
|
>>>del(tags)
|