X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=bindings%2Fpython%2FREADME;h=fe7a21819d67f3ad0be98573675e998971c7f834;hp=cdf9d7ae0aa7dea63b6e100a0a4d514e6c1335fc;hb=08c67317615efba11cd3f79dc7393be0c1c430a1;hpb=8cbb5114a20c1217f23977fd5edca99a0b7a2955 diff --git a/bindings/python/README b/bindings/python/README index cdf9d7ae..fe7a2181 100644 --- a/bindings/python/README +++ b/bindings/python/README @@ -1,8 +1,8 @@ -notmuch -- The python interface to notmuch.so -============================================== +notmuch -- The python interface to notmuch +========================================== This module makes the functionality of the notmuch library -(`http://notmuchmail.org`_) available to python. Successful import of +(`https://notmuchmail.org`_) available to python. Successful import of this modul depends on a libnotmuch.so|dll being available on the user's system. @@ -10,78 +10,8 @@ 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://packages.python.org/cnotmuch/ + https://notmuch.readthedocs.io/projects/notmuch-python/ -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). +To build the python bindings, do -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. - - -INSTALLATION & DEINSTALL ------------------------- - -cnotmuch is available on pypi.python.org. This means you can do -"easy_install cnotmuch" on your linux box and it will get installed -into: - -/usr/local/lib/python2.x/dist-packages/ - -For uninstalling, you'll need to remove the "cnotmuch-0.1-py2.x.egg" -directory and delete one entry in the "easy-install.pth" file in that -directory. - -It needs to have a libnotmuch.so or libnotmuch.so.1 available in some -library folder or will raise an exception when loading. -"OSError: libnotmuch.so.1: cannot open shared object file: No such file or directory" - - -Usage ------ -For more examples of how to use the cnotmuch interface, have a look at the -notmuch "binary" and the generated documentation. - -Example session: ->>>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) - - -Building for a Debian package ------------------------------- -dpkg-buildpackage -i"\.hg|\/build" - - -Changelog ---------- -0.1 First public release -0.1.1 Fixed Database.create_query() -0.2.0 Implemented Thread() and Threads() methods -0.2.1 Implemented the remaining API methods, notably Directory() and Filenames() -0.2.2 Bug fixes -0.3.0 Incorporated in the notmuchmail.org git repository \ No newline at end of file + python setup.py install --prefix=path/to/your/preferred/location