Re: Tcl bindings for notmuch
authorEric J <eric@deptj.eu>
Tue, 1 Mar 2016 18:34:40 +0000 (19:34 +0100)
committerW. Trevor King <wking@tremily.us>
Sat, 20 Aug 2016 23:21:13 +0000 (16:21 -0700)
18/fa223e3a1e945d9bf64655cc8ef2503fe4403e [new file with mode: 0644]

diff --git a/18/fa223e3a1e945d9bf64655cc8ef2503fe4403e b/18/fa223e3a1e945d9bf64655cc8ef2503fe4403e
new file mode 100644 (file)
index 0000000..3700872
--- /dev/null
@@ -0,0 +1,138 @@
+Return-Path: <eric@deptj.eu>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+ by arlo.cworth.org (Postfix) with ESMTP id 7F1846DE103A\r
+ for <notmuch@notmuchmail.org>; Tue,  1 Mar 2016 10:35:38 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at cworth.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0.092\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0.092 tagged_above=-999 required=5 tests=[AWL=0.002, \r
+ DKIM_SIGNED=0.1, RCVD_IN_DNSWL_NONE=-0.0001,\r
+ RCVD_IN_MSPIKE_H3=-0.01, \r
+ RCVD_IN_MSPIKE_WL=-0.01, T_DKIM_INVALID=0.01] autolearn=disabled\r
+Received: from arlo.cworth.org ([127.0.0.1])\r
+ by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
+ with ESMTP id lcNpAVgW1xPx for <notmuch@notmuchmail.org>;\r
+ Tue,  1 Mar 2016 10:35:35 -0800 (PST)\r
+Received: from mx1.solardns.com (mx1.solardns.com [109.73.127.119])\r
+ by arlo.cworth.org (Postfix) with ESMTPS id 52F656DE00DF\r
+ for <notmuch@notmuchmail.org>; Tue,  1 Mar 2016 10:35:34 -0800 (PST)\r
+Received: from [213.129.84.218] (helo=luna.solardns.com)\r
+ by mx1.solardns.com with esmtps (TLSv1.2:DHE-RSA-AES256-SHA:256)\r
+ (Exim 4.85) (envelope-from <eric@deptj.eu>) id 1aap8k-0007pL-W9\r
+ for notmuch@notmuchmail.org; Tue, 01 Mar 2016 18:35:30 +0000\r
+DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=deptj.eu;\r
+ s=default; h=Date:Message-ID:References:In-Reply-To:To:Subject:From;\r
+ bh=cX/TxD4F1eJXciRcUZem+xKwjBFSallgNy2EO8+pES4=; b=Ax6UCrWm/r6nlYcrXtvd/xJWUK\r
+ nr02lLQORD0o2sRLK2sLewblP2lBCAI9h6I30AvYo2sC0HCRx3TPM6mbPwamWMW6khar9lKvxkH3D\r
+ zf02bnJjxCPc+AlUiEClUsTX9F5711Zmlz6t67oiK/BvwwhNE0mLrmM5PyKpbFDIg39Y=;\r
+Received: from [2.12.196.83] (port=51853 helo=bruno.deptj.eu)\r
+ by luna.solardns.com with esmtpsa (TLSv1.2:DHE-RSA-AES256-GCM-SHA384:256)\r
+ (Exim 4.86) (envelope-from <eric@deptj.eu>) id 1aap8k-000X9f-Ea\r
+ for notmuch@notmuchmail.org; Tue, 01 Mar 2016 18:35:22 +0000\r
+Received: from eric by bruno.deptj.eu with local (Exim 4.84)\r
+ (envelope-from <eric@deptj.eu>) id 1aap8j-000315-Np\r
+ for notmuch@notmuchmail.org; Tue, 01 Mar 2016 19:35:21 +0100\r
+From: Eric J <eric@deptj.eu>\r
+Subject: Re: Tcl bindings for notmuch\r
+To: notmuch@notmuchmail.org\r
+In-Reply-To: <0379758d60f150aa79777a12361b036358b8d949-NM@bruno.deptj.eu>\r
+References: <0379758d60f150aa79777a12361b036358b8d949-NM@bruno.deptj.eu>\r
+Message-ID: <49bd0126ca982aba70990f1e1526aaac384b620e-NM@bruno.deptj.eu>\r
+Date: Tue, 01 Mar 2016 19:34:40 +0100 (CET)\r
+X-AuthUser: deptjeu\r
+X-Filter-ID:\r
+ s0sct1PQhAABKnZB5plbIZxxbsbMXbbOVqDrOlLQDPCKLoLP9dSDpksiPa3sfcfQiw3bi2TEXpBy\r
+ KOgMDJLxZ2gLr13hkJnqYlE8dI2PqoFC/lGsrXcsS0xY0J18f6o7xB66CWvXcfKDfXjTU++u62Tf\r
+ 3IaijxFCsl1Acjok/mtg3GKfo28I/znarUMoy/Q1ZuM7jUXIESohoO51xWmU8U0XxLGz4gGrl7np\r
+ YUMMsx7Zx6js8RMGZ+eyCM03IideZE/8G6RrW+hPYRmHOym9VEp4OmAp9SwcFw57ijAOXur1H/aA\r
+ warQpYDOYx/6JtUOKIpz/KyJk6xidDbrtJGeIvwS+mRNB2u5eXMTyiRDCl4blv/7/GYDGL6pBAPx\r
+ 3RhxuHrpSpJU4PQlqFj9797wgsGhIeDBws4kvu4hgViYIJSOH7FelTFEA57OugCjQqJvq5XDlSi1\r
+ S/CAqp6x6giLUpAadaOpLL7vzAlHz9Vt0lJbH3q7FSJEAvmcpRDg+DcXMCx8qKfWo/2nfeswSb/v\r
+ XOidX4Ts4xdG+C13IyWeZaJClvAWyUAUCSYHhmge3quet8geXjZWRvaT/RbJ/nX/IFFm7SbdEzck\r
+ 901Ob2Iq9tC/Vh1lis0iI/S1HLwoHXf0\r
+X-Report-Abuse-To: spam@mx1.solardns.com\r
+X-Filter-Fingerprint:\r
+ IFrWXGses7OKB5S5G8/dJdIz5bb8V0ykx8BnFBnunHBA3cTUQ1R++keuE7RDJ8Kg3RbMLUalw1oC\r
+ mj99/u+Poh38tEMU4IgC4sNz49qn3HHnhRv/ZJ3kEy8bfiAr+Fb/UpndEJ0YoaLytXXo8BMTaVt0\r
+ ARHRi6XGuAluI1udprGClI6bm+u9ssQgM5AHe3Zacv4uJct5wtJvPpZ2dlBHCwDSxr3Vz+LJ/RhM\r
+ 2JZ0ECN5dnq47RWft7iCyM9+PbHelB4qP9S6mTzNwoPraFy6ieiDqMHb2a0eZvGOvr7RaxKWGCKO\r
+ us9nABr0Pk/4CplP\r
+X-Originating-IP: 213.129.84.218\r
+X-SpamExperts-Domain: out.solardns.com\r
+X-SpamExperts-Username: 213.129.84.218\r
+Authentication-Results: solardns.com;\r
+ auth=pass smtp.auth=213.129.84.218@out.solardns.com\r
+X-SpamExperts-Outgoing-Class: unsure\r
+X-SpamExperts-Outgoing-Evidence: Combined (0.53)\r
+X-Recommended-Action: accept\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.20\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+ <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <https://notmuchmail.org/mailman/options/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch/>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <https://notmuchmail.org/mailman/listinfo/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Tue, 01 Mar 2016 18:35:38 -0000\r
+\r
+On Sun, 14 Feb 2016 13:05:28 +0100 (CET), Eric J <eric@deptj.eu> wrote:\r
+>\r
+\r
+Resending with additional information:\r
+\r
+> I have been using notmuch for a while and I wanted to be able to use\r
+> notmuch queries in some Tcl stuff I have been using for a rather longer\r
+> while. I could have just called the notmuch CLI every time, but I thought\r
+> "no, it's a library, there should be bindings".\r
+> \r
+> Bindings made me think of SWIG, which seems to have been tried for\r
+> notmuch in the past but abandoned. However, with some time available...\r
+> \r
+> ... I can now, from Tcl, use the API functions from the library to\r
+> create a database, close and open it, add messages, tag them, run queries\r
+> and retrieve information about the results. I haven't tested every API\r
+> function yet, but I will be able to go on with my own needs at least. It\r
+> is only functions with pointer-to-pointer arguments that need special\r
+> attention, and that is all in the SWIG interface file. You can see that at\r
+> http://chiselapp.com/user/emj/repository/tclnotmuch/artifact/527aee944d?txt=1&ln=0\r
+> - its about 50 lines (plus some blanks).\r
+> \r
+> That's a Fossil repository, with a home page at\r
+> http://chiselapp.com/user/emj/repository/tclnotmuch , if anyone wants\r
+> to look further. I think it may benefit from more wrapping from the Tcl\r
+> side, just for usability.\r
+> \r
+> BTW, I have no idea if or how the interface file would have to be changed\r
+> for other languages.\r
+\r
+The bindings work, but for a use case where simultaneous database access\r
+from different processes is needed (e.g. processing emails as they\r
+arrive), lost updates are possible for the following Tcl versions:\r
+\r
+* 8.5.18 built with threads (not the default)\r
+* 8.6.[1-4] built with threads (default)\r
+\r
+However, the following Tcl versions do not have this problem:\r
+\r
+* 8.5.18 built without threads (default)\r
+* 8.5.19 built with or without threads\r
+* 8.6.[1-4] built without threads (not the default)\r
+* 8.6.5 built with or without threads\r
+\r
+Earlier 8.5.x are presumably the same as 8.5.18.\r
+\r
+The problems, where they exist, are due to a weird interaction between\r
+Tcl's thread implementation and Xapian's locking mechanism. The Tcl fix\r
+in 8.5.19/8.6.5 was made for reasons unrelated to Xapian locking, but\r
+fixes it anyway.\r
+\r
+Eric\r
+-- \r
+ms fnd in a lbry\r