X-Git-Url: https://git.notmuchmail.org/git?p=notmuch-wiki;a=blobdiff_plain;f=bindings.mdwn;h=9288c0ab1e3fc762271741a8014251f855420c49;hp=9352aba1d973051c1c818e634533c6782b201f4d;hb=refs%2Fheads%2Fmaster;hpb=6611b05db18c7cc1a0d39e80308e581501ac3829 diff --git a/bindings.mdwn b/bindings.mdwn index 9352aba..9288c0a 100644 --- a/bindings.mdwn +++ b/bindings.mdwn @@ -1,10 +1,11 @@ [[!img notmuch-logo.png alt="Notmuch logo" class="left"]] # Notmuch Language Bindings [DRAFT] -The Notmuch library, `libnotmuch`, can be used from many programming languages -using the Notmuch language bindings. The [[command line interface|manpages]] and -the [[email clients and frontends|frontends]] are based on the language -bindings. +The Notmuch library, `libnotmuch`, can be used from many programming +languages using the Notmuch language bindings. The [command line +interface](https://notmuchmail.org/doc/latest/man1/notmuch.html) and +the [[email clients and frontends|frontends]] are based on the +language bindings. [[!toc levels=2]] @@ -18,20 +19,19 @@ The Notmuch command-line interface is based on the C library. Notmuch includes Python bindings to the Notmuch shared library. Please refer to the nice and extensive [Notmuch Python API -documentation](http://notmuch.readthedocs.org/projects/notmuch-python/). +documentation](https://notmuchmail.org/doc/latest/python-bindings.html). The bindings are very simple to use. As an example, given you have the Python bindings installed (or simply set your PYTHONPATH environment variable to point to the .../bindings/python directory), this snippet will produce a list of mails matching the given expression: - >>> import notmuch - >>> db = notmuch.Database() - >>> query = db.create_query('tag:inbox AND NOT tag:killed') - >>> list(query.search_messages()) # doctest:+ELLIPSIS + >>> from notmuch2 import Database + >>> db = Database() + >>> messages = list(db.messages('tag:inbox AND NOT tag:killed')) [...] -[The source](https://git.notmuchmail.org/git/notmuch/tree/HEAD:/bindings/python/) +[The source](https://git.notmuchmail.org/git/notmuch/tree/HEAD:/bindings/python-cffi/) ## Ruby