1 ;;; elmo-dop.el --- Modules for Disconnected Operations on ELMO.
3 ;; Copyright (C) 1998,1999,2000 Yuuichi Teranishi <teranisi@gohome.org>
5 ;; Author: Yuuichi Teranishi <teranisi@gohome.org>
6 ;; Keywords: mail, net news
8 ;; This file is part of ELMO (Elisp Library for Message Orchestration).
10 ;; This program is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 2, or (at your option)
15 ;; This program is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 ;; Boston, MA 02111-1307, USA.
31 (eval-when-compile (require 'cl))
37 (require 'elmo-localdir)
40 (defvar elmo-dop-queue nil
41 "A list of (folder-name function-to-be-called argument-list).
42 Automatically loaded/saved.")
44 (defmacro elmo-make-dop-queue (fname method arguments)
46 (` (vector (, fname) (, method) (, arguments))))
48 (defmacro elmo-dop-queue-fname (queue)
49 "Return the folder name string of the QUEUE."
50 (` (aref (, queue) 0)))
52 (defmacro elmo-dop-queue-method (queue)
53 "Return the method symbol of the QUEUE."
54 (` (aref (, queue) 1)))
56 (defmacro elmo-dop-queue-arguments (queue)
57 "Return the arguments of the QUEUE."
58 (` (aref (, queue) 2)))
60 (defun elmo-dop-queue-append (folder method arguments)
61 "Append to disconnected operation queue."
62 (let ((queue (elmo-make-dop-queue (elmo-folder-name-internal folder)
64 (setq elmo-dop-queue (nconc elmo-dop-queue (list queue)))))
66 (defvar elmo-dop-queue-merge-method-list
67 '(elmo-folder-set-read-delayed
68 elmo-folder-unset-read-delayed
69 elmo-folder-set-important-delayed
70 elmo-folder-unset-important-delayed
71 elmo-folder-set-answered-delayed
72 elmo-folder-unset-answered-delayed))
74 (defvar elmo-dop-queue-method-name-alist
75 '((elmo-folder-append-buffer-dop-delayed . "Append")
76 (elmo-folder-delete-messages-dop-delayed . "Delete")
77 (elmo-message-encache . "Encache")
78 (elmo-folder-create-dop-delayed . "Create")
79 (elmo-folder-set-read-delayed . "Read")
80 (elmo-folder-unset-read-delayed . "Unread")
81 (elmo-folder-set-answered-delayed . "Answered")
82 (elmo-folder-unset-answered-delayed . "Unanswered")
83 (elmo-folder-set-important-delayed . "Important")
84 (elmo-folder-unset-important-delayed . "Unimportant")
85 (elmo-folder-set-flag . "Set flag")
86 (elmo-folder-unset-flag . "Unset flag")))
88 (defmacro elmo-dop-queue-method-name (queue)
89 `(cdr (assq (elmo-dop-queue-method ,queue)
90 elmo-dop-queue-method-name-alist)))
92 (defun elmo-dop-queue-flush ()
93 "Flush disconnected operations that consern plugged folders."
95 (unless (or (null elmo-dop-queue)
96 (vectorp (car elmo-dop-queue)))
98 Saved queue is old version(2.6). Clear all pending operations? ")
100 (setq elmo-dop-queue nil)
101 (message "All pending operations are cleared.")
102 (elmo-dop-queue-save))
103 (error "Please use 2.6 or earlier")))
104 (elmo-dop-queue-merge)
105 (let ((queue-all elmo-dop-queue)
110 (if (elmo-folder-plugged-p
111 (elmo-make-folder (elmo-dop-queue-fname (car queue-all))))
112 (setq queue (append queue (list (car queue-all)))))
113 (setq queue-all (cdr queue-all)))
114 (setq count (length queue))
117 (format "%d pending operation(s) exists. Perform now? " count)
118 (not elmo-dop-flush-confirm) t)
122 (let ((queue elmo-dop-queue)
125 (num (length elmo-dop-queue))
128 ;; now perform pending processes.
131 (message "Flushing queue....%d/%d." i num)
134 (apply (elmo-dop-queue-method (car queue))
138 (elmo-dop-queue-fname (car queue))))
139 (elmo-folder-open folder)
140 (unless (elmo-folder-plugged-p folder)
141 (error "Unplugged")))
142 (elmo-dop-queue-arguments (car queue)))
143 (elmo-folder-close folder))
144 (quit (setq failure t))
145 (error (setq failure err)))
148 (setq elmo-dop-queue (delq (car queue) elmo-dop-queue))
149 (setq performed (+ 1 performed)))
150 (setq queue (cdr queue)))
151 (message "%d/%d operation(s) are performed successfully."
154 (elmo-dop-queue-save)))
155 ;; when answer=NO against performing dop
156 (if (elmo-y-or-n-p "Clear these pending operations? "
157 (not elmo-dop-flush-confirm) t)
160 (when (eq (elmo-dop-queue-method (car queue))
161 'elmo-folder-append-buffer-dop-delayed)
162 (elmo-folder-delete-messages
163 (elmo-dop-spool-folder
164 (elmo-make-folder (elmo-dop-queue-fname (car queue))))
165 (list (nth 1 (elmo-dop-queue-arguments (car queue))))))
166 (setq elmo-dop-queue (delq (car queue) elmo-dop-queue))
167 (setq queue (cdr queue)))
168 (message "Pending operations are cleared.")
169 (elmo-dop-queue-save))
173 (defun elmo-dop-queue-merge ()
174 (let ((queue elmo-dop-queue)
175 new-queue match-queue que)
176 (while (setq que (car queue))
178 (memq (elmo-dop-queue-method que)
179 elmo-dop-queue-merge-method-list)
186 (string= (elmo-dop-queue-fname que)
187 (elmo-dop-queue-fname nqueue))
188 (string= (elmo-dop-queue-method que)
189 (elmo-dop-queue-method nqueue)))
192 (setcar (elmo-dop-queue-arguments match-queue)
193 (append (car (elmo-dop-queue-arguments match-queue))
194 (car (elmo-dop-queue-arguments que))))
195 (setq new-queue (nconc new-queue (list que))))
196 (setq queue (cdr queue)) )
197 (setq elmo-dop-queue new-queue)))
200 (defmacro elmo-dop-spool-folder (folder)
201 "Return a spool folder for disconnected operations
202 which is corresponded to the FOLDER."
204 (concat "+" (expand-file-name "spool" (elmo-folder-msgdb-path
207 (defun elmo-dop-spool-folder-append-buffer (folder flags)
208 "Append current buffer content to the dop spool folder.
209 FOLDER is the folder structure.
210 Return a message number."
211 (let ((spool (elmo-dop-spool-folder folder)))
212 (unless (elmo-folder-exists-p spool)
213 (elmo-folder-create spool))
214 (let ((new-number (1+ (car (elmo-folder-status spool)))))
215 (elmo-folder-append-buffer spool flags new-number)
219 (defun elmo-dop-spool-folder-list-messages (folder)
220 "List messages in the dop spool folder.
221 FOLDER is the folder structure."
222 (setq folder (elmo-dop-spool-folder folder))
223 (if (elmo-folder-exists-p folder)
224 (elmo-folder-list-messages folder)))
226 (defun elmo-dop-list-deleting-messages (folder)
227 "List messages which are on the deleting queue for the folder.
228 FOLDER is the folder structure."
230 (dolist (queue elmo-dop-queue)
231 (if (and (string= (elmo-dop-queue-fname queue)
232 (elmo-folder-name-internal folder))
233 (eq (elmo-dop-queue-method queue)
234 'elmo-folder-delete-messages-dop-delayed))
235 (setq messages (nconc messages
238 (car (elmo-dop-queue-arguments queue)))))))))
240 (defun elmo-dop-filter-pending-messages (numbers)
241 (elmo-delete-if (lambda (number) (< number 0)) numbers))
244 (defsubst elmo-folder-append-buffer-dop (folder &optional flag number)
245 (elmo-dop-queue-append
246 folder 'elmo-folder-append-buffer-dop-delayed
248 (elmo-dop-spool-folder-append-buffer folder flag)
251 (defsubst elmo-folder-delete-messages-dop (folder numbers)
252 (let ((spool-folder (elmo-dop-spool-folder folder))
254 (dolist (number numbers)
258 (elmo-folder-delete-messages spool-folder
260 (dolist (queue elmo-dop-queue)
261 (when (and (eq (elmo-dop-queue-fname queue)
262 (elmo-folder-name-internal folder))
263 (eq (elmo-dop-queue-method queue)
264 'elmo-folder-append-buffer-dop-delayed)
266 (nth 1 (elmo-dop-queue-arguments queue))))
267 (setq elmo-dop-queue (delq queue elmo-dop-queue)))))
268 (setq queue (cons number queue))))
270 (elmo-dop-queue-append folder 'elmo-folder-delete-messages-dop-delayed
274 (cons number (elmo-message-field
275 folder number 'message-id)))
279 (defsubst elmo-message-encache-dop (folder number &optional read)
280 (elmo-dop-queue-append folder 'elmo-message-encache (list number read)))
282 (defsubst elmo-folder-create-dop (folder)
283 (elmo-dop-queue-append folder 'elmo-folder-create-dop-delayed nil))
285 (defsubst elmo-folder-set-flag-dop (folder numbers flag)
286 (when (setq numbers (elmo-dop-filter-pending-messages numbers))
287 (let ((method (case flag
289 'elmo-folder-unset-read-delayed)
291 'elmo-folder-set-read-delayed)
293 'elmo-folder-set-important-delayed)
295 'elmo-folder-set-answered-delayed))))
297 (elmo-dop-queue-append folder method (list numbers))
298 (elmo-dop-queue-append folder 'elmo-folder-set-flag
299 (list numbers flag))))))
301 (defsubst elmo-folder-unset-flag-dop (folder numbers flag)
302 (when (setq numbers (elmo-dop-filter-pending-messages numbers))
303 (let ((method (case flag
305 'elmo-folder-set-read-delayed)
307 'elmo-folder-unset-read-delayed)
309 'elmo-folder-unset-important-delayed)
311 'elmo-folder-unset-answered-delayed))))
313 (elmo-dop-queue-append folder method (list numbers))
314 (elmo-dop-queue-append folder 'elmo-folder-unset-flag
315 (list numbers flag))))))
317 ;;; Execute as subsutitute for plugged operation.
318 (defun elmo-folder-status-dop (folder)
319 (let ((number-list (elmo-folder-list-messages folder nil 'in-msgdb))
320 (spool-folder (elmo-dop-spool-folder folder))
323 (setq spool-length (or (if (elmo-folder-exists-p spool-folder)
324 (car (elmo-folder-status spool-folder)))
326 (setq max-num (if number-list (apply #'max number-list) 0))
327 (cons (+ max-num spool-length) (+ (length number-list) spool-length))))
329 (defun elmo-folder-next-message-number-dop (folder)
330 (let ((spool-folder (elmo-dop-spool-folder folder)))
331 (- (+ 1 (elmo-max-of-list (or (elmo-folder-list-messages
335 ;;; Delayed operation (executed at online status).
336 (defun elmo-folder-append-buffer-dop-delayed (folder flag number set-number)
337 (let ((spool-folder (elmo-dop-spool-folder folder))
340 (when (elmo-message-fetch spool-folder number
341 (elmo-make-fetch-strategy 'entire)
343 (setq flags (or (elmo-message-flags-for-append folder (* -1 number))
346 ;; for compatibility with 2.11.12 or earlier
351 (when (or (condition-case nil
352 (elmo-folder-append-buffer folder flags set-number)
355 (elmo-folder-append-buffer
356 (elmo-make-folder elmo-lost+found-folder)
358 (elmo-folder-delete-messages spool-folder (list number)))))
359 ;; ignore failure (already dequed)
362 (defun elmo-folder-delete-messages-dop-delayed (folder number-alist)
364 (elmo-folder-delete-messages
366 ;; messages are deleted only if message-id is not changed.
372 (elmo-message-fetch-field folder (car pair)
375 t)) ; Always success (If failure, just remain)
377 (defun elmo-folder-create-dop-delayed (folder)
378 (unless (elmo-folder-exists-p folder)
379 (elmo-folder-create folder)))
381 (defun elmo-folder-set-important-delayed (folder numbers)
382 (elmo-folder-set-flag folder numbers 'important))
384 (defun elmo-folder-unset-important-delayed (folder numbers)
385 (elmo-folder-unset-flag folder numbers 'important))
387 (defun elmo-folder-set-read-delayed (folder numbers)
388 (elmo-folder-unset-flag folder numbers 'unread))
390 (defun elmo-folder-unset-read-delayed (folder numbers)
391 (elmo-folder-set-flag folder numbers 'unread))
393 (defun elmo-folder-set-answered-delayed (folder numbers)
394 (elmo-folder-set-flag folder numbers 'answered))
396 (defun elmo-folder-unset-answered-delayed (folder numbers)
397 (elmo-folder-unset-flag folder numbers 'answered))
400 (defun elmo-dop-msgdb (msgdb)
401 (let ((new-db (elmo-make-msgdb))
403 (dolist (dop-entity (mapcar
405 (setq entity (elmo-msgdb-message-entity
407 (elmo-message-entity-set-number
409 (* -1 (elmo-message-entity-number entity)))
411 (elmo-msgdb-list-messages msgdb)))
412 (elmo-msgdb-append-entity new-db
416 (abs (elmo-message-entity-number
421 (product-provide (provide 'elmo-dop) (require 'elmo-version))
423 ;;; elmo-dop.el ends here