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.
36 (require 'elmo-localdir)
39 (defvar elmo-dop-queue nil
40 "A list of (folder-name function-to-be-called argument-list).
41 Automatically loaded/saved.")
43 (defmacro elmo-make-dop-queue (fname method arguments)
45 (` (vector (, fname) (, method) (, arguments))))
47 (defmacro elmo-dop-queue-fname (queue)
48 "Return the folder name string of the QUEUE."
49 (` (aref (, queue) 0)))
51 (defmacro elmo-dop-queue-method (queue)
52 "Return the method symbol of the QUEUE."
53 (` (aref (, queue) 1)))
55 (defmacro elmo-dop-queue-arguments (queue)
56 "Return the arguments of the QUEUE."
57 (` (aref (, queue) 2)))
59 (defun elmo-dop-queue-append (folder method arguments)
60 "Append to disconnected operation queue."
61 (let ((queue (elmo-make-dop-queue (elmo-folder-name-internal folder)
63 (setq elmo-dop-queue (nconc elmo-dop-queue (list queue)))))
65 (defvar elmo-dop-queue-merge-method-list
66 '(elmo-folder-mark-as-read
67 elmo-folder-unmark-read
68 elmo-folder-mark-as-important
69 elmo-folder-unmark-important
70 elmo-folder-mark-as-answered
71 elmo-folder-unmark-answered))
73 (defvar elmo-dop-queue-method-name-alist
74 '((elmo-folder-append-buffer-dop-delayed . "Append")
75 (elmo-folder-delete-messages-dop-delayed . "Delete")
76 (elmo-message-encache . "Encache")
77 (elmo-folder-create-dop-delayed . "Create")
78 (elmo-folder-mark-as-read . "Read")
79 (elmo-folder-unmark-read . "Unread")
80 (elmo-folder-mark-as-answered . "Answered")
81 (elmo-folder-unmark-answered . "Unanswered")
82 (elmo-folder-mark-as-important . "Important")
83 (elmo-folder-unmark-important . "Unimportant")))
85 (defmacro elmo-dop-queue-method-name (queue)
86 `(cdr (assq (elmo-dop-queue-method ,queue)
87 elmo-dop-queue-method-name-alist)))
89 (defun elmo-dop-queue-flush ()
90 "Flush disconnected operations that consern plugged folders."
91 (elmo-dop-queue-merge)
92 (let ((queue-all elmo-dop-queue)
97 (unless (or (null queue-all)
98 (vectorp (car queue-all)))
99 (if (y-or-n-p "Saved queue is old version(2.6). Clear all pending operations? ")
101 (setq elmo-dop-queue nil)
102 (message "All pending operations are cleared.")
103 (elmo-dop-queue-save))
104 (error "Please use 2.6 or earlier.")))
106 (if (elmo-folder-plugged-p
107 (elmo-make-folder (elmo-dop-queue-fname (car queue-all))))
108 (setq queue (append queue (list (car queue-all)))))
109 (setq queue-all (cdr queue-all)))
110 (setq count (length queue))
113 (format "%d pending operation(s) exists. Perform now? " count)
114 (not elmo-dop-flush-confirm) t)
118 (let ((queue elmo-dop-queue)
121 (num (length elmo-dop-queue))
124 ;; now perform pending processes.
127 (message "Flushing queue....%d/%d." i num)
130 (apply (elmo-dop-queue-method (car queue))
134 (elmo-dop-queue-fname (car queue))))
135 (elmo-folder-open folder))
136 (elmo-dop-queue-arguments (car queue)))
137 (elmo-folder-close folder))
138 (quit (setq failure t))
139 (error (setq failure err)))
142 (setq elmo-dop-queue (delq (car queue) elmo-dop-queue))
143 (setq performed (+ 1 performed)))
144 (setq queue (cdr queue)))
145 (message "%d/%d operation(s) are performed successfully."
148 (elmo-dop-queue-save)))
149 ;; when answer=NO against performing dop
150 (if (elmo-y-or-n-p "Clear these pending operations? "
151 (not elmo-dop-flush-confirm) t)
154 (setq elmo-dop-queue (delq (car queue) elmo-dop-queue))
155 (setq queue (cdr queue)))
156 (message "Pending operations are cleared.")
157 (elmo-dop-queue-save))
161 (defun elmo-dop-queue-merge ()
162 (let ((queue elmo-dop-queue)
163 new-queue match-queue que)
164 (while (setq que (car queue))
166 (memq (elmo-dop-queue-method que)
167 elmo-dop-queue-merge-method-list)
174 (string= (elmo-dop-queue-fname que)
175 (elmo-dop-queue-fname nqueue))
176 (string= (elmo-dop-queue-method que)
177 (elmo-dop-queue-method nqueue)))
180 (setcar (elmo-dop-queue-arguments match-queue)
181 (append (car (elmo-dop-queue-arguments match-queue))
182 (car (elmo-dop-queue-arguments que))))
183 (setq new-queue (nconc new-queue (list que))))
184 (setq queue (cdr queue)) )
185 (setq elmo-dop-queue new-queue)))
188 (defmacro elmo-dop-spool-folder (folder)
189 "Return a spool folder for disconnected operations
190 which is corresponded to the FOLDER."
192 (concat "+" (expand-file-name "spool" (elmo-folder-msgdb-path
195 (defun elmo-dop-spool-folder-append-buffer (folder)
196 "Append current buffer content to the dop spool folder.
197 FOLDER is the folder structure.
198 Return a message number."
199 (setq folder (elmo-dop-spool-folder folder))
200 (unless (elmo-folder-exists-p folder)
201 (elmo-folder-create folder))
202 (let ((new-number (1+ (car (elmo-folder-status folder)))))
203 ;; dop folder is a localdir folder.
204 (write-region-as-binary (point-min) (point-max)
206 (int-to-string new-number)
207 (elmo-localdir-folder-directory-internal folder))
212 (defun elmo-dop-spool-folder-list-messages (folder)
213 "List messages in the dop spool folder.
214 FOLDER is the folder structure."
215 (setq folder (elmo-dop-spool-folder folder))
216 (if (elmo-folder-exists-p folder)
217 (elmo-folder-list-messages folder)))
219 (defun elmo-dop-list-deleting-messages (folder)
220 "List messages which are on the deleting queue for the folder.
221 FOLDER is the folder structure."
223 (dolist (queue elmo-dop-queue)
224 (if (and (string= (elmo-dop-queue-fname queue)
225 (elmo-folder-name-internal folder))
226 (eq (elmo-dop-queue-method queue)
227 'elmo-folder-delete-messages-dop-delayed))
228 (setq messages (nconc messages
231 (car (elmo-dop-queue-arguments queue)))))))))
234 (defsubst elmo-folder-append-buffer-dop (folder unread &optional number)
235 (elmo-dop-queue-append
236 folder 'elmo-folder-append-buffer-dop-delayed
238 (elmo-dop-spool-folder-append-buffer
242 (defsubst elmo-folder-delete-messages-dop (folder numbers)
243 (let ((spool-folder (elmo-dop-spool-folder folder))
245 (dolist (number numbers)
247 (elmo-folder-delete-messages spool-folder
248 (list (abs number))) ; delete from queue
249 (setq queue (cons number queue))))
251 (elmo-dop-queue-append folder 'elmo-folder-delete-messages-dop-delayed
255 (cons number (elmo-message-field
256 folder number 'message-id)))
260 (defsubst elmo-message-encache-dop (folder number &optional read)
261 (elmo-dop-queue-append folder 'elmo-message-encache (list number read)))
263 (defsubst elmo-folder-create-dop (folder)
264 (elmo-dop-queue-append folder 'elmo-folder-create-dop-delayed nil))
266 (defsubst elmo-folder-mark-as-read-dop (folder numbers)
267 (elmo-dop-queue-append folder 'elmo-folder-mark-as-read (list numbers)))
269 (defsubst elmo-folder-unmark-read-dop (folder numbers)
270 (elmo-dop-queue-append folder 'elmo-folder-unmark-read (list numbers)))
272 (defsubst elmo-folder-mark-as-important-dop (folder numbers)
273 (elmo-dop-queue-append folder 'elmo-folder-mark-as-important (list numbers)))
275 (defsubst elmo-folder-unmark-important-dop (folder numbers)
276 (elmo-dop-queue-append folder 'elmo-folder-unmark-important (list numbers)))
278 (defsubst elmo-folder-mark-as-answered-dop (folder numbers)
279 (elmo-dop-queue-append folder 'elmo-folder-mark-as-answered (list numbers)))
281 (defsubst elmo-folder-unmark-answered-dop (folder numbers)
282 (elmo-dop-queue-append folder 'elmo-folder-unmark-answered (list numbers)))
284 ;;; Execute as subsutitute for plugged operation.
285 (defun elmo-folder-status-dop (folder)
286 (let* ((number-alist (elmo-msgdb-number-load
287 (elmo-folder-msgdb-path folder)))
288 (number-list (mapcar 'car number-alist))
289 (spool-folder (elmo-dop-spool-folder folder))
293 (setq spool-length (or (car (if (elmo-folder-exists-p spool-folder)
294 (elmo-folder-status spool-folder))) 0))
296 (or (nth (max (- (length number-list) 1) 0) number-list)
298 (cons (+ max-num spool-length) (+ (length number-list) spool-length))))
300 ;;; Delayed operation (executed at online status).
301 (defun elmo-folder-append-buffer-dop-delayed (folder unread number set-number)
302 (let ((spool-folder (elmo-dop-spool-folder folder))
303 failure saved dequeued)
305 (if (elmo-message-fetch spool-folder number
306 (elmo-make-fetch-strategy 'entire)
307 nil (current-buffer) 'unread)
310 (elmo-folder-append-buffer
311 folder unread set-number)))
312 (error (setq failure t)))
313 (setq dequeued t)) ; Already deletef from queue.
316 (setq saved (elmo-folder-append-buffer
317 (elmo-make-folder elmo-lost+found-folder)
319 (if (and (not dequeued) ; if dequeued, no need to delete.
320 (or (not failure) ; succeed
321 saved)) ; in lost+found
322 (elmo-folder-delete-messages spool-folder (list number)))
325 (defun elmo-folder-delete-messages-dop-delayed (folder number-alist)
326 (elmo-folder-delete-messages
328 ;; messages are deleted only if message-id is not changed.
334 (elmo-message-fetch-field folder (car pair)
338 (defun elmo-folder-create-dop-delayed (folder)
339 (unless (elmo-folder-exists-p folder)
340 (elmo-folder-create folder)))
343 (defun elmo-dop-msgdb (msgdb)
344 (list (mapcar (function
346 (elmo-msgdb-overview-entity-set-number
349 (elmo-msgdb-overview-entity-get-number x)))))
359 (cdr x)))) (nth 2 msgdb))))
362 (product-provide (provide 'elmo-dop) (require 'elmo-version))
364 ;;; elmo-dop.el ends here