Mercurial > emacs
annotate lisp/net/eudcb-bbdb.el @ 66153:e2fa815b43c1
(Quitting): Minor clarification.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Mon, 17 Oct 2005 16:19:56 +0000 |
parents | 34bd8e434dd7 |
children | 067115a6e738 edf295560b5a |
rev | line source |
---|---|
27313 | 1 ;;; eudcb-bbdb.el --- Emacs Unified Directory Client - BBDB Backend |
2 | |
64701
34bd8e434dd7
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64085
diff
changeset
|
3 ;; Copyright (C) 1998, 1999, 2000, 2002, 2003, 2004, |
34bd8e434dd7
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64085
diff
changeset
|
4 ;; 2005 Free Software Foundation, Inc. |
27313 | 5 |
42778
6d743d659035
New maintainer. Change author's address.
Pavel Janík <Pavel@Janik.cz>
parents:
42574
diff
changeset
|
6 ;; Author: Oscar Figueiredo <oscar@cpe.fr> |
6d743d659035
New maintainer. Change author's address.
Pavel Janík <Pavel@Janik.cz>
parents:
42574
diff
changeset
|
7 ;; Maintainer: Pavel Janík <Pavel@Janik.cz> |
42574 | 8 ;; Keywords: comm |
27313 | 9 |
10 ;; This file is part of GNU Emacs. | |
11 | |
12 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
13 ;; it under the terms of the GNU General Public License as published by | |
14 ;; the Free Software Foundation; either version 2, or (at your option) | |
15 ;; any later version. | |
16 | |
17 ;; GNU Emacs is distributed in the hope that it will be useful, | |
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 ;; GNU General Public License for more details. | |
21 | |
22 ;; You should have received a copy of the GNU General Public License | |
23 ;; along with GNU Emacs; see the file COPYING. If not, write to the | |
64085 | 24 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
25 ;; Boston, MA 02110-1301, USA. | |
27313 | 26 |
27 ;;; Commentary: | |
42570
78a4068d960a
Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents:
27313
diff
changeset
|
28 ;; This library provides an interface to use BBDB as a backend of |
27313 | 29 ;; the Emacs Unified Directory Client. |
30 | |
31 ;;; Code: | |
32 | |
33 (require 'eudc) | |
34 (if (not (featurep 'bbdb)) | |
35 (load-library "bbdb")) | |
36 (if (not (featurep 'bbdb-com)) | |
37 (load-library "bbdb-com")) | |
38 | |
39 ;;{{{ Internal cooking | |
40 | |
41 ;; I don't like this but mapcar does not accept a parameter to the function and | |
42 ;; I don't want to use mapcar* | |
43 (defvar eudc-bbdb-current-query nil) | |
44 (defvar eudc-bbdb-current-return-attributes nil) | |
45 | |
46 (defvar eudc-bbdb-attributes-translation-alist | |
47 '((name . lastname) | |
48 (email . net) | |
49 (phone . phones)) | |
50 "Alist mapping EUDC attribute names to BBDB names.") | |
51 | |
52 (eudc-protocol-set 'eudc-query-function 'eudc-bbdb-query-internal 'bbdb) | |
53 (eudc-protocol-set 'eudc-list-attributes-function nil 'bbdb) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
54 (eudc-protocol-set 'eudc-protocol-attributes-translation-alist |
27313 | 55 'eudc-bbdb-attributes-translation-alist 'bbdb) |
56 (eudc-protocol-set 'eudc-bbdb-conversion-alist nil 'bbdb) | |
57 (eudc-protocol-set 'eudc-protocol-has-default-query-attributes nil 'bbdb) | |
58 | |
59 (defun eudc-bbdb-format-query (query) | |
60 "Format a EUDC query alist into a list suitable to `bbdb-search'." | |
61 (let* ((firstname (cdr (assq 'firstname query))) | |
62 (lastname (cdr (assq 'lastname query))) | |
63 (name (or (and firstname lastname | |
64 (concat firstname " " lastname)) | |
65 firstname | |
66 lastname)) | |
67 (company (cdr (assq 'company query))) | |
68 (net (cdr (assq 'net query))) | |
69 (notes (cdr (assq 'notes query))) | |
70 (phone (cdr (assq 'phone query)))) | |
71 (list name company net notes phone))) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
72 |
27313 | 73 |
74 (defun eudc-bbdb-filter-non-matching-record (record) | |
75 "Return RECORD if it matches `eudc-bbdb-current-query', nil otherwise." | |
76 (catch 'unmatch | |
77 (progn | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
78 (mapcar |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
79 (function |
27313 | 80 (lambda (condition) |
81 (let ((attr (car condition)) | |
82 (val (cdr condition)) | |
83 (case-fold-search t) | |
84 bbdb-val) | |
85 (or (and (memq attr '(firstname lastname aka company phones addresses net)) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
86 (progn |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
87 (setq bbdb-val |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
88 (eval (list (intern (concat "bbdb-record-" |
27313 | 89 (symbol-name attr))) |
90 'record))) | |
91 (if (listp bbdb-val) | |
92 (if eudc-bbdb-enable-substring-matches | |
93 (eval `(or ,@(mapcar '(lambda (subval) | |
94 (string-match val | |
95 subval)) | |
96 bbdb-val))) | |
97 (member (downcase val) | |
98 (mapcar 'downcase bbdb-val))) | |
99 (if eudc-bbdb-enable-substring-matches | |
100 (string-match val bbdb-val) | |
101 (string-equal (downcase val) (downcase bbdb-val)))))) | |
102 (throw 'unmatch nil))))) | |
103 eudc-bbdb-current-query) | |
104 record))) | |
105 | |
106 (defun eudc-bbdb-extract-phones (record) | |
107 (mapcar (function | |
108 (lambda (phone) | |
109 (if eudc-bbdb-use-locations-as-attribute-names | |
110 (cons (intern (bbdb-phone-location phone)) | |
111 (bbdb-phone-string phone)) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
112 (cons 'phones (format "%s: %s" |
27313 | 113 (bbdb-phone-location phone) |
114 (bbdb-phone-string phone)))))) | |
115 (bbdb-record-phones record))) | |
116 | |
117 (defun eudc-bbdb-extract-addresses (record) | |
118 (let (s c val) | |
119 (mapcar (function | |
120 (lambda (address) | |
121 (setq val (concat (unless (= 0 (length (setq s (bbdb-address-street1 address)))) | |
122 (concat s "\n")) | |
123 (unless (= 0 (length (setq s (bbdb-address-street2 address)))) | |
124 (concat s "\n")) | |
125 (unless (= 0 (length (setq s (bbdb-address-street3 address)))) | |
126 (concat s "\n")) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
127 (progn |
27313 | 128 (setq c (bbdb-address-city address)) |
129 (setq s (bbdb-address-state address)) | |
130 (if (and (> (length c) 0) (> (length s) 0)) | |
131 (concat c ", " s " ") | |
132 (concat c " "))) | |
133 (bbdb-address-zip-string address))) | |
134 (if eudc-bbdb-use-locations-as-attribute-names | |
135 (cons (intern (bbdb-address-location address)) val) | |
136 (cons 'addresses (concat (bbdb-address-location address) "\n" val))))) | |
137 (bbdb-record-addresses record)))) | |
138 | |
139 (defun eudc-bbdb-format-record-as-result (record) | |
140 "Format the BBDB RECORD as a EUDC query result record. | |
141 The record is filtered according to `eudc-bbdb-current-return-attributes'" | |
142 (let ((attrs (or eudc-bbdb-current-return-attributes | |
143 '(firstname lastname aka company phones addresses net notes))) | |
144 attr | |
145 eudc-rec | |
146 val) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
147 (while (prog1 |
27313 | 148 (setq attr (car attrs)) |
149 (setq attrs (cdr attrs))) | |
150 (cond | |
151 ((eq attr 'phones) | |
152 (setq val (eudc-bbdb-extract-phones record))) | |
153 ((eq attr 'addresses) | |
154 (setq val (eudc-bbdb-extract-addresses record))) | |
155 ((memq attr '(firstname lastname aka company net notes)) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
156 (setq val (eval |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
157 (list (intern |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
158 (concat "bbdb-record-" |
27313 | 159 (symbol-name attr))) |
160 'record)))) | |
161 (t | |
162 (setq val "Unknown BBDB attribute"))) | |
163 (if val | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
164 (cond |
27313 | 165 ((memq attr '(phones addresses)) |
166 (setq eudc-rec (append val eudc-rec))) | |
167 ((and (listp val) | |
168 (= 1 (length val))) | |
169 (setq eudc-rec (cons (cons attr (car val)) eudc-rec))) | |
170 ((> (length val) 0) | |
171 (setq eudc-rec (cons (cons attr val) eudc-rec))) | |
172 (t | |
173 (error "Unexpected attribute value"))))) | |
174 (nreverse eudc-rec))) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
175 |
27313 | 176 |
177 | |
178 (defun eudc-bbdb-query-internal (query &optional return-attrs) | |
179 "Query BBDB with QUERY. | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
180 QUERY is a list of cons cells (ATTR . VALUE) where ATTRs should be valid |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
181 BBDB attribute names. |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
182 RETURN-ATTRS is a list of attributes to return, defaulting to |
27313 | 183 `eudc-default-return-attributes'." |
184 | |
185 (let ((eudc-bbdb-current-query query) | |
186 (eudc-bbdb-current-return-attributes return-attrs) | |
187 (query-attrs (eudc-bbdb-format-query query)) | |
188 bbdb-attrs | |
189 (records (bbdb-records)) | |
190 result | |
191 filtered) | |
192 ;; BBDB ORs its query attributes while EUDC ANDs them, hence we need to | |
193 ;; call bbdb-search iteratively on the returned records for each of the | |
194 ;; requested attributes | |
195 (while (and records (> (length query-attrs) 0)) | |
196 (setq bbdb-attrs (append bbdb-attrs (list (car query-attrs)))) | |
197 (if (car query-attrs) | |
198 (setq records (eval `(bbdb-search ,(quote records) ,@bbdb-attrs)))) | |
199 (setq query-attrs (cdr query-attrs))) | |
200 (mapcar (function | |
201 (lambda (record) | |
202 (setq filtered (eudc-filter-duplicate-attributes record)) | |
203 ;; If there were duplicate attributes reverse the order of the | |
204 ;; record so the unique attributes appear first | |
205 (if (> (length filtered) 1) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
206 (setq filtered (mapcar (function |
27313 | 207 (lambda (rec) |
208 (reverse rec))) | |
209 filtered))) | |
210 (setq result (append result filtered)))) | |
211 (delq nil | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
212 (mapcar 'eudc-bbdb-format-record-as-result |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
213 (delq nil |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
42778
diff
changeset
|
214 (mapcar 'eudc-bbdb-filter-non-matching-record |
27313 | 215 records))))) |
216 result)) | |
217 | |
42570
78a4068d960a
Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents:
27313
diff
changeset
|
218 ;;}}} |
27313 | 219 |
220 ;;{{{ High-level interfaces (interactive functions) | |
221 | |
222 (defun eudc-bbdb-set-server (dummy) | |
223 "Set the EUDC server to BBDB." | |
224 (interactive) | |
225 (eudc-set-server dummy 'bbdb) | |
226 (message "BBDB server selected")) | |
227 | |
42570
78a4068d960a
Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents:
27313
diff
changeset
|
228 ;;}}} |
27313 | 229 |
230 | |
231 (eudc-register-protocol 'bbdb) | |
232 | |
233 (provide 'eudcb-bbdb) | |
234 | |
52401 | 235 ;;; arch-tag: 38276208-75de-4dbc-ba6f-8db684c32e0a |
27313 | 236 ;;; eudcb-bbdb.el ends here |