unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
blob c1d2ec90ad29bdb5cd876d53212065fcbc0df311 3485 bytes (raw)
name: emacs/notmuch-query.el 	 # note: path name is non-authoritative(*)

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
 
;; notmuch-query.el --- provide an emacs api to query notmuch
;;
;; Copyright © David Bremner
;;
;; This file is part of Notmuch.
;;
;; Notmuch is free software: you can redistribute it and/or modify it
;; under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;;
;; Notmuch is distributed in the hope that it will be useful, but
;; WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
;; General Public License for more details.
;;
;; You should have received a copy of the GNU General Public License
;; along with Notmuch.  If not, see <http://www.gnu.org/licenses/>.
;;
;; Authors: David Bremner <david@tethera.net>

(require 'notmuch-lib)
(require 'json)

(defun notmuch-query-get-threads (search-terms)
  "Return a list of threads of messages matching SEARCH-TERMS.

A thread is a forest or list of trees. A tree is a two element
list where the first element is a message, and the second element
is a possibly empty forest of replies.
"
  (let  ((args '("show" "--format=json"))
	 (json-object-type 'plist)
	 (json-array-type 'list)
	 (json-false 'nil))
    (if notmuch-show-process-crypto
	(setq args (append args '("--decrypt"))))
    (setq args (append args search-terms))
    (with-temp-buffer
      (progn
	(apply 'call-process (append (list notmuch-command nil (list t nil) nil) args))
	(goto-char (point-min))
	(json-read)))))

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Mapping functions across collections of messages.

(defun notmuch-query-map-aux  (mapper function seq)
  "private function to do the actual mapping and flattening"
  (apply 'append
	 (mapcar
	   (lambda (tree)
	     (funcall mapper function tree))
	   seq)))

(defun notmuch-query-map-threads (fn threads)
  "apply FN to every thread in  THREADS. Flatten results to a list.

See the function notmuch-query-get-threads for more information."
  (notmuch-query-map-aux 'notmuch-query-map-forest fn threads))

(defun notmuch-query-map-forest (fn forest)
  "apply function to every message in a forest. Flatten results to a list.

See the function notmuch-query-get-threads for more information.
"
  (notmuch-query-map-aux 'notmuch-query-map-tree fn forest))

(defun notmuch-query-map-tree (fn tree)
  "Apply function FN to every message in TREE. Flatten results to a list

See the function notmuch-query-get-threads for more information."
  (cons (funcall fn (car tree)) (notmuch-query-map-forest fn (cadr tree))))

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Predefined queries

(defun notmuch-query-get-message-ids (&rest search-terms)
  "Return a list of message-ids of messages that match SEARCH-TERMS"
  (notmuch-query-map-threads
   (lambda (msg) (plist-get msg :id))
   (notmuch-query-get-threads search-terms)))

(defun notmuch-query-thread-tags-from-id (thread-id)
  "Return the tags of thread whose id is THREAD-ID.
The thread tags are the union of the tags of emails in the
thread."
  (let ((tag-lists
	 (notmuch-query-map-forest
	  (lambda (msg) (plist-get msg :tags))
	  (car (notmuch-query-get-threads
		(list (concat "thread:" thread-id)))))))
    (case (length tag-lists)
      (0 nil)
      (1 (car tag-lists))
      (otherwise (reduce (lambda (l1 l2)
			   (union l1 l2 :test 'string=))
			 tag-lists)))))

(provide 'notmuch-query)

debug log:

solving c1d2ec9 ...
found c1d2ec9 in https://yhetil.org/notmuch/1352234344-28119-1-git-send-email-damien.cassou@gmail.com/
found d66baea in https://yhetil.org/notmuch.git/
preparing index
index prepared:
100644 d66baeab983b06a6be96abd7ae4bd75c945718a9	emacs/notmuch-query.el

applying [1/1] https://yhetil.org/notmuch/1352234344-28119-1-git-send-email-damien.cassou@gmail.com/
diff --git a/emacs/notmuch-query.el b/emacs/notmuch-query.el
index d66baea..c1d2ec9 100644

Checking patch emacs/notmuch-query.el...
Applied patch emacs/notmuch-query.el cleanly.

index at:
100644 c1d2ec90ad29bdb5cd876d53212065fcbc0df311	emacs/notmuch-query.el

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).