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

   1 ;;; nnmh.el --- mhspool access for Gnus
   2 ;; Copyright (C) 1995,96 Free Software Foundation, Inc.
   3
   4 ;; Author: Lars Magne Ingebrigtsen <larsi@ifi.uio.no>
   5 ;;      Masanobu UMEDA <umerin@flab.flab.fujitsu.junet>
   6 ;; Keywords: news, mail
   7
   8 ;; This file is part of GNU Emacs.
   9
  10 ;; GNU Emacs 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)
  13 ;; any later version.
  14
  15 ;; GNU Emacs 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.
  19
  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.
  24
  25 ;;; Commentary:
  26
  27 ;; Based on nnspool.el by Masanobu UMEDA <umerin@flab.flab.fujitsu.junet>.
  28 ;; For an overview of what the interface functions do, please see the
  29 ;; Gnus sources.
  30
  31 ;;; Code:
  32
  33 (require 'nnheader)
  34 (require 'nnmail)
  35 (require 'gnus-start)
  36 (require 'nnoo)
  37 (require 'cl)
  38
  39 (nnoo-declare nnmh)
  40
  41 (defvoo nnmh-directory message-directory
  42   "*Mail spool directory.")
  43
  44 (defvoo nnmh-get-new-mail t
  45   "*If non-nil, nnmh will check the incoming mail file and split the mail.")
  46
  47 (defvoo nnmh-prepare-save-mail-hook nil
  48   "*Hook run narrowed to an article before saving.")
  49
  50 (defvoo nnmh-be-safe nil
  51   "*If non-nil, nnmh will check all articles to make sure whether they are new or not.")
  52
  53 \f
  54
  55 (defconst nnmh-version "nnmh 1.0"
  56   "nnmh version.")
  57
  58 (defvoo nnmh-current-directory nil
  59   "Current news group directory.")
  60
  61 (defvoo nnmh-status-string "")
  62 (defvoo nnmh-group-alist nil)
  63
  64 \f
  65
  66 ;;; Interface functions.
  67
  68 (nnoo-define-basics nnmh)
  69
  70 (deffoo nnmh-retrieve-headers (articles &optional newsgroup server fetch-old)
  71   (save-excursion
  72     (set-buffer nntp-server-buffer)
  73     (erase-buffer)
  74     (let* ((file nil)
  75            (number (length articles))
  76            (large (and (numberp nnmail-large-newsgroup)
  77                        (> number nnmail-large-newsgroup)))
  78            (count 0)
  79            beg article)
  80       (nnmh-possibly-change-directory newsgroup server)
  81       ;; We don't support fetching by Message-ID.
  82       (if (stringp (car articles))
  83           'headers
  84         (while articles
  85           (when (and (file-exists-p
  86                       (setq file (concat (file-name-as-directory
  87                                           nnmh-current-directory)
  88                                          (int-to-string
  89                                           (setq article (pop articles))))))
  90                      (not (file-directory-p file)))
  91             (insert (format "221 %d Article retrieved.\n" article))
  92             (setq beg (point))
  93             (nnheader-insert-head file)
  94             (goto-char beg)
  95             (if (search-forward "\n\n" nil t)
  96                 (forward-char -1)
  97               (goto-char (point-max))
  98               (insert "\n\n"))
  99             (insert ".\n")
 100             (delete-region (point) (point-max)))
 101           (setq count (1+ count))
 102
 103           (and large
 104                (zerop (% count 20))
 105                (message "nnmh: Receiving headers... %d%%"
 106                         (/ (* count 100) number))))
 107
 108         (and large (message "nnmh: Receiving headers...done"))
 109
 110         (nnheader-fold-continuation-lines)
 111         'headers))))
 112
 113 (deffoo nnmh-open-server (server &optional defs)
 114   (nnoo-change-server 'nnmh server defs)
 115   (when (not (file-exists-p nnmh-directory))
 116     (condition-case ()
 117         (make-directory nnmh-directory t)
 118       (error t)))
 119   (cond
 120    ((not (file-exists-p nnmh-directory))
 121     (nnmh-close-server)
 122     (nnheader-report 'nnmh "Couldn't create directory: %s" nnmh-directory))
 123    ((not (file-directory-p (file-truename nnmh-directory)))
 124     (nnmh-close-server)
 125     (nnheader-report 'nnmh "Not a directory: %s" nnmh-directory))
 126    (t
 127     (nnheader-report 'nnmh "Opened server %s using directory %s"
 128                      server nnmh-directory)
 129     t)))
 130
 131 (deffoo nnmh-request-article (id &optional newsgroup server buffer)
 132   (nnmh-possibly-change-directory newsgroup server)
 133   (let ((file (if (stringp id)
 134                   nil
 135                 (concat nnmh-current-directory (int-to-string id))))
 136         (nntp-server-buffer (or buffer nntp-server-buffer)))
 137     (and (stringp file)
 138          (file-exists-p file)
 139          (not (file-directory-p file))
 140          (save-excursion (nnmail-find-file file))
 141          (string-to-int (file-name-nondirectory file)))))
 142
 143 (deffoo nnmh-request-group (group &optional server dont-check)
 144   (let ((pathname (nnmail-group-pathname group nnmh-directory))
 145         dir)
 146     (cond
 147      ((not (file-directory-p pathname))
 148       (nnheader-report
 149        'nnmh "Can't select group (no such directory): %s" group))
 150      (t
 151       (setq nnmh-current-directory pathname)
 152       (and nnmh-get-new-mail
 153            nnmh-be-safe
 154            (nnmh-update-gnus-unreads group))
 155       (cond
 156        (dont-check
 157         (nnheader-report 'nnmh "Selected group %s" group)
 158         t)
 159        (t
 160         ;; Re-scan the directory if it's on a foreign system.
 161         (nnheader-re-read-dir pathname)
 162         (setq dir
 163               (sort
 164                (mapcar (lambda (name) (string-to-int name))
 165                        (directory-files pathname nil "^[0-9]+$" t))
 166                '<))
 167           (cond
 168            (dir
 169             (nnheader-report 'nnmh "Selected group %s" group)
 170             (nnheader-insert
 171              "211 %d %d %d %s\n" (length dir) (car dir)
 172              (progn (while (cdr dir) (setq dir (cdr dir))) (car dir))
 173              group))
 174            (t
 175             (nnheader-report 'nnmh "Empty group %s" group)
 176             (nnheader-insert (format "211 0 1 0 %s\n" group))))))))))
 177
 178 (deffoo nnmh-request-scan (&optional group server)
 179   (nnmail-get-new-mail 'nnmh nil nnmh-directory group))
 180
 181 (deffoo nnmh-request-list (&optional server dir)
 182   (nnheader-insert "")
 183   (let ((nnmh-toplev
 184          (or dir (file-truename (file-name-as-directory nnmh-directory)))))
 185     (nnmh-request-list-1 nnmh-toplev))
 186   (setq nnmh-group-alist (nnmail-get-active))
 187   t)
 188
 189 (defvar nnmh-toplev)
 190 (defun nnmh-request-list-1 (dir)
 191   (setq dir (expand-file-name dir))
 192   ;; Recurse down all directories.
 193   (let ((dirs (and (file-readable-p dir)
 194                    (> (nth 1 (file-attributes (file-chase-links dir))) 2)
 195                    (directory-files dir t nil t)))
 196         dir)
 197     ;; Recurse down directories.
 198     (while (setq dir (pop dirs))
 199       (when (and (not (member (file-name-nondirectory dir) '("." "..")))
 200                  (file-directory-p dir)
 201                  (file-readable-p dir))
 202         (nnmh-request-list-1 dir))))
 203   ;; For each directory, generate an active file line.
 204   (unless (string= (expand-file-name nnmh-toplev) dir)
 205     (let ((files (mapcar
 206                   (lambda (name) (string-to-int name))
 207                   (directory-files dir nil "^[0-9]+$" t))))
 208       (when files
 209         (save-excursion
 210           (set-buffer nntp-server-buffer)
 211           (goto-char (point-max))
 212           (insert
 213            (format
 214             "%s %d %d y\n"
 215             (progn
 216               (string-match
 217                (regexp-quote
 218                 (file-truename (file-name-as-directory
 219                                 (expand-file-name nnmh-toplev)))) dir)
 220               (nnheader-replace-chars-in-string
 221                (substring dir (match-end 0)) ?/ ?.))
 222             (apply 'max files)
 223             (apply 'min files)))))))
 224   t)
 225
 226 (deffoo nnmh-request-newgroups (date &optional server)
 227   (nnmh-request-list server))
 228
 229 (deffoo nnmh-request-expire-articles (articles newsgroup &optional server force)
 230   (nnmh-possibly-change-directory newsgroup server)
 231   (let* ((active-articles
 232           (mapcar
 233            (function
 234             (lambda (name)
 235               (string-to-int name)))
 236            (directory-files nnmh-current-directory nil "^[0-9]+$" t)))
 237          (is-old t)
 238          article rest mod-time)
 239     (nnmail-activate 'nnmh)
 240
 241     (while (and articles is-old)
 242       (setq article (concat nnmh-current-directory
 243                             (int-to-string (car articles))))
 244       (if (setq mod-time (nth 5 (file-attributes article)))
 245           (if (and (nnmh-deletable-article-p newsgroup (car articles))
 246                    (setq is-old
 247                          (nnmail-expired-article-p newsgroup mod-time force)))
 248               (progn
 249                 (nnheader-message 5 "Deleting article %s in %s..."
 250                                   article newsgroup)
 251                 (condition-case ()
 252                     (funcall nnmail-delete-file-function article)
 253                   (file-error
 254                    (nnheader-message 1 "Couldn't delete article %s in %s"
 255                                      article newsgroup)
 256                    (setq rest (cons (car articles) rest)))))
 257             (setq rest (cons (car articles) rest))))
 258       (setq articles (cdr articles)))
 259     (message "")
 260     (nconc rest articles)))
 261
 262 (deffoo nnmh-close-group (group &optional server)
 263   t)
 264
 265 (deffoo nnmh-request-move-article
 266   (article group server accept-form &optional last)
 267   (let ((buf (get-buffer-create " *nnmh move*"))
 268         result)
 269     (and
 270      (nnmh-deletable-article-p group article)
 271      (nnmh-request-article article group server)
 272      (save-excursion
 273        (set-buffer buf)
 274        (insert-buffer-substring nntp-server-buffer)
 275        (setq result (eval accept-form))
 276        (kill-buffer (current-buffer))
 277        result)
 278      (progn
 279        (nnmh-possibly-change-directory group server)
 280        (condition-case ()
 281            (funcall nnmail-delete-file-function
 282                     (concat nnmh-current-directory (int-to-string article)))
 283          (file-error nil))))
 284     result))
 285
 286 (deffoo nnmh-request-accept-article (group &optional server last noinsert)
 287   (nnmh-possibly-change-directory group server)
 288   (nnmail-check-syntax)
 289   (if (stringp group)
 290       (and
 291        (nnmail-activate 'nnmh)
 292        (car (nnmh-save-mail
 293              (list (cons group (nnmh-active-number group)))
 294              noinsert)))
 295     (and
 296      (nnmail-activate 'nnmh)
 297      (car (nnmh-save-mail (nnmail-article-group 'nnmh-active-number)
 298                           noinsert)))))
 299
 300 (deffoo nnmh-request-replace-article (article group buffer)
 301   (nnmh-possibly-change-directory group)
 302   (save-excursion
 303     (set-buffer buffer)
 304     (nnmh-possibly-create-directory group)
 305     (condition-case ()
 306         (progn
 307           (nnmail-write-region
 308            (point-min) (point-max)
 309            (concat nnmh-current-directory (int-to-string article))
 310            nil (if (nnheader-be-verbose 5) nil 'nomesg))
 311           t)
 312       (error nil))))
 313
 314 (deffoo nnmh-request-create-group (group &optional server)
 315   (nnmail-activate 'nnmh)
 316   (unless (assoc group nnmh-group-alist)
 317     (let (active)
 318       (push (list group (setq active (cons 1 0)))
 319             nnmh-group-alist)
 320       (nnmh-possibly-create-directory group)
 321       (nnmh-possibly-change-directory group server)
 322       (let ((articles (mapcar
 323                        (lambda (file)
 324                          (string-to-int file))
 325                        (directory-files
 326                         nnmh-current-directory nil "^[0-9]+$"))))
 327         (when articles
 328           (setcar active (apply 'min articles))
 329           (setcdr active (apply 'max articles))))))
 330   t)
 331
 332 (deffoo nnmh-request-delete-group (group &optional force server)
 333   (nnmh-possibly-change-directory group server)
 334   ;; Delete all articles in GROUP.
 335   (if (not force)
 336       ()                                ; Don't delete the articles.
 337     (let ((articles (directory-files nnmh-current-directory t "^[0-9]+$")))
 338       (while articles
 339         (and (file-writable-p (car articles))
 340              (progn
 341                (nnheader-message 5 "Deleting article %s in %s..."
 342                                  (car articles) group)
 343                (funcall nnmail-delete-file-function (car articles))))
 344         (setq articles (cdr articles))))
 345     ;; Try to delete the directory itself.
 346     (condition-case ()
 347         (delete-directory nnmh-current-directory)
 348       (error nil)))
 349   ;; Remove the group from all structures.
 350   (setq nnmh-group-alist
 351         (delq (assoc group nnmh-group-alist) nnmh-group-alist)
 352         nnmh-current-directory nil)
 353   t)
 354
 355 (deffoo nnmh-request-rename-group (group new-name &optional server)
 356   (nnmh-possibly-change-directory group server)
 357   (let ((new-dir (nnmail-group-pathname new-name nnmh-directory))
 358         (old-dir (nnmail-group-pathname group nnmh-directory)))
 359     (when (condition-case ()
 360               (progn
 361                 (make-directory new-dir t)
 362                 t)
 363             (error nil))
 364       ;; We move the articles file by file instead of renaming
 365       ;; the directory -- there may be subgroups in this group.
 366       ;; One might be more clever, I guess.
 367       (let ((files (nnheader-article-to-file-alist old-dir)))
 368         (while files
 369           (rename-file
 370            (concat old-dir (cdar files))
 371            (concat new-dir (cdar files)))
 372           (pop files)))
 373       (when (<= (length (directory-files old-dir)) 2)
 374         (condition-case ()
 375             (delete-directory old-dir)
 376           (error nil)))
 377       ;; That went ok, so we change the internal structures.
 378       (let ((entry (assoc group nnmh-group-alist)))
 379         (and entry (setcar entry new-name))
 380         (setq nnmh-current-directory nil)
 381         t))))
 382
 383 \f
 384 ;;; Internal functions.
 385
 386 (defun nnmh-possibly-change-directory (newsgroup &optional server)
 387   (when (and server
 388              (not (nnmh-server-opened server)))
 389     (nnmh-open-server server))
 390   (if newsgroup
 391       (let ((pathname (nnmail-group-pathname newsgroup nnmh-directory)))
 392         (if (file-directory-p pathname)
 393             (setq nnmh-current-directory pathname)
 394           (error "No such newsgroup: %s" newsgroup)))))
 395
 396 (defun nnmh-possibly-create-directory (group)
 397   (let (dir dirs)
 398     (setq dir (nnmail-group-pathname group nnmh-directory))
 399     (while (not (file-directory-p dir))
 400       (setq dirs (cons dir dirs))
 401       (setq dir (file-name-directory (directory-file-name dir))))
 402     (while dirs
 403       (if (make-directory (directory-file-name (car dirs)))
 404           (error "Could not create directory %s" (car dirs)))
 405       (nnheader-message 5 "Creating mail directory %s" (car dirs))
 406       (setq dirs (cdr dirs)))))
 407
 408 (defun nnmh-save-mail (group-art &optional noinsert)
 409   "Called narrowed to an article."
 410   (unless noinsert
 411     (nnmail-insert-lines)
 412     (nnmail-insert-xref group-art))
 413   (run-hooks 'nnmail-prepare-save-mail-hook)
 414   (run-hooks 'nnmh-prepare-save-mail-hook)
 415   (goto-char (point-min))
 416   (while (looking-at "From ")
 417     (replace-match "X-From-Line: ")
 418     (forward-line 1))
 419   ;; We save the article in all the newsgroups it belongs in.
 420   (let ((ga group-art)
 421         first)
 422     (while ga
 423       (nnmh-possibly-create-directory (caar ga))
 424       (let ((file (concat (nnmail-group-pathname
 425                            (caar ga) nnmh-directory)
 426                           (int-to-string (cdar ga)))))
 427         (if first
 428             ;; It was already saved, so we just make a hard link.
 429             (funcall nnmail-crosspost-link-function first file t)
 430           ;; Save the article.
 431           (nnmail-write-region (point-min) (point-max) file nil nil)
 432           (setq first file)))
 433       (setq ga (cdr ga))))
 434   group-art)
 435
 436 (defun nnmh-active-number (group)
 437   "Compute the next article number in GROUP."
 438   (let ((active (cadr (assoc group nnmh-group-alist))))
 439     (unless active
 440       ;; The group wasn't known to nnmh, so we just create an active
 441       ;; entry for it.
 442       (setq active (cons 1 0))
 443       (push (list group active) nnmh-group-alist)
 444       ;; Find the highest number in the group.
 445       (let ((files (sort
 446                     (mapcar
 447                      (lambda (f)
 448                        (string-to-int f))
 449                      (directory-files
 450                       (nnmail-group-pathname group nnmh-directory)
 451                       nil "^[0-9]+$")
 452                      '>))))
 453         (when files
 454           (setcdr active (car files)))))
 455     (setcdr active (1+ (cdr active)))
 456     (while (file-exists-p
 457             (concat (nnmail-group-pathname group nnmh-directory)
 458                     (int-to-string (cdr active))))
 459       (setcdr active (1+ (cdr active))))
 460     (cdr active)))
 461
 462 (defun nnmh-update-gnus-unreads (group)
 463   ;; Go through the .nnmh-articles file and compare with the actual
 464   ;; articles in this folder. The articles that are "new" will be
 465   ;; marked as unread by Gnus.
 466   (let* ((dir nnmh-current-directory)
 467          (files (sort (mapcar (function (lambda (name) (string-to-int name)))
 468                               (directory-files nnmh-current-directory
 469                                                nil "^[0-9]+$" t)) '<))
 470          (nnmh-file (concat dir ".nnmh-articles"))
 471          new articles)
 472     ;; Load the .nnmh-articles file.
 473     (when (file-exists-p nnmh-file)
 474       (setq articles
 475             (let (nnmh-newsgroup-articles)
 476               (condition-case nil (load nnmh-file nil t t) (error nil))
 477               nnmh-newsgroup-articles)))
 478     ;; Add all new articles to the `new' list.
 479     (let ((art files))
 480       (while art
 481         (unless (assq (car art) articles)
 482           (setq new (cons (car art) new)))
 483         (setq art (cdr art))))
 484     ;; Remove all deleted articles.
 485     (let ((art articles))
 486       (while art
 487         (unless (memq (caar art) files)
 488           (setq articles (delq (car art) articles)))
 489         (setq art (cdr art))))
 490     ;; Check whether the articles really are the ones that Gnus thinks
 491     ;; they are by looking at the time-stamps.
 492     (let ((arts articles)
 493           art)
 494       (while (setq art (pop arts))
 495         (when (not (equal
 496                     (nth 5 (file-attributes
 497                             (concat dir (int-to-string (car art)))))
 498                     (cdr art)))
 499           (setq articles (delq art articles))
 500           (push (car art) new))))
 501     ;; Go through all the new articles and add them, and their
 502     ;; time-stamps, to the list.
 503     (setq articles
 504           (nconc articles
 505                  (mapcar
 506                   (lambda (art)
 507                     (cons art
 508                           (nth 5 (file-attributes
 509                                   (concat dir (int-to-string art))))))
 510                   new)))
 511     ;; Make Gnus mark all new articles as unread.
 512     (when new
 513       (gnus-make-articles-unread
 514        (gnus-group-prefixed-name group (list 'nnmh ""))
 515        (setq new (sort new '<))))
 516     ;; Sort the article list with highest numbers first.
 517     (setq articles (sort articles (lambda (art1 art2)
 518                                     (> (car art1) (car art2)))))
 519     ;; Finally write this list back to the .nnmh-articles file.
 520     (nnheader-temp-write nnmh-file
 521       (insert ";; Gnus article active file for " group "\n\n")
 522       (insert "(setq nnmh-newsgroup-articles '")
 523       (gnus-prin1 articles)
 524       (insert ")\n"))))
 525
 526 (defun nnmh-deletable-article-p (group article)
 527   "Say whether ARTICLE in GROUP can be deleted."
 528   (let ((path (concat nnmh-current-directory (int-to-string article))))
 529     (and (file-writable-p path)
 530          (or (not nnmail-keep-last-article)
 531              (not (eq (cdr (nth 1 (assoc group nnmh-group-alist)))
 532                       article))))))
 533
 534 (provide 'nnmh)
 535
 536 ;;; nnmh.el ends here