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
101
102
103
104
105
106
107
108
109
110
| | ;;; eudcb-ecomplete.el --- EUDC - ecomplete backend -*- lexical-binding: t -*-
;; Copyright (C) 2022 condition-alpha.com
;; This program 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.
;;
;; This program 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 this program. If not, see <https://www.gnu.org/licenses/>.
;;; Commentary:
;; This library provides an interface to the ecomplete package as
;; an EUDC data source.
;;; Usage:
;; To load the library, first `require' it:
;;
;; (require 'eudcb-ecomplete)
;;
;; In the simplest case then just use:
;;
;; (eudc-ecomplete-set-server "localhost")
;;
;; When using `eudc-server-hotlist', instead use:
;;
;; (add-to-list 'eudc-server-hotlist '("localhost" . ecomplete))
;;; Code:
(require 'eudc)
(require 'ecomplete)
(require 'mail-parse)
(defvar eudc-ecomplete-attributes-translation-alist
'((email . mail))
"See `eudc-protocol-attributes-translation-alist'.
The back-end-specific attribute names are used as the \"type\" of
entry when searching, and they must hence match the types you use
in your ecmompleterc database file.")
;; hook ourselves into the EUDC framework
(eudc-protocol-set 'eudc-query-function
'eudc-ecomplete-query-internal
'ecomplete)
(eudc-protocol-set 'eudc-list-attributes-function
nil
'ecomplete)
(eudc-protocol-set 'eudc-protocol-attributes-translation-alist
'eudc-ecomplete-attributes-translation-alist
'ecomplete)
(eudc-protocol-set 'eudc-protocol-has-default-query-attributes
nil
'ecomplete)
(defun eudc-ecomplete-query-internal (query &optional _return-attrs)
"Query `ecomplete' with QUERY.
QUERY is a list of cons cells (ATTR . VALUE). Since `ecomplete'
does not provide attributes in the usual sense, the
back-end-specific attribute names in
`eudc-ecomplete-attributes-translation-alist' are used as the
KEY (that is, the \"type\" of match) when looking for matches in
`ecomplete-database'.
RETURN-ATTRS is a list of attributes to return, defaulting to
`eudc-default-return-attributes'."
(ecomplete-setup)
(let ((email-attr (car (eudc-translate-attribute-list '(email))))
result)
(dolist (term query)
(let* ((attr (car term))
(value (cdr term))
(matches (ecomplete-get-matches attr value)))
(when matches
(dolist (match (split-string (string-trim (substring-no-properties
matches))
"[\n\r]"))
;; special case email: try to decompose
(let* ((decoded (mail-header-parse-address match t))
(name (cdr decoded))
(email (car decoded)))
(if (and decoded (eq attr email-attr))
;; email could be decomposed, push individual fields
(push `((,attr . ,email)
,@(when name (list (cons 'name name))))
result)
;; else, just forward the value as-is
(push (list (cons attr match)) result)))))))
result))
(defun eudc-ecomplete-set-server (dummy)
"Set the EUDC server to `ecomplete'.
The server in DUMMY is not actually used, since this backend
always and implicitly uses the ecomplete package in the current
Emacs instance running on the local host."
(interactive)
(eudc-set-server dummy 'ecomplete)
(message "[eudc] ecomplete server selected"))
(eudc-register-protocol 'ecomplete)
(provide 'eudcb-ecomplete)
;;; eudcb-ecomplete.el ends here
|