[PATCH 1/5] Added thread bindings to go bindings
authorlaochailan <laochailan@web.de>
Sun, 31 May 2015 12:02:11 +0000 (14:02 +0200)
committerW. Trevor King <wking@tremily.us>
Sat, 20 Aug 2016 21:48:56 +0000 (14:48 -0700)
fc/f33b83ae0c4c2bb6c2c1683b76f535ab9434dd [new file with mode: 0644]

diff --git a/fc/f33b83ae0c4c2bb6c2c1683b76f535ab9434dd b/fc/f33b83ae0c4c2bb6c2c1683b76f535ab9434dd
new file mode 100644 (file)
index 0000000..2fe9761
--- /dev/null
@@ -0,0 +1,356 @@
+Return-Path: <laochailan@web.de>\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 A394B6DE17A6\r
+ for <notmuch@notmuchmail.org>; Sun, 31 May 2015 05:07:56 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at cworth.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.56\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.56 tagged_above=-999 required=5 tests=[AWL=-0.009,\r
+  FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001,\r
+ RP_MATCHES_RCVD=-0.55, SPF_PASS=-0.001] 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 DQlLnaLJSnh1 for <notmuch@notmuchmail.org>;\r
+ Sun, 31 May 2015 05:07:55 -0700 (PDT)\r
+Received: from mout.web.de (mout.web.de [212.227.15.14])\r
+ by arlo.cworth.org (Postfix) with ESMTPS id 95E5A6DE17A3\r
+ for <notmuch@notmuchmail.org>; Sun, 31 May 2015 05:07:54 -0700 (PDT)\r
+Received: from localhost ([92.204.48.23]) by smtp.web.de (mrweb003) with\r
+ ESMTPSA (Nemesis) id 0Mb8xf-1Yeslp1e2t-00KdaH; Sun, 31 May 2015 14:02:46\r
+ +0200\r
+From: laochailan <laochailan@web.de>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH 1/5] Added thread bindings to go bindings\r
+Date: Sun, 31 May 2015 14:02:11 +0200\r
+Message-Id: <1433073735-7721-2-git-send-email-laochailan@web.de>\r
+X-Mailer: git-send-email 2.4.2\r
+In-Reply-To: <1433073735-7721-1-git-send-email-laochailan@web.de>\r
+References: <1433073735-7721-1-git-send-email-laochailan@web.de>\r
+X-Provags-ID: V03:K0:/SkHwgRIL0//GXbrPm63u13OxF7Yjy40Gr7BKF2NcqG+c0fxEmS\r
+ ygJUSBFjra7gGvnguM6fp2xsUDS5ktTrObAgO9CYJYr1CIZD/KigHdP4RITGgvurL7j5XVM\r
+ zL/VViuqbip/rHWaHXfmONFqd72xecvjDRLY/7XF17oGddY/UxSJlUExwkeYTlnACY5hOtW\r
+ 5Pnv6CGGkNeuI7gOhR5rw==\r
+X-UI-Out-Filterresults: notjunk:1;V01:K0:5LczhKmpEF4=:3G4PJMjbl2h7wvS4oICFKV\r
+ xwJ7yqaQsV2aenUG80g7UkcdfUscerr9CZBShkUpX6BAy1Jf3E/rcQBHu4DMGjNjfFqyQgMfF\r
+ Z1e54KUcv9p7NjA2Whb9PzFNy3nx4euOGrjN0VSe86fgqCeIQOl3vXSDO/t9qtkIeYsAJl/RD\r
+ L6a7zoD3b5Fz0S2WkVZCrcnrgb6NCARJi2qX7Ft7D48QSM8/rjQIV81qZZ+6K23ijqbtZA6Pd\r
+ UScnlh+lpHuORyVwyWcfEkhv16xbjDwZhP64GWjGkmiCNmY/+PosSOLYF9yipuY2FeX1sSyx+\r
+ /XJXpJ7c+SraqZXuWaFsfDLCZmMQZ4p0gFL/KTStgnvk1uDTvn7bbS7lVLazfXl41y+r3xbjq\r
+ XdjqEVQzTm971xGN3kNSQ90UnkqGXpSlVVvEUA3OZo2RGbgmkHLhWdEMbwOqq3QW6YWGlrSiP\r
+ OPMvNr1M72NAxSGmUBAUrOgaBEeQw9cpa6B6TXTIKEs99g3n/D28NxOspLLCUkvAtguRqPBsK\r
+ HvjG2U2ghS+/cdeNa3Kjduohq0LOQc8fer0AcGI2o/olEcSeJetjUQh16tj8r1qpTF5U8JoV3\r
+ 7x6yO4CNGD3GSEEsCV9zFiBZG7GSyushOQ1Hq2TbAKPf7nyx9ipz7R7vGv38zc8PIaBLM9GFQ\r
+ mr/mbV9TJYjhQVYr+wC/KSaQx7xYPTGVEJ3a4L1CRwt/IDg==\r
+X-Mailman-Approved-At: Mon, 01 Jun 2015 09:14:43 -0700\r
+Cc: laochailan <laochailan@web.de>\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.18\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+ <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://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: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sun, 31 May 2015 12:07:56 -0000\r
+\r
+---\r
+ bindings/go/src/notmuch/notmuch.go | 262 ++++++++++++++++++++++++++++++++++++-\r
+ 1 file changed, 260 insertions(+), 2 deletions(-)\r
+\r
+diff --git a/bindings/go/src/notmuch/notmuch.go b/bindings/go/src/notmuch/notmuch.go\r
+index 0fff1ab..a0b901f 100644\r
+--- a/bindings/go/src/notmuch/notmuch.go\r
++++ b/bindings/go/src/notmuch/notmuch.go\r
+@@ -534,8 +534,6 @@ func (self *Query) CountMessages() uint {\r
+       return uint(C.notmuch_query_count_messages(self.query))\r
+ }\r
\r
+-// TODO: wrap threads and thread\r
+-\r
+ /* Is the given 'threads' iterator pointing at a valid thread.\r
+  *\r
+  * When this function returns TRUE, notmuch_threads_get will return a\r
+@@ -556,6 +554,45 @@ func (self *Threads) Valid() bool {\r
+       return true\r
+ }\r
\r
++/* Get the current thread from 'threads' as a notmuch_thread_t.\r
++ *\r
++ * Note: The returned thread belongs to 'threads' and has a lifetime\r
++ * identical to it (and the query to which it belongs).\r
++ *\r
++ * See the documentation of notmuch_query_search_threads for example\r
++ * code showing how to iterate over a notmuch_threads_t object.\r
++ *\r
++ * If an out-of-memory situation occurs, this function will return\r
++ * NULL.\r
++ */\r
++func (self *Threads) Get() *Thread {\r
++      if self.threads == nil {\r
++              return nil\r
++      }\r
++      thread := C.notmuch_threads_get(self.threads)\r
++      if thread == nil {\r
++              return nil\r
++      }\r
++      return &Thread{thread}\r
++}\r
++\r
++/* Move the 'threads' iterator to the next thread.\r
++ *\r
++ * If 'threads' is already pointing at the last thread then the\r
++ * iterator will be moved to a point just beyond that last thread,\r
++ * (where notmuch_threads_valid will return FALSE and\r
++ * notmuch_threads_get will return NULL).\r
++ *\r
++ * See the documentation of notmuch_query_search_threads for example\r
++ * code showing how to iterate over a notmuch_threads_t object.\r
++ */\r
++func (self *Threads) MoveToNext() {\r
++      if self.threads == nil {\r
++              return\r
++      }\r
++      C.notmuch_threads_move_to_next(self.threads)\r
++}\r
++\r
+ /* Destroy a notmuch_threads_t object.\r
+  *\r
+  * It's not strictly necessary to call this function. All memory from\r
+@@ -568,6 +605,227 @@ func (self *Threads) Destroy() {\r
+       }\r
+ }\r
\r
++/**\r
++ * Get the thread ID of 'thread'.\r
++ *\r
++ * The returned string belongs to 'thread' and as such, should not be\r
++ * modified by the caller and will only be valid for as long as the\r
++ * thread is valid, (which is until notmuch_thread_destroy or until\r
++ * the query from which it derived is destroyed).\r
++ */\r
++func (self *Thread) GetThreadId() string {\r
++      if self.thread == nil {\r
++              return ""\r
++      }\r
++      id := C.notmuch_thread_get_thread_id(self.thread)\r
++      if id == nil {\r
++              return ""\r
++      }\r
++      return C.GoString(id)\r
++}\r
++\r
++/**\r
++ * Get the total number of messages in 'thread'.\r
++ *\r
++ * This count consists of all messages in the database belonging to\r
++ * this thread. Contrast with notmuch_thread_get_matched_messages() .\r
++ */\r
++func (self *Thread) GetTotalMessages() int {\r
++      if self.thread == nil {\r
++              return 0\r
++      }\r
++      return int(C.notmuch_thread_get_total_messages(self.thread))\r
++}\r
++\r
++/**\r
++ * Get a notmuch_messages_t iterator for the top-level messages in\r
++ * 'thread' in oldest-first order.\r
++ *\r
++ * This iterator will not necessarily iterate over all of the messages\r
++ * in the thread. It will only iterate over the messages in the thread\r
++ * which are not replies to other messages in the thread.\r
++ *\r
++ * The returned list will be destroyed when the thread is destroyed.\r
++ */\r
++func (self *Thread) GetToplevelMessages() (*Messages, Status) {\r
++      if self.thread == nil {\r
++              return nil, STATUS_NULL_POINTER\r
++      }\r
++\r
++      msgs := C.notmuch_thread_get_toplevel_messages(self.thread)\r
++      if msgs == nil {\r
++              return nil, STATUS_NULL_POINTER\r
++      }\r
++      return &Messages{msgs}, STATUS_SUCCESS\r
++}\r
++\r
++/**\r
++ * Get a notmuch_thread_t iterator for all messages in 'thread' in\r
++ * oldest-first order.\r
++ *\r
++ * The returned list will be destroyed when the thread is destroyed.\r
++ */\r
++func (self *Thread) GetMessages() (*Messages, Status) {\r
++      if self.thread == nil {\r
++              return nil, STATUS_NULL_POINTER\r
++      }\r
++\r
++      msgs := C.notmuch_thread_get_messages(self.thread)\r
++      if msgs == nil {\r
++              return nil, STATUS_NULL_POINTER\r
++      }\r
++      return &Messages{msgs}, STATUS_SUCCESS\r
++}\r
++\r
++/**\r
++ * Get the number of messages in 'thread' that matched the search.\r
++ *\r
++ * This count includes only the messages in this thread that were\r
++ * matched by the search from which the thread was created and were\r
++ * not excluded by any exclude tags passed in with the query (see\r
++ * notmuch_query_add_tag_exclude). Contrast with\r
++ * notmuch_thread_get_total_messages() .\r
++ */\r
++func (self *Thread) GetMatchedMessages() int {\r
++      if self.thread == nil {\r
++              return 0\r
++      }\r
++      return int(C.notmuch_thread_get_matched_messages(self.thread))\r
++}\r
++\r
++/**\r
++ * Get the authors of 'thread' as a UTF-8 string.\r
++ *\r
++ * The returned string is a comma-separated list of the names of the\r
++ * authors of mail messages in the query results that belong to this\r
++ * thread.\r
++ *\r
++ * The string contains authors of messages matching the query first, then\r
++ * non-matched authors (with the two groups separated by '|'). Within\r
++ * each group, authors are ordered by date.\r
++ *\r
++ * The returned string belongs to 'thread' and as such, should not be\r
++ * modified by the caller and will only be valid for as long as the\r
++ * thread is valid, (which is until notmuch_thread_destroy or until\r
++ * the query from which it derived is destroyed).\r
++ */\r
++func (self *Thread) GetAuthors() string {\r
++      if self.thread == nil {\r
++              return ""\r
++      }\r
++      str := C.notmuch_thread_get_authors(self.thread)\r
++      if str == nil {\r
++              return ""\r
++      }\r
++      return C.GoString(str)\r
++}\r
++\r
++/**\r
++ * Get the subject of 'thread' as a UTF-8 string.\r
++ *\r
++ * The subject is taken from the first message (according to the query\r
++ * order---see notmuch_query_set_sort) in the query results that\r
++ * belongs to this thread.\r
++ *\r
++ * The returned string belongs to 'thread' and as such, should not be\r
++ * modified by the caller and will only be valid for as long as the\r
++ * thread is valid, (which is until notmuch_thread_destroy or until\r
++ * the query from which it derived is destroyed).\r
++ */\r
++func (self *Thread) GetSubject() string {\r
++      if self.thread == nil {\r
++              return ""\r
++      }\r
++      str := C.notmuch_thread_get_subject(self.thread)\r
++      if str == nil {\r
++              return ""\r
++      }\r
++      return C.GoString(str)\r
++}\r
++\r
++/**\r
++ * Get the date of the oldest message in 'thread' as a time_t value.\r
++ */\r
++func (self *Thread) GetOldestDate() int64 {\r
++      if self.thread == nil {\r
++              return 0\r
++      }\r
++      date := C.notmuch_thread_get_oldest_date(self.thread)\r
++\r
++      return int64(date)\r
++}\r
++\r
++/**\r
++ * Get the date of the newest message in 'thread' as a time_t value.\r
++ */\r
++func (self *Thread) GetNewestDate() int64 {\r
++      if self.thread == nil {\r
++              return 0\r
++      }\r
++      date := C.notmuch_thread_get_newest_date(self.thread)\r
++\r
++      return int64(date)\r
++}\r
++\r
++/**\r
++ * Get the tags for 'thread', returning a notmuch_tags_t object which\r
++ * can be used to iterate over all tags.\r
++ *\r
++ * Note: In the Notmuch database, tags are stored on individual\r
++ * messages, not on threads. So the tags returned here will be all\r
++ * tags of the messages which matched the search and which belong to\r
++ * this thread.\r
++ *\r
++ * The tags object is owned by the thread and as such, will only be\r
++ * valid for as long as the thread is valid, (for example, until\r
++ * notmuch_thread_destroy or until the query from which it derived is\r
++ * destroyed).\r
++ *\r
++ * Typical usage might be:\r
++ *\r
++ *     notmuch_thread_t *thread;\r
++ *     notmuch_tags_t *tags;\r
++ *     const char *tag;\r
++ *\r
++ *     thread = notmuch_threads_get (threads);\r
++ *\r
++ *     for (tags = notmuch_thread_get_tags (thread);\r
++ *          notmuch_tags_valid (tags);\r
++ *          notmuch_tags_move_to_next (tags))\r
++ *     {\r
++ *         tag = notmuch_tags_get (tags);\r
++ *         ....\r
++ *     }\r
++ *\r
++ *     notmuch_thread_destroy (thread);\r
++ *\r
++ * Note that there's no explicit destructor needed for the\r
++ * notmuch_tags_t object. (For consistency, we do provide a\r
++ * notmuch_tags_destroy function, but there's no good reason to call\r
++ * it if the message is about to be destroyed).\r
++ */\r
++func (self *Thread) GetTags() *Tags {\r
++      if self.thread == nil {\r
++              return nil\r
++      }\r
++\r
++      tags := C.notmuch_thread_get_tags(self.thread)\r
++      if tags == nil {\r
++              return nil\r
++      }\r
++\r
++      return &Tags{tags}\r
++}\r
++\r
++/**\r
++ * Destroy a notmuch_thread_t object.\r
++ */\r
++func (self *Thread) Destroy() {\r
++      if self.thread != nil {\r
++              C.notmuch_thread_destroy(self.thread)\r
++      }\r
++}\r
++\r
+ /* Is the given 'messages' iterator pointing at a valid message.\r
+  *\r
+  * When this function returns TRUE, notmuch_messages_get will return a\r
+-- \r
+2.4.2\r
+\r