1 ;;; nnvirtual.el --- virtual newsgroups access for Gnus
2 ;; Copyright (C) 1994,95,96 Free Software Foundation, Inc.
4 ;; Author: Lars Magne Ingebrigtsen <larsi@ifi.uio.no>
5 ;; Masanobu UMEDA <umerin@flab.flab.fujitsu.junet>
8 ;; This file is part of GNU Emacs.
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)
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.
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.
27 ;; The other access methods (nntp, nnspool, etc) are general news
28 ;; access methods. This module relies on Gnus and can not be used
36 (eval-when-compile (require 'cl))
38 (defvar nnvirtual-always-rescan nil
39 "*If non-nil, always scan groups for unread articles when entering a group.
40 If this variable is nil (which is the default) and you read articles
41 in a component group after the virtual group has been activated, the
42 read articles from the component group will show up when you enter the
47 (defconst nnvirtual-version "nnvirtual 1.0"
48 "Version number of this version of nnvirtual.")
50 (defvar nnvirtual-group-alist nil)
51 (defvar nnvirtual-current-group nil)
52 (defvar nnvirtual-component-groups nil)
53 (defvar nnvirtual-mapping nil)
55 (defvar nnvirtual-status-string "")
58 (autoload 'gnus-cache-articles-in-group "gnus-cache"))
62 ;;; Interface functions.
64 (defun nnvirtual-retrieve-headers (articles &optional newsgroup server fetch-old)
65 (when (nnvirtual-possibly-change-group newsgroup server t)
67 (if (stringp (car articles))
69 (let ((vbuf (nnheader-set-temp-buffer
70 (get-buffer-create " *virtual headers*")))
71 (unfetched (mapcar (lambda (g) (list g))
72 nnvirtual-component-groups))
73 (system-name (system-name))
74 cgroup article result prefix)
76 (setq article (assq (pop articles) nnvirtual-mapping))
77 (when (and (setq cgroup (cadr article))
79 (gnus-find-method-for-group cgroup) t)
80 (gnus-request-group cgroup t))
81 (setq prefix (gnus-group-real-prefix cgroup))
82 (when (setq result (gnus-retrieve-headers
83 (list (caddr article)) cgroup nil))
84 (set-buffer nntp-server-buffer)
85 (if (zerop (buffer-size))
86 (nconc (assq cgroup unfetched) (list (caddr article)))
87 ;; If we got HEAD headers, we convert them into NOV
88 ;; headers. This is slow, inefficient and, come to think
89 ;; of it, downright evil. So sue me. I couldn't be
90 ;; bothered to write a header parse routine that could
91 ;; parse a mixed HEAD/NOV buffer.
92 (when (eq result 'headers)
93 (nnvirtual-convert-headers))
94 (goto-char (point-min))
97 (point) (progn (read nntp-server-buffer) (point)))
98 (princ (car article) (current-buffer))
101 "[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t")
102 (goto-char (match-end 0))
104 "\t" (save-excursion (end-of-line) (point)) t)
106 (while (= (char-after (1- (point))) ? )
112 (or (= (char-after (1- (point))) ?\t)
114 (insert "Xref: " system-name " " cgroup ":")
115 (princ (caddr article) (current-buffer))
117 (insert "Xref: " system-name " " cgroup ":")
118 (princ (caddr article) (current-buffer))
120 (if (not (string= "" prefix))
121 (while (re-search-forward
123 (save-excursion (end-of-line) (point)) t)
125 (goto-char (match-beginning 0))
128 (or (= (char-after (1- (point))) ?\t)
132 (goto-char (point-max))
133 (insert-buffer-substring nntp-server-buffer)))))
135 ;; In case some of the articles have expired or been
136 ;; cancelled, we have to mark them as read in the
139 (when (cdar unfetched)
140 (gnus-group-make-articles-read
141 (caar unfetched) (sort (cdar unfetched) '<)))
142 (setq unfetched (cdr unfetched)))
144 ;; The headers are ready for reading, so they are inserted into
145 ;; the nntp-server-buffer, which is where Gnus expects to find
149 (set-buffer nntp-server-buffer)
151 (insert-buffer-substring vbuf)
153 (kill-buffer vbuf)))))))
155 (defun nnvirtual-open-server (server &optional something)
156 (nnheader-init-server-buffer))
158 (defun nnvirtual-close-server (&rest dum)
161 (defun nnvirtual-request-close ()
162 (setq nnvirtual-current-group nil
163 nnvirtual-component-groups nil
164 nnvirtual-mapping nil
165 nnvirtual-group-alist nil)
168 (defun nnvirtual-server-opened (&optional server)
169 (and nntp-server-buffer
170 (get-buffer nntp-server-buffer)))
172 (defun nnvirtual-status-message (&optional server)
173 nnvirtual-status-string)
175 (defun nnvirtual-request-article (article &optional group server buffer)
176 (when (and (nnvirtual-possibly-change-group group server t)
178 (let* ((amap (assq article nnvirtual-mapping))
179 (cgroup (cadr amap)))
182 (nnheader-report 'nnvirtual "No such article: %s" article))
183 ((not (gnus-check-group cgroup))
185 'nnvirtual "Can't open server where %s exists" cgroup))
186 ((not (gnus-request-group cgroup t))
187 (nnheader-report 'nnvirtual "Can't open component group %s" cgroup))
192 (gnus-request-article-this-buffer (caddr amap) cgroup))
193 (gnus-request-article (caddr amap) cgroup)))))))
195 (defun nnvirtual-request-group (group &optional server dont-check)
197 ((null (nnvirtual-possibly-change-group
199 (if nnvirtual-always-rescan nil (not dont-check))))
200 (setq nnvirtual-current-group nil)
201 (nnheader-report 'nnvirtual "No component groups in %s" group))
203 (let ((len (length nnvirtual-mapping)))
204 (nnheader-insert "211 %d 1 %d %s\n" len len group)))))
206 (defun nnvirtual-request-type (group &optional article)
207 (when (nnvirtual-possibly-change-group group nil t)
210 (let ((mart (assq article nnvirtual-mapping)))
212 (gnus-request-type (cadr mart) (car mart)))))))
214 (defun nnvirtual-request-update-mark (group article mark)
215 (when (nnvirtual-possibly-change-group group nil t)
216 (let* ((nart (assq article nnvirtual-mapping))
218 ;; The component group might be a virtual group.
219 (nmark (gnus-request-update-mark cgroup (caddr nart) mark)))
220 (when (and (= mark nmark)
221 (gnus-group-auto-expirable-p cgroup))
222 (setq mark gnus-expirable-mark))))
225 (defun nnvirtual-close-group (group &optional server)
226 (when (nnvirtual-possibly-change-group group server t)
227 ;; Copy (un)read articles.
228 (nnvirtual-update-reads)
229 ;; We copy the marks from this group to the component
231 (nnvirtual-update-marked))
234 (defun nnvirtual-request-list (&optional server)
235 (nnheader-report 'nnvirtual "LIST is not implemented."))
237 (defun nnvirtual-request-newgroups (date &optional server)
238 (nnheader-report 'nnvirtual "NEWGROUPS is not supported."))
240 (defun nnvirtual-request-list-newsgroups (&optional server)
241 (nnheader-report 'nnvirtual "LIST NEWSGROUPS is not implemented."))
243 (defun nnvirtual-request-update-info (group info &optional server)
244 (when (nnvirtual-possibly-change-group group server)
245 (let ((map nnvirtual-mapping)
246 (marks (mapcar (lambda (m) (list (cdr m))) gnus-article-mark-lists))
248 ;; Go through the mapping.
250 (unless (nth 3 (setq m (pop map)))
252 (push (car m) reads))
254 (when (setq mr (nth 4 m))
256 (setcdr (setq op (assq (pop mr) marks)) (cons (car m) (cdr op))))))
257 ;; Compress the marks and the reads.
260 (setcdr (car mr) (gnus-compress-sequence (sort (cdr (pop mr)) '<))))
261 (setcar (cddr info) (gnus-compress-sequence (nreverse reads)))
262 ;; Remove empty marks lists.
263 (while (and marks (not (cdar marks)))
264 (setq marks (cdr marks)))
269 (setcdr mr (cddr mr))))
271 ;; Enter these new marks into the info of the group.
273 (setcar (nthcdr 3 info) marks)
274 ;; Add the marks lists to the end of the info.
276 (setcdr (nthcdr 2 info) (list marks))))
279 (defun nnvirtual-catchup-group (group &optional server all)
280 (nnvirtual-possibly-change-group group server t)
281 (let ((gnus-group-marked nnvirtual-component-groups)
282 (gnus-expert-user t))
283 ;; Make sure all groups are activated.
286 (when (not (numberp (car (gnus-gethash g gnus-newsrc-hashtb))))
287 (gnus-activate-group g)))
288 nnvirtual-component-groups)
290 (set-buffer gnus-group-buffer)
291 (gnus-group-catchup-current nil all))))
293 (defun nnvirtual-find-group-art (group article)
294 "Return the real group and article for virtual GROUP and ARTICLE."
295 (nnvirtual-possibly-change-group group nil t)
296 (let ((mart (assq article nnvirtual-mapping)))
298 (cons (cadr mart) (caddr mart)))))
301 ;;; Internal functions.
303 (defun nnvirtual-convert-headers ()
304 "Convert HEAD headers into NOV headers."
306 (set-buffer nntp-server-buffer)
307 (let* ((dependencies (make-vector 100 0))
308 (headers (gnus-get-newsgroup-headers dependencies))
311 (while (setq header (pop headers))
312 (insert (int-to-string (mail-header-number header)) "\t"
313 (or (mail-header-subject header) "") "\t"
314 (or (mail-header-from header) "") "\t"
315 (or (mail-header-date header) "") "\t"
316 (or (mail-header-id header) "") "\t"
317 (or (mail-header-references header) "") "\t"
318 (int-to-string (or (mail-header-chars header) 0)) "\t"
319 (int-to-string (or (mail-header-lines header) 0)) "\t"
320 (if (mail-header-xref header)
321 (concat "Xref: " (mail-header-xref header) "\t")
324 (defun nnvirtual-possibly-change-group (group regexp &optional check)
326 (when (or (not (equal group nnvirtual-current-group))
328 (and (setq inf (assoc group nnvirtual-group-alist))
330 (string= (nth 3 inf) regexp)
332 (setq nnvirtual-current-group (car inf))
333 (setq nnvirtual-component-groups (nth 1 inf))
334 (setq nnvirtual-mapping (nth 2 inf))))
335 (when (and regexp (not inf))
336 (and inf (setq nnvirtual-group-alist
337 (delq inf nnvirtual-group-alist)))
338 (setq nnvirtual-mapping nil)
339 (setq nnvirtual-current-group group)
340 (let ((newsrc gnus-newsrc-alist)
341 (virt-group (gnus-group-prefixed-name
342 nnvirtual-current-group '(nnvirtual ""))))
343 (setq nnvirtual-component-groups nil)
345 (and (string-match regexp (caar newsrc))
346 (not (string= (caar newsrc) virt-group))
347 (setq nnvirtual-component-groups
349 (delete (caar newsrc)
350 nnvirtual-component-groups))))
351 (setq newsrc (cdr newsrc))))
352 (if nnvirtual-component-groups
354 (nnvirtual-create-mapping)
355 (setq nnvirtual-group-alist
356 (cons (list group nnvirtual-component-groups
357 nnvirtual-mapping regexp)
358 nnvirtual-group-alist)))
359 (nnheader-report 'nnvirtual "No component groups: %s" group)))))
360 nnvirtual-component-groups)
362 (defun nnvirtual-update-marked ()
363 "Copy marks from the virtual group to the component groups."
364 (let ((mark-lists gnus-article-mark-lists)
365 (marks (gnus-info-marks (gnus-get-info
367 nnvirtual-current-group))))
368 type list mart cgroups)
369 (while (setq type (cdr (pop mark-lists)))
370 (setq list (gnus-uncompress-range (cdr (assq type marks))))
372 (mapcar (lambda (g) (list g)) nnvirtual-component-groups))
374 (nconc (assoc (cadr (setq mart (assq (pop list) nnvirtual-mapping)))
376 (list (caddr mart))))
378 (gnus-add-marked-articles
379 (caar cgroups) type (cdar cgroups) nil t)
380 (gnus-group-update-group (car (pop cgroups)) t)))))
382 (defun nnvirtual-update-reads ()
383 "Copy (un)reads from the current group to the component groups."
384 (let ((groups (mapcar (lambda (g) (list g)) nnvirtual-component-groups))
385 (articles (gnus-list-of-unread-articles
386 (concat "nnvirtual:" nnvirtual-current-group)))
389 (setq m (assq (pop articles) nnvirtual-mapping))
390 (nconc (assoc (nth 1 m) groups) (list (nth 2 m))))
392 (gnus-update-read-articles (caar groups) (cdr (pop groups))))))
394 (defsubst nnvirtual-marks (article marks)
395 "Return a list of mark types for ARTICLE."
398 (when (memq article (cdar marks))
399 (push (caar marks) out))
400 (setq marks (cdr marks)))
403 (defun nnvirtual-create-mapping ()
404 "Create an article mapping for the current group."
406 m marks list article unreads marks active
412 (when (setq active (gnus-activate-group g))
413 (setq unreads (gnus-list-of-unread-articles g)
414 marks (gnus-uncompress-marks
415 (gnus-info-marks (gnus-get-info g))))
417 (push (cons 'cache (gnus-cache-articles-in-group g))
419 (setq div (/ (float (car active))
420 (if (zerop (cdr active))
423 (list (* div (- n (car active)))
424 g n (and (memq n unreads) t)
425 (inline (nnvirtual-marks n marks))))
426 (gnus-uncompress-range active))))
427 nnvirtual-component-groups))
429 (< (car m1) (car m2)))))
431 (setq nnvirtual-mapping map)
432 ;; Set the virtual article numbers.
433 (while (setq m (pop map))
434 (setcar m (setq article (incf i))))))
438 ;;; nnvirtual.el ends here