1 ;;; elmo.el -- Elisp Library for Message Orchestration
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.
28 ;; APIs which can be used before opened:
45 (eval-when-compile (require 'cl))
47 (if (or (featurep 'dbm)
50 (featurep 'berkeley-db))
51 (require 'elmo-database))
53 (defcustom elmo-message-fetch-threshold 30000
58 (defcustom elmo-message-fetch-confirm t
59 "Confirm fetching if message size is larger than `elmo-fetch-threshold'.
60 Otherwise, entire fetching of the message is aborted without confirmation."
64 (defcustom elmo-folder-update-threshold 500
69 (defcustom elmo-folder-update-confirm t
70 "Confirm if update number exceeds `elmo-folder-update-threshold'."
75 (defvar elmo-folder-type-alist nil)
77 (defvar elmo-newsgroups-hashtb nil)
79 (elmo-define-error 'elmo-error "Error" 'error)
80 (elmo-define-error 'elmo-open-error "Cannot open" 'elmo-error)
81 (elmo-define-error 'elmo-authenticate-error "Login failed" 'elmo-open-error)
82 (elmo-define-error 'elmo-imap4-bye-error "IMAP4 BYE response" 'elmo-open-error)
84 (defun elmo-define-folder (prefix backend)
86 If a folder name begins with PREFIX, use BACKEND."
87 (let ((pair (assq prefix elmo-folder-type-alist)))
91 (setcdr pair backend))
92 (setq elmo-folder-type-alist (cons (cons prefix backend)
93 elmo-folder-type-alist)))))
95 (defmacro elmo-folder-type (name)
96 "Get folder type from NAME string."
97 (` (and (stringp (, name))
98 (cdr (assoc (string-to-char (, name)) elmo-folder-type-alist)))))
101 ;; A elmo folder provides uniformed (orchestrated) access
102 ;; to the internet messages.
104 (luna-define-class elmo-folder () (type ; folder type symbol.
105 name ; orignal folder name string.
106 prefix ; prefix for folder name
107 path ; directory path for msgdb.
108 msgdb ; msgdb (may be nil).
109 killed-list ; killed list.
110 persistent ; non-nil if persistent.
111 message-modified ; message is modified.
112 mark-modified ; mark is modified.
114 (luna-define-internal-accessors 'elmo-folder))
116 (luna-define-generic elmo-folder-initialize (folder name)
117 ;; Initialize a FOLDER structure with NAME."
120 (defmacro elmo-folder-send (folder message &rest args)
121 "Let FOLDER receive the MESSAGE with ARGS."
122 (` (luna-send (, folder) (, message) (, folder) (,@ args))))
125 (defun elmo-make-folder (name &optional non-persistent)
126 "Make an ELMO folder structure specified by NAME.
127 If optional argument NON-PERSISTENT is non-nil, folder is treated as
129 (let ((type (elmo-folder-type name))
130 prefix split class folder original)
131 (setq original (elmo-string name))
134 (setq prefix (substring name 0 1))
135 (setq name (substring name 1)))
136 (setq type (intern (car (setq split (split-string name ":")))))
137 (setq name (substring name (+ 1 (length (car split)))))
138 (setq prefix (concat (car split) ":")))
139 (setq class (format "elmo-%s" (symbol-name type)))
140 (require (intern class))
141 (setq folder (luna-make-entity (intern (concat class "-folder"))
145 :persistent (not non-persistent)))
147 (elmo-folder-send folder 'elmo-folder-initialize name))))
149 (luna-define-generic elmo-folder-open (folder)
150 "Open and setup (load saved status) FOLDER.")
152 (luna-define-generic elmo-folder-open-internal (folder)
153 "Open FOLDER (without loading saved folder status).")
155 (luna-define-generic elmo-folder-check (folder)
156 "Check the FOLDER to obtain newest information at the next list operation.")
158 (luna-define-generic elmo-folder-commit (folder)
159 "Save current status of FOLDER.")
161 (luna-define-generic elmo-folder-close (folder)
162 "Close, save and clearnup FOLDER.")
164 (luna-define-generic elmo-folder-close-internal (folder)
165 "Close FOLDER (without saving folder status).")
167 (luna-define-generic elmo-folder-plugged-p (folder)
168 "Returns t if FOLDER is plugged.")
170 (luna-define-generic elmo-folder-set-plugged (folder plugged &optional add)
171 "Set FOLDER as plugged.")
173 (luna-define-generic elmo-folder-use-flag-p (folder)
174 "Returns t if FOLDER treats unread/important flag itself.")
176 (luna-define-generic elmo-folder-diff (folder &optional numbers)
178 If optional NUMBERS is set, it is used as current NUMBERS.
179 Otherwise, saved status for folder is used for comparison.
180 Return value is a cons cell of NEWS and MESSAGES.")
182 (luna-define-generic elmo-folder-status (folder)
183 "Returns a cons cell of (MAX-NUMBER . MESSAGES) in the FOLDER.")
185 (defun elmo-folder-list-messages (folder &optional visible-only)
186 "Return a list of message numbers contained in FOLDER.
187 If optional VISIBLE-ONLY is non-nil, killed messages are not listed."
188 (let ((list (elmo-folder-list-messages-internal folder visible-only))
189 (killed (elmo-folder-killed-list-internal folder))
194 ;; Not available, use current list.
197 (elmo-msgdb-get-number-alist (elmo-folder-msgdb folder)))))
198 (elmo-living-messages numbers killed)))
200 (defun elmo-folder-list-unreads (folder unread-marks)
201 "Return a list of unread message numbers contained in FOLDER.
202 UNREAD-MARKS is the unread marks."
203 (let ((list (elmo-folder-list-unreads-internal folder
207 ;; Not available, use current mark.
212 (if (member (cadr x) unread-marks)
214 (elmo-msgdb-get-mark-alist (elmo-folder-msgdb folder)))))))
216 (defun elmo-folder-list-importants (folder important-mark)
217 "Returns a list of important message numbers contained in FOLDER.
218 IMPORTANT-MARK is the important mark."
219 (let ((list (elmo-folder-list-importants-internal folder important-mark)))
222 ;; Not available, use current mark.
227 (if (string= (cadr x) important-mark)
229 (elmo-msgdb-get-mark-alist (elmo-folder-msgdb folder)))))))
231 (luna-define-generic elmo-folder-list-messages-internal (folder &optional
233 ;; Return a list of message numbers contained in FOLDER.
234 ;; Return t if the message list is not available.
237 (luna-define-generic elmo-folder-list-unreads-internal (folder
239 &optional mark-alist)
240 ;; Return a list of unread message numbers contained in FOLDER.
241 ;; If optional MARK-ALIST is set, it is used as mark-alist.
242 ;; Return t if this feature is not available.
245 (luna-define-generic elmo-folder-list-importants-internal (folder
247 ;; Return a list of important message numbers contained in FOLDER.
248 ;; Return t if this feature is not available.
251 (luna-define-generic elmo-folder-list-subfolders (folder &optional one-level)
252 "Returns a list of subfolders contained in FOLDER.
253 If optional argument ONE-LEVEL is non-nil, only children of FOLDER is returned.
254 (a folder which have children is returned as a list)
255 Otherwise, all descendent folders are returned.")
257 (luna-define-generic elmo-folder-exists-p (folder)
258 "Returns non-nil when FOLDER exists.")
260 (luna-define-generic elmo-folder-creatable-p (folder)
261 "Returns non-nil when FOLDER is creatable.")
263 (luna-define-generic elmo-folder-writable-p (folder)
264 "Returns non-nil when FOLDER is writable.")
266 (luna-define-generic elmo-folder-persistent-p (folder)
267 "Return non-nil when FOLDER is persistent.")
269 (luna-define-generic elmo-folder-create (folder)
272 (luna-define-generic elmo-message-deletable-p (folder number)
273 "Returns non-nil when the message in the FOLDER with NUMBER is deletable.")
275 (luna-define-generic elmo-folder-delete (folder)
276 "Delete FOLDER completely.")
278 (luna-define-generic elmo-folder-rename (folder new-name)
279 "Rename FOLDER to NEW-NAME (string).")
281 (luna-define-generic elmo-folder-delete-messages (folder numbers)
283 FOLDER is the ELMO folder structure.
284 NUMBERS is a list of message numbers to be deleted.")
286 (luna-define-generic elmo-folder-search (folder condition &optional numbers)
287 "Search and return list of message numbers.
288 FOLDER is the ELMO folder structure.
289 CONDITION is a condition string for searching.
290 If optional argument NUMBERS is specified and is a list of message numbers,
291 messages are searched from the list.")
293 (luna-define-generic elmo-folder-msgdb-create
294 (folder numbers new-mark already-mark seen-mark important-mark seen-list)
295 "Create a message database (implemented in each backends).
296 FOLDER is the ELMO folder structure.
297 NUMBERS is a list of message numbers to create msgdb.
298 NEW-MARK, ALREADY-MARK, SEEN-MARK, and IMPORTANT-MARK are mark string for
299 new message, unread but cached message, read message and important message.
300 SEEN-LIST is a list of message-id string which should be treated as read.")
302 (luna-define-generic elmo-folder-unmark-important (folder numbers)
303 "Un-mark messages as important.
304 FOLDER is the ELMO folder structure.
305 NUMBERS is a list of message numbers to be processed.")
307 (luna-define-generic elmo-folder-mark-as-important (folder numbers)
308 "Mark messages as important.
309 FOLDER is the ELMO folder structure.
310 NUMBERS is a list of message numbers to be processed.")
312 (luna-define-generic elmo-folder-unmark-read (folder numbers)
313 "Un-mark messages as read.
314 FOLDER is the ELMO folder structure.
315 NUMBERS is a list of message numbers to be processed.")
317 (luna-define-generic elmo-folder-mark-as-read (folder numbers)
318 "Mark messages as read.
319 FOLDER is the ELMO folder structure.
320 NUMBERS is a list of message numbers to be processed.")
322 (luna-define-generic elmo-folder-append-buffer (folder unread &optional number)
323 "Append current buffer as a new message.
324 FOLDER is the destination folder(ELMO folder structure).
325 If UNREAD is non-nil, message is appended as unread.
326 If optional argument NUMBER is specified, the new message number is set
329 (luna-define-generic elmo-folder-append-messages (folder
335 "Append messages from folder.
336 FOLDER is the ELMO folder structure.
337 Caller should make sure FOLDER is `writable'.
338 (Can be checked with `elmo-folder-writable-p').
339 SRC-FOLDER is the source ELMO folder structure.
340 NUMBERS is the message numbers to be appended in the SRC-FOLDER.
341 UNREAD-MARKS is a list of unread mark string.
342 If second optional argument SAME-NUMBER is specified,
343 message number is preserved (if possible).")
345 (luna-define-generic elmo-folder-pack-numbers (folder)
346 "Pack message numbers of FOLDER.")
348 (luna-define-generic elmo-folder-update-number (folder)
349 "Update number of FOLDER.")
351 (luna-define-generic elmo-folder-diff-async (folder)
352 "Get diff of FOLDER asynchronously.")
354 (luna-define-generic elmo-folder-expand-msgdb-path (folder)
355 "Expand path for FOLDER.")
357 (luna-define-generic elmo-folder-get-primitive-list (folder)
358 "Get primitive folder structure list contained in FOLDER.")
360 (luna-define-generic elmo-folder-contains-type (folder type)
361 "Returns t if FOLDER contains TYPE.")
363 (luna-define-generic elmo-folder-local-p (folder)
364 "Returns t if FOLDER is local.")
366 (luna-define-generic elmo-folder-message-file-p (folder)
367 "Returns t if all messages in the FOLDER are files.")
370 (luna-define-generic elmo-message-use-cache-p (folder number)
371 "Returns t if the message in the FOLDER with NUMBER uses cache.")
373 (luna-define-generic elmo-message-file-name (folder number)
374 "Return the file name of a message specified by FOLDER and NUMBER.")
378 ;;; Use original file
379 (luna-define-generic elmo-folder-message-file-number-p (folder)
380 "Return t if the file name in the FOLDER is the message number.")
382 (luna-define-generic elmo-folder-message-file-directory (folder)
383 "Return the directory of the message files of FOLDER.")
385 ;;; Use temporary file
386 (luna-define-generic elmo-folder-message-make-temp-file-p (folder)
387 "Return t if the messages in the FOLDER makes local temporary file.")
389 (luna-define-generic elmo-folder-message-make-temp-files (folder
393 "Make a new temporary files from the messages in the FOLDER with NUMBERS.
394 If START-NUMBER is specified, temporary files begin from the number.
395 Otherwise, same number is used for temporary files.
396 Return newly created temporary directory name which contains temporary files.")
398 (luna-define-generic elmo-message-file-p (folder number)
399 "Return t if message in the FOLDER with NUMBER is a file.")
401 (luna-define-generic elmo-find-fetch-strategy
402 (folder entity &optional ignore-cache)
403 ;; Returns the message fetching strategy suitable for the message.
404 ;; FOLDER is the ELMO folder structure.
405 ;; ENTITY is the overview entity of the message in the folder.
406 ;; If optional argument IGNORE-CACHE is non-nil, cache is ignored.
407 ;; Returned value is a elmo-fetch-strategy object.
408 ;; If return value is nil, message should not be nil.
411 (defmacro elmo-make-fetch-strategy (entireness
416 ;; Make elmo-message-fetching strategy.
417 ;; ENTIRENESS is 'entire or 'section.
418 ;; 'entire means fetch message entirely at once.
419 ;; 'section means fetch message section by section.
420 ;; If optional USE-CACHE is non-nil, existing cache is used and otherwise,
421 ;; existing cache is thrown away.
422 ;; If SAVE-CACHE is non-nil, fetched message is saved.
423 ;; CACHE-PATH is the cache path to be used as a message cache file.
424 (` (vector (, entireness)
425 (, use-cache) (, save-cache) (, cache-path))))
427 (defmacro elmo-fetch-strategy-entireness (strategy)
428 ;; Return entireness of STRATEGY.
429 (` (aref (, strategy) 0)))
431 (defmacro elmo-fetch-strategy-use-cache (strategy)
432 ;; Return use-cache of STRATEGY.
433 (` (aref (, strategy) 1)))
435 (defmacro elmo-fetch-strategy-save-cache (strategy)
436 ;; Return save-cache of STRATEGY.
437 (` (aref (, strategy) 2)))
439 (defmacro elmo-fetch-strategy-cache-path (strategy)
440 ;; Return cache-path of STRATEGY.
441 (` (aref (, strategy) 3)))
443 (luna-define-method elmo-find-fetch-strategy
444 ((folder elmo-folder) entity &optional ignore-cache)
445 (let (cache-file size message-id number)
446 (setq size (elmo-msgdb-overview-entity-get-size entity))
447 (setq message-id (elmo-msgdb-overview-entity-get-id entity))
448 (setq number (elmo-msgdb-overview-entity-get-number entity))
449 (setq cache-file (elmo-file-cache-get message-id))
451 (null (elmo-file-cache-status cache-file)))
452 ;; No cache or ignore-cache.
453 (if (and (not (elmo-folder-local-p folder))
454 elmo-message-fetch-threshold
456 (>= size elmo-message-fetch-threshold)
457 (or (not elmo-message-fetch-confirm)
458 (not (prog1 (y-or-n-p
459 (format "Fetch entire message(%dbytes)? "
462 ;; Don't fetch message at all.
464 ;; Don't use existing cache and fetch entire message at once.
465 (elmo-make-fetch-strategy
467 (elmo-message-use-cache-p folder number)
468 (elmo-file-cache-path cache-file)))
470 (if (not ignore-cache)
471 (elmo-make-fetch-strategy
473 ;; ...But ignore current section cache and re-fetch
475 (not (eq (elmo-file-cache-status cache-file) 'section))
477 (elmo-message-use-cache-p folder number)
478 (elmo-file-cache-path cache-file))))))
480 (luna-define-method elmo-folder-list-messages-internal
481 ((folder elmo-folder))
484 (luna-define-method elmo-folder-list-unreads-internal
485 ((folder elmo-folder) unread-marks &optional mark-alist)
488 (luna-define-method elmo-folder-list-importants-internal
489 ((folder elmo-folder) important-mark)
492 (defun elmo-message-encache (folder number)
495 (elmo-make-fetch-strategy 'entire
498 (elmo-file-cache-get-path
500 folder number 'message-id)))))
502 (luna-define-generic elmo-message-fetch (folder number strategy
507 "Fetch a message and return as a string.
508 FOLDER is the ELMO folder structure.
509 NUMBER is the number of the message in the FOLDER.
510 STRATEGY is the message fetching strategy.
511 If optional argument SECTION is specified, only the SECTION of the message
512 is fetched (if possible).
513 If second optional argument OUTBUF is specified, fetched message is
514 inserted to the buffer and returns t if fetch was ended successfully.
515 If third optional argument UNREAD is non-nil, message is not marked as read.
516 Returns non-nil if fetching was succeed.")
518 (luna-define-generic elmo-message-folder (folder number)
519 "Get primitive folder of the message.")
521 (luna-define-generic elmo-folder-process-crosspost (folder
524 "Process crosspost for FOLDER.
525 If NUMBER-ALIST is set, it is used as number-alist.
526 Return a cons cell of (NUMBER-CROSSPOSTS . NEW-MARK-ALIST).")
528 (luna-define-generic elmo-folder-append-msgdb (folder append-msgdb)
529 "Append APPEND-MSGDB to the current msgdb of the folder.")
531 (luna-define-method elmo-folder-open ((folder elmo-folder))
532 (elmo-generic-folder-open folder))
534 (defun elmo-generic-folder-open (folder)
535 (elmo-folder-set-msgdb-internal folder (elmo-msgdb-load folder))
536 (elmo-folder-set-killed-list-internal
538 (elmo-msgdb-killed-list-load (elmo-folder-msgdb-path folder)))
539 (elmo-folder-open-internal folder))
541 (luna-define-method elmo-folder-open-internal ((folder elmo-folder))
542 nil ; default is do nothing.
545 (luna-define-method elmo-folder-check ((folder elmo-folder))
546 nil) ; default is noop.
548 (luna-define-method elmo-folder-commit ((folder elmo-folder))
549 (elmo-generic-folder-commit folder))
551 (defun elmo-generic-folder-commit (folder)
552 (when (elmo-folder-persistent-p folder)
553 (when (elmo-folder-message-modified-internal folder)
554 (elmo-msgdb-overview-save
555 (elmo-folder-msgdb-path folder)
556 (elmo-msgdb-get-overview (elmo-folder-msgdb-internal folder)))
557 (elmo-msgdb-number-save
558 (elmo-folder-msgdb-path folder)
559 (elmo-msgdb-get-number-alist (elmo-folder-msgdb-internal folder)))
560 (elmo-folder-set-info-max-by-numdb
562 (elmo-msgdb-get-number-alist
563 (elmo-folder-msgdb-internal folder)))
564 (elmo-folder-set-message-modified-internal folder nil)
565 (elmo-msgdb-killed-list-save
566 (elmo-folder-msgdb-path folder)
567 (elmo-folder-killed-list-internal folder)))
568 (when (elmo-folder-mark-modified-internal folder)
569 (elmo-msgdb-mark-save
570 (elmo-folder-msgdb-path folder)
571 (elmo-msgdb-get-mark-alist (elmo-folder-msgdb-internal folder)))
572 (elmo-folder-set-mark-modified-internal folder nil))))
574 (luna-define-method elmo-folder-close-internal ((folder elmo-folder))
578 (luna-define-method elmo-folder-close ((folder elmo-folder))
579 (elmo-generic-folder-close folder)
580 (elmo-folder-close-internal folder))
582 (defun elmo-generic-folder-close (folder)
583 (elmo-folder-commit folder)
584 (elmo-folder-set-msgdb-internal folder nil)
585 (elmo-folder-set-killed-list-internal folder nil))
587 (luna-define-method elmo-folder-plugged-p ((folder elmo-folder))
588 t) ; default is plugged.
590 (luna-define-method elmo-folder-set-plugged ((folder elmo-folder) plugged
592 nil) ; default is do nothing.
594 (luna-define-method elmo-folder-use-flag-p ((folder elmo-folder))
595 nil) ; default is no flag.
597 (luna-define-method elmo-folder-persistent-p ((folder elmo-folder))
598 (elmo-folder-persistent-internal folder))
600 (luna-define-method elmo-folder-creatable-p ((folder elmo-folder))
601 t) ; default is creatable.
603 (luna-define-method elmo-folder-writable-p ((folder elmo-folder))
604 t) ; default is writable.
606 (luna-define-method elmo-folder-rename ((folder elmo-folder) new-name)
607 (let* ((new-folder (elmo-make-folder new-name)))
608 (unless (eq (elmo-folder-type-internal folder)
609 (elmo-folder-type-internal new-folder))
610 (error "Not same folder type"))
611 (if (or (file-exists-p (elmo-folder-msgdb-path new-folder))
612 (elmo-folder-exists-p new-folder))
613 (error "Already exists folder: %s" new-name))
614 (elmo-folder-send folder 'elmo-folder-rename-internal new-folder)
615 (elmo-msgdb-rename-path folder new-folder)))
617 (luna-define-method elmo-folder-pack-numbers ((folder elmo-folder))
618 nil) ; default is noop.
620 (luna-define-method elmo-folder-update-number ((folder elmo-folder))
621 nil) ; default is noop.
623 (luna-define-method elmo-folder-message-file-p ((folder elmo-folder))
624 nil) ; default is not file.
626 (luna-define-method elmo-folder-message-file-number-p ((folder elmo-folder))
627 nil) ; default is not number.
629 (luna-define-method elmo-folder-message-make-temp-file-p ((folder elmo-folder))
630 nil) ; default is not make temp file.
632 (luna-define-method elmo-message-file-name ((folder elmo-folder)
634 nil) ; default is no name.
636 (luna-define-method elmo-folder-local-p ((folder elmo-folder))
637 t) ; default is local.
640 ;; Folder info is a message number information cache (hashtable)
641 (defsubst elmo-folder-get-info (folder &optional hashtb)
642 "Return FOLDER info from HASHTB (default is `elmo-folder-info-hashtb')."
643 (elmo-get-hash-val (elmo-folder-name-internal folder)
644 (or hashtb elmo-folder-info-hashtb)))
646 (defun elmo-folder-set-info-hashtb (folder max numbers &optional new unread)
647 "Set FOLDER info (means MAX, NUMBERS, NEW and UNREAD)."
648 (let ((info (elmo-folder-get-info folder)))
650 (or new (setq new (nth 0 info)))
651 (or unread (setq unread (nth 1 info)))
652 (or numbers (setq numbers (nth 2 info)))
653 (or max (setq max (nth 3 info))))
654 (elmo-set-hash-val (elmo-folder-name-internal folder)
655 (list new unread numbers max)
656 elmo-folder-info-hashtb)))
658 (defun elmo-folder-set-info-max-by-numdb (folder msgdb-number)
659 "Set FOLDER info by MSGDB-NUMBER in msgdb."
660 (let ((num-db (sort (mapcar 'car msgdb-number) '<)))
661 (elmo-folder-set-info-hashtb
663 (or (nth (max 0 (1- (length num-db))) num-db) 0)
664 nil ;;(length num-db)
667 (defun elmo-folder-get-info-max (folder)
668 "Return max number of FODLER from folder info."
669 (nth 3 (elmo-folder-get-info folder)))
671 (defun elmo-folder-get-info-length (folder)
672 "Return length of FODLER from folder info."
673 (nth 2 (elmo-folder-get-info folder)))
675 (defun elmo-folder-get-info-unread (folder)
676 "Return unread of FODLER from folder info."
677 (nth 1 (elmo-folder-get-info folder)))
679 (defun elmo-folder-info-make-hashtb (info-alist hashtb)
680 "Setup folder info hashtable by INFO-ALIST on HASHTB."
681 (let* ((hashtb (or hashtb
682 (elmo-make-hash (length info-alist)))))
685 (let ((info (cadr x)))
686 (and (intern-soft (car x) hashtb)
687 (elmo-set-hash-val (car x)
688 (list (nth 2 info) ;; new
689 (nth 3 info) ;; unread
690 (nth 1 info) ;; length
694 (setq elmo-folder-info-hashtb hashtb)))
696 (defsubst elmo-strict-folder-diff (folder)
697 "Return folder diff information strictly from FOLDER."
698 (let* ((dir (elmo-folder-msgdb-path folder))
699 (nalist (or (elmo-folder-msgdb-internal folder)
700 (elmo-msgdb-number-load dir)))
701 (in-db (sort (mapcar 'car nalist) '<))
702 (in-folder (elmo-folder-list-messages folder))
703 append-list delete-list diff)
704 (cons (if (equal in-folder in-db)
706 (setq diff (elmo-list-diff
710 (setq append-list (car diff))
711 (setq delete-list (cadr diff))
715 (- 0 (length delete-list))
717 (length in-folder))))
719 (luna-define-method elmo-folder-diff ((folder elmo-folder)
721 (elmo-generic-folder-diff folder numbers))
723 (defun elmo-generic-folder-diff (folder numbers)
724 (if (elmo-string-match-member (elmo-folder-name-internal folder)
725 elmo-strict-diff-folder-list)
726 (elmo-strict-folder-diff folder)
727 (let ((cached-in-db-max (elmo-folder-get-info-max folder))
728 (in-folder (elmo-folder-status folder))
733 (setq in-db-max (or (nth (max 0 (1- (length numbers))) numbers)
735 (if (not cached-in-db-max)
736 (let ((number-list (mapcar 'car
737 (elmo-msgdb-number-load
738 (elmo-folder-msgdb-path folder)))))
740 (setq in-db (sort number-list '<))
741 (setq in-db-max (or (nth (max 0 (1- (length in-db))) in-db)
743 (elmo-folder-set-info-hashtb folder in-db-max nil))
744 (setq in-db-max cached-in-db-max)))
745 (setq unsync (if (and in-db
747 (- (car in-folder) in-db-max)
751 (if (null (car in-folder))
753 (setq messages (cdr in-folder))
754 (if (and unsync messages (> unsync messages))
755 (setq unsync messages))
756 (cons (or unsync 0) (or messages 0)))))
758 (defvar elmo-folder-diff-async-callback nil)
759 (defvar elmo-folder-diff-async-callback-data nil)
761 (luna-define-method elmo-folder-diff-async ((folder elmo-folder))
762 (and elmo-folder-diff-async-callback
763 (funcall elmo-folder-diff-async-callback
765 (elmo-folder-diff folder))))
767 (luna-define-method elmo-folder-get-primitive-list ((folder elmo-folder))
770 (luna-define-method elmo-folder-contains-type ((folder elmo-folder) type)
771 (eq (elmo-folder-type-internal folder) type))
773 (luna-define-method elmo-folder-append-messages ((folder elmo-folder)
779 (elmo-generic-folder-append-messages folder src-folder numbers
780 unread-marks same-number))
782 (defun elmo-generic-folder-append-messages (folder src-folder numbers
783 unread-marks same-number)
784 (let (unseen seen-list succeed-numbers failure)
790 (elmo-message-fetch src-folder (car numbers)
791 (elmo-make-fetch-strategy
795 (unless (eq (buffer-size) 0)
796 (elmo-folder-append-buffer
798 (setq unseen (member (elmo-message-mark
799 src-folder (car numbers))
801 (if same-number (car numbers)))))
802 (error (setq failure t)))
803 ;; FETCH & APPEND finished
805 (if unseen (setq seen-list (cons
807 src-folder (car numbers)
810 (setq succeed-numbers (cons (car numbers) succeed-numbers)))
811 (setq numbers (cdr numbers)))
812 (if (and seen-list (elmo-folder-persistent-p folder))
813 (elmo-msgdb-seen-save (elmo-folder-msgdb-path folder)
814 (nconc (elmo-msgdb-seen-load
815 (elmo-folder-msgdb-path folder))
819 ;; Arguments should be reduced.
820 (defun elmo-folder-move-messages (src-folder msgs dst-folder
821 &optional msgdb all done
828 (let* ((messages msgs)
830 (all-msg-num (or all len))
831 (done-msg-num (or done 0))
832 (progress-message (if no-delete
833 "Copying messages..."
834 "Moving messages..."))
836 (unless (eq dst-folder 'null)
837 ;; src is already opened.
839 (elmo-folder-open-internal dst-folder)
840 (unless (setq succeeds (elmo-folder-append-messages dst-folder
845 (error "move: append message to %s failed"
846 (elmo-folder-name-internal dst-folder)))
847 (elmo-folder-close dst-folder))
848 (when (and (elmo-folder-persistent-p dst-folder)
850 ;; Save to seen list.
851 (let* ((dir (elmo-folder-msgdb-path dst-folder))
852 (seen-list (elmo-msgdb-seen-load dir)))
854 (elmo-msgdb-add-msgs-to-seen-list
855 msgs (elmo-folder-msgdb-internal src-folder)
856 unread-marks seen-list))
857 (elmo-msgdb-seen-save dir seen-list))))
859 (> all-msg-num elmo-display-progress-threshold))
860 (elmo-display-progress
861 'elmo-folder-move-messages progress-message
862 (/ (* done-msg-num 100) all-msg-num)))
863 (if (and (not no-delete) succeeds)
865 (if (not no-delete-info)
866 (message "Cleaning up src folder..."))
867 (if (and (elmo-folder-delete-messages src-folder succeeds)
868 (elmo-msgdb-delete-msgs src-folder succeeds))
870 (message "move: delete messages from %s failed."
871 (elmo-folder-name-internal src-folder))
874 (not no-delete-info))
875 (message "Cleaning up src folder...done"))
879 (message "Copying messages...done")
882 (message "No message was moved.")
883 (message "Moving messages failed.")
887 (defun elmo-folder-msgdb-path (folder)
888 "Return the msgdb path for FOLDER."
889 (or (elmo-folder-path-internal folder)
890 (elmo-folder-set-path-internal
892 (elmo-folder-expand-msgdb-path folder))))
894 (defun elmo-folder-msgdb (folder)
895 "Return the msgdb of FOLDER (on-demand loading)."
896 (or (elmo-folder-msgdb-internal folder)
897 (elmo-msgdb-load folder)))
899 (defun elmo-message-mark (folder number)
900 "Get mark of the message.
901 FOLDER is the ELMO folder structure.
902 NUMBER is a number of the message."
903 (cdr (assq number (elmo-msgdb-get-mark-alist (elmo-folder-msgdb folder)))))
905 (defun elmo-message-field (folder number field)
906 "Get message field value in the msgdb.
907 FOLDER is the ELMO folder structure.
908 NUMBER is a number of the message.
909 FIELD is a symbol of the field."
911 (message-id (elmo-msgdb-overview-entity-get-id
912 (elmo-msgdb-overview-get-entity
913 number (elmo-folder-msgdb folder))))
914 (subject (elmo-msgdb-overview-entity-get-subject
915 (elmo-msgdb-overview-get-entity
916 number (elmo-folder-msgdb folder))))
917 (size (elmo-msgdb-overview-entity-get-size
918 (elmo-msgdb-overview-get-entity
919 number (elmo-folder-msgdb folder))))
920 (date (elmo-msgdb-overview-entity-get-date
921 (elmo-msgdb-overview-get-entity
922 number (elmo-folder-msgdb folder))))
923 (to (elmo-msgdb-overview-entity-get-to
924 (elmo-msgdb-overview-get-entity
925 number (elmo-folder-msgdb folder))))
926 (cc (elmo-msgdb-overview-entity-get-cc
927 (elmo-msgdb-overview-get-entity
928 number (elmo-folder-msgdb folder))))))
930 (defun elmo-message-set-mark (folder number mark)
931 "Set mark for the message in the FOLDER with NUMBER as MARK."
932 (elmo-msgdb-set-mark-alist
933 (elmo-folder-msgdb-internal folder)
935 (elmo-msgdb-get-mark-alist (elmo-folder-msgdb-internal folder))
938 (luna-define-method elmo-message-use-cache-p ((folder elmo-folder) number)
939 nil) ; default is not use cache.
941 (luna-define-method elmo-message-folder ((folder elmo-folder) number)
942 folder) ; default is folder
944 (luna-define-method elmo-folder-unmark-important ((folder elmo-folder) numbers)
947 (luna-define-method elmo-folder-mark-as-important ((folder elmo-folder)
951 (luna-define-method elmo-folder-unmark-read ((folder elmo-folder) numbers)
954 (luna-define-method elmo-folder-mark-as-read ((folder elmo-folder) numbers)
957 (luna-define-method elmo-folder-process-crosspost ((folder elmo-folder)
963 (defun elmo-generic-folder-append-msgdb (folder append-msgdb)
965 (let* ((number-alist (elmo-msgdb-get-number-alist append-msgdb))
966 (all-alist (copy-sequence (append
967 (elmo-msgdb-get-number-alist
968 (elmo-folder-msgdb-internal folder))
975 (setq all-alist (delq (car cur) all-alist))
976 ;; same message id exists.
977 (if (setq pair (rassoc (cdr (car cur)) all-alist))
978 (setq to-be-deleted (nconc to-be-deleted (list (car pair)))))
979 (setq cur (cdr cur)))
980 ;; XXXX If caching is enabled, read-uncached mark should be set.
981 (setq mark-alist (elmo-delete-if
984 (memq (car x) to-be-deleted)))
985 (elmo-msgdb-get-mark-alist append-msgdb)))
986 (elmo-msgdb-set-mark-alist append-msgdb mark-alist)
987 (elmo-folder-set-msgdb-internal folder
989 (elmo-folder-msgdb-internal folder)
991 (length to-be-deleted))
994 (luna-define-method elmo-folder-append-msgdb ((folder elmo-folder)
996 (elmo-generic-folder-append-msgdb folder append-msgdb))
998 (defun elmo-folder-confirm-appends (appends)
999 (let ((len (length appends))
1001 (if (and (> len elmo-folder-update-threshold)
1002 elmo-folder-update-confirm)
1003 (if (y-or-n-p (format "Too many messages(%d). Continue? " len))
1005 (setq in elmo-folder-update-threshold)
1008 (setq in (read-from-minibuffer "Update number: "
1010 in (string-to-int in))
1013 (if (y-or-n-p (format "%d messages are disappeared. OK? "
1014 (max (- len in) 0)))
1016 (nthcdr (max (- len in) 0) appends))
1017 (if (and (> len elmo-folder-update-threshold)
1018 (not elmo-folder-update-confirm))
1019 (nthcdr (max (- len elmo-folder-update-threshold) 0) appends)
1022 (defun elmo-folder-synchronize (folder
1024 unread-uncached-mark ;"U"
1025 unread-cached-mark ;"!"
1026 read-uncached-mark ;"u"
1028 &optional ignore-msgdb)
1029 "Synchronize the folder data to the newest status.
1030 FOLDER is the ELMO folder structure.
1031 NEW-MARK, UNREAD-CACHED-MARK, READ-UNCACHED-MARK, and IMPORTANT-MARK
1032 are mark strings for new messages, unread but cached messages,
1033 read but not cached messages, and important messages.
1034 If optional IGNORE-MSGDB is non-nil, current msgdb is thrown away except
1035 read mark status. If IGNORE-MSGDB is 'visible-only, only visible messages
1036 are thrown away and synchronized.
1039 \(NEW-MSGDB DELETE-LIST CROSSED\)
1040 NEW-MSGDB is the newly appended msgdb.
1041 DELETE-LIST is a list of deleted message number.
1042 CROSSED is cross-posted message number."
1043 (let ((killed-list (elmo-folder-killed-list-internal folder))
1045 number-alist mark-alist
1046 old-msgdb diff diff-2 delete-list new-list new-msgdb mark
1047 seen-list crossed after-append)
1048 (setq old-msgdb (elmo-folder-msgdb-internal folder))
1050 (setq seen-list (elmo-msgdb-seen-load (elmo-folder-msgdb-path folder)))
1051 (setq number-alist (elmo-msgdb-get-number-alist
1052 (elmo-folder-msgdb-internal folder)))
1053 (setq mark-alist (elmo-msgdb-get-mark-alist
1054 (elmo-folder-msgdb-internal folder)))
1057 (setq seen-list (nconc
1058 (elmo-msgdb-mark-alist-to-seen-list
1059 number-alist mark-alist
1060 (concat important-mark read-uncached-mark))
1062 ;; Make killed list as nil.
1063 (unless (eq ignore-msgdb 'visible-only)
1064 (elmo-folder-set-killed-list-internal folder nil))
1065 (elmo-folder-set-msgdb-internal folder
1066 (elmo-msgdb-clear))))
1067 (elmo-folder-check folder)
1070 (message "Checking folder diff...")
1071 ;; TODO: killed list is loaded in elmo-folder-open and
1072 ;; list-messages use internal killed-list-folder.
1073 (setq diff (elmo-list-diff (elmo-folder-list-messages
1075 (eq 'visible-only ignore-msgdb))
1076 (unless ignore-msgdb
1081 (message "Checking folder diff...done")
1082 (setq new-list (elmo-folder-confirm-appends (car diff)))
1084 (when (and (not (eq (length (car diff))
1086 (setq diff-2 (elmo-list-diff (car diff) new-list)))
1087 (elmo-msgdb-append-to-killed-list folder (car diff-2)))
1088 ;; Don't delete important marked messages.
1092 (and (setq mark (cadr (assq x mark-alist)))
1093 (string= mark important-mark)))
1094 ;; delete message list
1096 (if (or (equal diff '(nil nil))
1098 (and (eq (length (car diff)) 0)
1099 (eq (length (cadr diff)) 0)))
1101 (elmo-folder-update-number folder)
1102 (elmo-folder-process-crosspost folder)
1105 (if delete-list (elmo-msgdb-delete-msgs folder delete-list))
1107 (setq new-msgdb (elmo-folder-msgdb-create
1110 new-mark unread-cached-mark
1111 read-uncached-mark important-mark
1113 (elmo-msgdb-change-mark (elmo-folder-msgdb-internal folder)
1114 new-mark unread-uncached-mark)
1116 (if (elmo-folder-persistent-p folder)
1117 (setq seen-list (elmo-msgdb-seen-save
1118 (elmo-folder-msgdb-path folder) nil)))
1119 (setq before-append nil)
1120 (setq crossed (elmo-folder-append-msgdb folder new-msgdb))
1121 ;; process crosspost.
1122 ;; Return a cons cell of (NUMBER-CROSSPOSTS . NEW-MARK-ALIST).
1123 (elmo-folder-process-crosspost folder)
1124 (elmo-folder-set-message-modified-internal folder t)
1125 (elmo-folder-set-mark-modified-internal folder t)
1127 (list new-msgdb delete-list crossed))))
1129 ;; Resume to the original status.
1131 (elmo-folder-set-msgdb-internal folder old-msgdb))
1132 (elmo-folder-set-killed-list-internal folder killed-list)
1135 (defun elmo-folder-messages (folder)
1136 "Return number of messages in the FOLDER."
1138 (elmo-msgdb-get-number-alist
1139 (elmo-folder-msgdb-internal folder))))
1142 (defun elmo-msgdb-search (folder condition msgdb)
1143 "Search messages which satisfy CONDITION from FOLDER with MSGDB."
1144 (let* ((condition (car (elmo-parse-search-condition condition)))
1145 (overview (elmo-msgdb-get-overview msgdb))
1146 (number-alist (elmo-msgdb-get-number-alist msgdb))
1147 (number-list (mapcar 'car number-alist))
1148 (length (length overview))
1151 (if (elmo-condition-find-key condition "body")
1152 (elmo-folder-search folder condition number-list)
1154 (if (elmo-msgdb-search-internal condition (car overview)
1158 (elmo-msgdb-overview-entity-get-number (car overview))
1161 (elmo-display-progress
1162 'elmo-msgdb-search "Searching..." (/ (* i 100) length))
1163 (setq overview (cdr overview)))
1164 (nreverse result))))
1166 (defun elmo-msgdb-load (folder)
1167 (message "Loading msgdb for %s..." (elmo-folder-name-internal folder))
1168 (let* ((path (elmo-folder-msgdb-path folder))
1169 (overview (elmo-msgdb-overview-load path))
1170 (msgdb (list overview
1171 (elmo-msgdb-number-load path)
1172 (elmo-msgdb-mark-load path)
1173 (elmo-msgdb-make-overview-hashtb overview))))
1174 (message "Loading msgdb for %s...done" (elmo-folder-name-internal folder))
1175 (elmo-folder-set-info-max-by-numdb folder
1176 (elmo-msgdb-get-number-alist msgdb))
1179 (defun elmo-msgdb-delete-path (folder)
1180 (let ((path (elmo-folder-msgdb-path folder)))
1181 (if (file-directory-p path)
1182 (elmo-delete-directory path t))))
1184 (defun elmo-msgdb-rename-path (old-folder new-folder)
1185 (let* ((old (directory-file-name (elmo-folder-msgdb-path old-folder)))
1186 (new (directory-file-name (elmo-folder-msgdb-path new-folder)))
1187 (new-dir (directory-file-name (file-name-directory new))))
1188 (if (not (file-directory-p old))
1190 (if (file-exists-p new)
1191 (error "Already exists directory: %s" new)
1192 (if (not (file-exists-p new-dir))
1193 (elmo-make-directory new-dir))
1194 (rename-file old new)))))
1196 (defun elmo-setup-subscribed-newsgroups (groups)
1197 "Setup subscribed newsgroups.
1198 GROUPS is a list of newsgroup name string.
1199 Return a hashtable for newsgroups."
1200 (let ((hashtb (or elmo-newsgroups-hashtb
1201 (setq elmo-newsgroups-hashtb
1202 (elmo-make-hash (length groups))))))
1203 (dolist (group groups)
1204 (or (elmo-get-hash-val group hashtb)
1205 (elmo-set-hash-val group nil hashtb)))
1206 (setq elmo-newsgroups-hashtb hashtb)))
1208 (defvar elmo-crosspost-message-alist-modified nil)
1209 (defun elmo-crosspost-message-alist-load ()
1210 "Load crosspost message alist."
1211 (setq elmo-crosspost-message-alist (elmo-crosspost-alist-load))
1212 (setq elmo-crosspost-message-alist-modified nil))
1214 (defun elmo-crosspost-message-alist-save ()
1215 "Save crosspost message alist."
1216 (when elmo-crosspost-message-alist-modified
1217 (let ((alist elmo-crosspost-message-alist)
1223 (not (intern-soft x elmo-newsgroups-hashtb)))
1224 (nth 1 (car alist))))
1226 (setcar (cdar alist) newsgroups)
1227 (setq elmo-crosspost-message-alist
1228 (delete (car alist) elmo-crosspost-message-alist)))
1229 (setq alist (cdr alist)))
1230 (elmo-crosspost-alist-save elmo-crosspost-message-alist)
1231 (setq elmo-crosspost-message-alist-modified nil))))
1233 (defun elmo-folder-make-temp-dir (folder)
1234 ;; Make a temporary directory for FOLDER.
1235 (let ((temp-dir (make-temp-name
1237 (file-name-as-directory (elmo-folder-msgdb-path folder))
1239 (elmo-make-directory temp-dir)
1243 "Initialize ELMO module."
1244 (elmo-crosspost-message-alist-load)
1245 (elmo-resque-obsolete-variables))
1248 "Quit and cleanup ELMO."
1249 ; (setq elmo-newsgroups-hashtb nil)
1250 (elmo-crosspost-message-alist-save)
1251 ;; Not implemented yet.
1252 (let ((types elmo-folder-type-alist)
1257 (intern (format "elmo-%s-folder" (symbol-name (cdr (car types)))))))
1258 ;; Call all folder's `elmo-quit' method.
1260 (dolist (func (luna-class-find-functions class 'elmo-quit))
1261 (funcall func nil)))
1262 (setq types (cdr types)))))
1266 (elmo-define-folder ?% 'imap4)
1267 (elmo-define-folder ?- 'nntp)
1268 (elmo-define-folder ?\+ 'localdir)
1269 (elmo-define-folder ?\* 'multi)
1270 (elmo-define-folder ?\/ 'filter)
1271 (elmo-define-folder ?\$ 'archive)
1272 (elmo-define-folder ?& 'pop3)
1273 (elmo-define-folder ?= 'localnews)
1274 (elmo-define-folder ?| 'pipe)
1275 (elmo-define-folder ?. 'maildir)
1276 (elmo-define-folder ?' 'internal)
1277 (elmo-define-folder ?[ 'nmz)
1279 (product-provide (provide 'elmo) (require 'elmo-version))
1281 ;; elmo.el ends here.
1284 ;;; elmo.el ends here