X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=README;h=cdf9d7ae0aa7dea63b6e100a0a4d514e6c1335fc;hb=634b4fbe233ee9007d190327df11779fe2113fb8;hp=9caf32dc84f5965f38e87fb11bea980e5e0b7fd4;hpb=2dd0cf8f5bbf63c0e0a423344de95e9d433bf7af;p=notmuch diff --git a/README b/README index 9caf32dc..cdf9d7ae 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -cnotmuch -- The python interface to notmuch.so +notmuch -- The python interface to notmuch.so ============================================== This module makes the functionality of the notmuch library @@ -10,7 +10,7 @@ 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`_ +http://packages.python.org/cnotmuch/ The current source code is being hosted at http://bitbucket.org/spaetz/cnotmuch which also provides an issue @@ -21,13 +21,31 @@ 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: ->>>from cnotmuch import notmuch +>>>import notmuch >>>db = notmuch.Database("/home/spaetz/mail") db.get_path() '/home/spaetz/mail' @@ -52,3 +70,18 @@ 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