]> git.notmuchmail.org Git - notmuch/blob - emacs/notmuch-address.el
Merge branch 'release'
[notmuch] / emacs / notmuch-address.el
1 ;; notmuch-address.el --- address completion with notmuch
2 ;;
3 ;; Copyright © David Edmondson
4 ;;
5 ;; This file is part of Notmuch.
6 ;;
7 ;; Notmuch is free software: you can redistribute it and/or modify it
8 ;; under the terms of the GNU General Public License as published by
9 ;; the Free Software Foundation, either version 3 of the License, or
10 ;; (at your option) any later version.
11 ;;
12 ;; Notmuch is distributed in the hope that it will be useful, but
13 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
14 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15 ;; General Public License for more details.
16 ;;
17 ;; You should have received a copy of the GNU General Public License
18 ;; along with Notmuch.  If not, see <http://www.gnu.org/licenses/>.
19 ;;
20 ;; Authors: David Edmondson <dme@dme.org>
21
22 (require 'message)
23
24 ;;
25
26 (defcustom notmuch-address-command "notmuch-addresses"
27   "The command which generates possible addresses. It must take a
28 single argument and output a list of possible matches, one per
29 line."
30   :type 'string
31   :group 'notmuch-send
32   :group 'notmuch-external)
33
34 (defcustom notmuch-address-selection-function 'notmuch-address-selection-function
35   "The function to select address from given list. The function is
36 called with PROMPT, COLLECTION, and INITIAL-INPUT as arguments
37 (subset of what `completing-read' can be called with).
38 While executed the value of `completion-ignore-case' is t.
39 See documentation of function `notmuch-address-selection-function'
40 to know how address selection is made by default."
41   :type 'function
42   :group 'notmuch-send
43   :group 'notmuch-external)
44
45 (defun notmuch-address-selection-function (prompt collection initial-input)
46   "Call (`completing-read'
47       PROMPT COLLECTION nil nil INITIAL-INPUT 'notmuch-address-history)"
48   (completing-read
49    prompt collection nil nil initial-input 'notmuch-address-history))
50
51 (defvar notmuch-address-message-alist-member
52   '("^\\(Resent-\\)?\\(To\\|B?Cc\\|Reply-To\\|From\\|Mail-Followup-To\\|Mail-Copies-To\\):"
53               . notmuch-address-expand-name))
54
55 (defvar notmuch-address-history nil)
56
57 (defun notmuch-address-message-insinuate ()
58   (unless (memq notmuch-address-message-alist-member message-completion-alist)
59     (setq message-completion-alist
60           (push notmuch-address-message-alist-member message-completion-alist))))
61
62 (defun notmuch-address-options (original)
63   (process-lines notmuch-address-command original))
64
65 (defun notmuch-address-expand-name ()
66   (let* ((end (point))
67          (beg (save-excursion
68                 (re-search-backward "\\(\\`\\|[\n:,]\\)[ \t]*")
69                 (goto-char (match-end 0))
70                 (point)))
71          (orig (buffer-substring-no-properties beg end))
72          (completion-ignore-case t)
73          (options (notmuch-address-options orig))
74          (num-options (length options))
75          (chosen (cond
76                   ((eq num-options 0)
77                    nil)
78                   ((eq num-options 1)
79                    (car options))
80                   (t
81                    (funcall notmuch-address-selection-function
82                             (format "Address (%s matches): " num-options)
83                             (cdr options) (car options))))))
84     (if chosen
85         (progn
86           (push chosen notmuch-address-history)
87           (delete-region beg end)
88           (insert chosen))
89       (message "No matches.")
90       (ding))))
91
92 ;; Copied from `w3m-which-command'.
93 (defun notmuch-address-locate-command (command)
94   "Return non-nil if `command' is an executable either on
95 `exec-path' or an absolute pathname."
96   (when (stringp command)
97     (if (and (file-name-absolute-p command)
98              (file-executable-p command))
99         command
100       (setq command (file-name-nondirectory command))
101       (catch 'found-command
102         (let (bin)
103           (dolist (dir exec-path)
104             (setq bin (expand-file-name command dir))
105             (when (or (and (file-executable-p bin)
106                            (not (file-directory-p bin)))
107                       (and (file-executable-p (setq bin (concat bin ".exe")))
108                            (not (file-directory-p bin))))
109               (throw 'found-command bin))))))))
110
111 ;; If we can find the program specified by `notmuch-address-command',
112 ;; insinuate ourselves into `message-mode'.
113 (when (notmuch-address-locate-command notmuch-address-command)
114   (notmuch-address-message-insinuate))
115
116 ;;
117
118 (provide 'notmuch-address)