cgit.sxemacs.org Git - gnus/blob - lisp/gnus-cache.el

   1 ;;; gnus-cache.el --- cache interface for Gnus
   2 ;; Copyright (C) 1995 Free Software Foundation, Inc.
   3
   4 ;; Author: Lars Magne Ingebrigtsen <larsi@ifi.uio.no>
   5 ;; Keywords: news
   6
   7 ;; This file is part of GNU Emacs.
   8
   9 ;; GNU Emacs is free software; you can redistribute it and/or modify
  10 ;; it under the terms of the GNU General Public License as published by
  11 ;; the Free Software Foundation; either version 2, or (at your option)
  12 ;; any later version.
  13
  14 ;; GNU Emacs is distributed in the hope that it will be useful,
  15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 ;; GNU General Public License for more details.
  18
  19 ;; You should have received a copy of the GNU General Public License
  20 ;; along with GNU Emacs; see the file COPYING.  If not, write to
  21 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  22
  23 ;;; Commentary:
  24
  25 ;;; Code:
  26
  27 (require 'gnus)
  28
  29 (defvar gnus-cache-directory (concat gnus-article-save-directory "cache/")
  30   "*The directory where cached articles will be stored.")
  31
  32 (defvar gnus-cache-enter-articles '(ticked dormant)
  33   "*Classes of articles to enter into the cache.")
  34
  35 (defvar gnus-cache-remove-articles '(read)
  36   "*Classes of articles to remove from the cache.")
  37
  38 \f
  39
  40 (defvar gnus-cache-buffer nil)
  41
  42 \f
  43
  44 (defun gnus-cache-change-buffer (group)
  45   (and gnus-cache-buffer
  46        ;; see if the current group's overview cache has been loaded
  47        (or (string= group (car gnus-cache-buffer))
  48            ;; another overview cache is current, save it
  49            (gnus-cache-save-buffers)))
  50   ;; if gnus-cache buffer is nil, create it
  51   (or gnus-cache-buffer
  52       ;; create cache buffer
  53       (save-excursion
  54         (setq gnus-cache-buffer
  55               (cons group
  56                     (set-buffer (get-buffer-create " *gnus-cache-overview*"))))
  57         (buffer-disable-undo (current-buffer))
  58         ;; insert the contents of this groups cache overview
  59         (erase-buffer)
  60         (let ((file (gnus-cache-file-name group ".overview")))
  61           (and (file-exists-p file)
  62                (insert-file-contents file)))
  63         ;; we have a fresh (empty/just loaded) buffer,
  64         ;; mark it as unmodified to save a redundant write later.
  65         (set-buffer-modified-p nil))))
  66
  67
  68 (defun gnus-cache-save-buffers ()
  69   ;; save the overview buffer if it exists and has been modified
  70   ;; delete empty cache subdirectories
  71   (if (null gnus-cache-buffer)
  72       ()
  73     (let ((buffer (cdr gnus-cache-buffer))
  74           (overview-file (gnus-cache-file-name
  75                           (car gnus-cache-buffer) ".overview")))
  76       ;; write the overview only if it was modified
  77       (if (buffer-modified-p buffer)
  78           (save-excursion
  79             (set-buffer buffer)
  80             (if (> (buffer-size) 0)
  81                 ;; non-empty overview, write it out
  82                 (gnus-make-directory (file-name-directory overview-file))
  83                 (write-region (point-min) (point-max)
  84                               overview-file nil 'quietly)
  85               ;; empty overview file, remove it
  86               (and (file-exists-p overview-file)
  87                    (delete-file overview-file))
  88               ;; if possible, remove group's cache subdirectory
  89               (condition-case nil
  90                   ;; FIXME: we can detect the error type and warn the user
  91                   ;; of any inconsistencies (articles w/o nov entries?).
  92                   ;; for now, just be conservative...delete only if safe -- sj
  93                   (delete-directory (file-name-directory overview-file))
  94                 (error nil)))))
  95       ;; kill the buffer, it's either unmodified or saved
  96       (gnus-kill-buffer buffer)
  97       (setq gnus-cache-buffer nil))))
  98
  99
 100 ;; Return whether an article is a member of a class.
 101 (defun gnus-cache-member-of-class (class ticked dormant unread)
 102   (or (and ticked (memq 'ticked class))
 103       (and dormant (memq 'dormant class))
 104       (and unread (memq 'unread class))
 105       (and (not unread) (memq 'read class))))
 106
 107 (defun gnus-cache-file-name (group article)
 108   (concat (file-name-as-directory gnus-cache-directory)
 109           (if (gnus-use-long-file-name 'not-cache)
 110               group (gnus-replace-chars-in-string group ?. ?/))
 111           "/" (if (stringp article) article (int-to-string article))))
 112
 113 (defun gnus-cache-possibly-enter-article
 114   (group article headers ticked dormant unread)
 115   (let ((number (header-number headers))
 116         file dir)
 117     (if (or (not (gnus-cache-member-of-class
 118                   gnus-cache-enter-articles ticked dormant unread))
 119             (file-exists-p (setq file (gnus-cache-file-name group article))))
 120         ()
 121       ;; Possibly create the cache directory.
 122       (or (file-exists-p (setq dir (file-name-directory file)))
 123           (gnus-make-directory dir))
 124       ;; Save the article in the cache.
 125       (if (file-exists-p file)
 126           t ; The article already is saved, so we end here.
 127         (gnus-summary-select-article)
 128         (save-excursion
 129           (set-buffer gnus-article-buffer)
 130           (write-region (point-min) (point-max) file nil 'quiet)
 131           (gnus-cache-change-buffer group)
 132           (set-buffer (cdr gnus-cache-buffer))
 133           (goto-char (point-max))
 134           (forward-line -1)
 135           (while (and (not (bobp))
 136                       (> (read (current-buffer)) number))
 137             (forward-line -1))
 138           (if (bobp)
 139               (if (not (eobp))
 140                   (progn
 141                     (beginning-of-line)
 142                     (if (< (read (current-buffer)) number)
 143                         (forward-line 1)))
 144                 (beginning-of-line))
 145             (forward-line 1))
 146           (beginning-of-line)
 147           ;; [number subject from date id references chars lines xref]
 148           (insert (format "%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\t\n"
 149                           (header-number headers)
 150                           (header-subject headers)
 151                           (header-from headers)
 152                           (header-date headers)
 153                           (header-id headers)
 154                           (or (header-references headers) "")
 155                           (or (header-chars headers) "")
 156                           (or (header-lines headers) "")
 157                           (or (header-xref headers) ""))))
 158         t))))
 159
 160 (defun gnus-cache-enter-remove-article (article)
 161   (setq gnus-cache-removeable-articles
 162         (cons article gnus-cache-removeable-articles)))
 163
 164 (defsubst gnus-cache-possibly-remove-article
 165   (article ticked dormant unread)
 166   (let ((file (gnus-cache-file-name gnus-newsgroup-name article)))
 167     (if (or (not (file-exists-p file))
 168             (not (gnus-cache-member-of-class
 169                   gnus-cache-remove-articles ticked dormant unread)))
 170         nil
 171       (save-excursion
 172         (delete-file file)
 173         (set-buffer (cdr gnus-cache-buffer))
 174         (goto-char (point-min))
 175         (if (or (looking-at (concat (int-to-string article) "\t"))
 176                 (search-forward (concat "\n" (int-to-string article) "\t")
 177                                 (point-max) t))
 178             (delete-region (progn (beginning-of-line) (point))
 179                            (progn (forward-line 1) (point))))))))
 180
 181 (defun gnus-cache-possibly-remove-articles ()
 182   (let ((articles gnus-cache-removeable-articles)
 183         (cache-articles (gnus-cache-articles-in-group gnus-newsgroup-name))
 184         article)
 185     (gnus-cache-change-buffer gnus-newsgroup-name)
 186     (while articles
 187       (setq article (car articles)
 188             articles (cdr articles))
 189       (if (memq article cache-articles)
 190           ;; The article was in the cache, so we see whether we are
 191           ;; supposed to remove it from the cache.
 192           (gnus-cache-possibly-remove-article
 193            article (memq article gnus-newsgroup-marked)
 194            (memq article gnus-newsgroup-dormant)
 195            (or (memq article gnus-newsgroup-unreads)
 196                (memq article gnus-newsgroup-unselected))))))
 197   ;; the overview file might have been modified, save it
 198   ;; safe because we're only called at group exit anyway
 199   (gnus-cache-save-buffers))
 200
 201
 202 (defun gnus-cache-request-article (article group)
 203   (let ((file (gnus-cache-file-name group article)))
 204     (if (not (file-exists-p file))
 205         ()
 206       (erase-buffer)
 207       (insert-file-contents file)
 208       t)))
 209
 210 (defun gnus-cache-articles-in-group (group)
 211   (let ((dir (file-name-directory (gnus-cache-file-name group 1)))
 212         articles)
 213     (if (not (file-exists-p dir))
 214         nil
 215       (setq articles (directory-files dir nil "^[0-9]+$" t))
 216       (if (not articles)
 217           nil
 218         (sort (mapcar (function (lambda (name)
 219                                   (string-to-int name)))
 220                       articles)
 221               '<)))))
 222
 223 (defun gnus-cache-active-articles (group)
 224   (let ((articles (gnus-cache-articles-in-group group)))
 225     (and articles
 226          (cons (car articles) (gnus-last-element articles)))))
 227
 228 (defun gnus-cache-possibly-alter-active (group active)
 229   (let ((cache-active (gnus-cache-active-articles group)))
 230     (and cache-active (< (car cache-active) (car active))
 231          (setcar active (car cache-active)))
 232     (and cache-active (> (cdr cache-active) (cdr active))
 233          (setcdr active (cdr cache-active)))))
 234
 235 (defun gnus-cache-retrieve-headers (articles group)
 236   (let* ((cached (gnus-cache-articles-in-group group))
 237          (articles (gnus-sorted-complement articles cached))
 238          (cache-file (gnus-cache-file-name group ".overview"))
 239          type)
 240     (let ((gnus-use-cache nil))
 241       (setq type (and articles (gnus-retrieve-headers articles group))))
 242     (gnus-cache-save-buffers)
 243     (save-excursion
 244       (cond ((not (file-exists-p cache-file))
 245              type)
 246             ((null type)
 247              (set-buffer nntp-server-buffer)
 248              (erase-buffer)
 249              (insert-file-contents cache-file)
 250              'nov)
 251             ((eq type 'nov)
 252              (gnus-cache-braid-nov group cached)
 253              type)
 254             (t
 255              (gnus-cache-braid-heads group cached)
 256              type)))))
 257
 258 (defun gnus-cache-braid-nov (group cached)
 259   (let ((cache-buf (get-buffer-create " *gnus-cache*"))
 260         beg end)
 261     (gnus-cache-save-buffers)
 262     (save-excursion
 263       (set-buffer cache-buf)
 264       (buffer-disable-undo (current-buffer))
 265       (erase-buffer)
 266       (insert-file-contents (gnus-cache-file-name group ".overview"))
 267       (goto-char (point-min))
 268       (insert "\n")
 269       (goto-char (point-min)))
 270     (set-buffer nntp-server-buffer)
 271     (goto-char (point-min))
 272     (while cached
 273       (while (and (not (eobp))
 274                   (< (read (current-buffer)) (car cached)))
 275         (forward-line 1))
 276       (beginning-of-line)
 277       (save-excursion
 278         (set-buffer cache-buf)
 279         (if (search-forward (concat "\n" (int-to-string (car cached)) "\t")
 280                             nil t)
 281             (setq beg (progn (beginning-of-line) (point))
 282                   end (progn (forward-line 1) (point)))
 283           (setq beg nil)))
 284       (and beg (insert-buffer-substring cache-buf beg end))
 285       (setq cached (cdr cached)))
 286     (kill-buffer cache-buf)))
 287
 288 (defun gnus-cache-braid-heads (group cached)
 289   (let ((cache-buf (get-buffer-create " *gnus-cache*")))
 290     (save-excursion
 291       (set-buffer cache-buf)
 292       (buffer-disable-undo (current-buffer))
 293       (erase-buffer))
 294     (set-buffer nntp-server-buffer)
 295     (goto-char (point-min))
 296     (while cached
 297       (while (and (not (eobp))
 298                   (looking-at "2.. +\\([0-9]+\\) ")
 299                   (< (progn (goto-char (match-beginning 1))
 300                             (read (current-buffer)))
 301                      (car cached)))
 302         (search-forward "\n.\n" nil 'move))
 303       (beginning-of-line)
 304       (save-excursion
 305         (set-buffer cache-buf)
 306         (erase-buffer)
 307         (insert-file-contents (gnus-cache-file-name group (car cached)))
 308         (goto-char (point-min))
 309         (insert "220 " (int-to-string (car cached)) " Article retrieved.\n")
 310         (search-forward "\n\n" nil 'move)
 311         (delete-region (point) (point-max))
 312         (forward-char -1)
 313         (insert "."))
 314       (insert-buffer-substring cache-buf)
 315       (setq cached (cdr cached)))
 316     (kill-buffer cache-buf)))
 317
 318 (defun gnus-jog-cache ()
 319   "Go through all groups and put the articles into the cache."
 320   (interactive)
 321   (let ((newsrc (cdr gnus-newsrc-alist))
 322         (gnus-cache-enter-articles '(unread))
 323         (gnus-mark-article-hook nil)
 324         (gnus-expert-user t)
 325         (gnus-large-newsgroup nil))
 326     (while newsrc
 327       (gnus-summary-read-group (car (car newsrc)))
 328       (if (not (eq major-mode 'gnus-summary-mode))
 329           ()
 330         (while gnus-newsgroup-unreads
 331           (gnus-summary-select-article t t nil (car gnus-newsgroup-unreads))
 332           (setq gnus-newsgroup-unreads (cdr gnus-newsgroup-unreads)))
 333         (kill-buffer (current-buffer)))
 334       (setq newsrc (cdr newsrc)))))
 335
 336 (provide 'gnus-cache)
 337
 338 ;;; gnus-cache.el ends here