1 ;;; nnvirtual.el --- virtual newsgroups access for Gnus
2 ;; Copyright (C) 1994,95 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
22 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
26 ;; The other access methods (nntp, nnspool, etc) are general news
27 ;; access methods. This module relies on Gnus and can not be used
38 (defconst nnvirtual-version "nnvirtual 1.0"
39 "Version number of this version of nnvirtual.")
41 (defvar nnvirtual-group-alist nil)
42 (defvar nnvirtual-current-group nil)
43 (defvar nnvirtual-current-groups nil)
44 (defvar nnvirtual-current-mapping nil)
46 (defvar nnvirtual-do-not-open nil)
48 (defvar nnvirtual-status-string "")
52 ;;; Interface functions.
54 (defun nnvirtual-retrieve-headers (sequence &optional newsgroup server fetch-old)
55 "Retrieve the headers for the articles in SEQUENCE."
56 (nnvirtual-possibly-change-newsgroups newsgroup server t)
58 (set-buffer (get-buffer-create "*virtual headers*"))
59 (buffer-disable-undo (current-buffer))
61 (if (stringp (car sequence))
63 (let ((map nnvirtual-current-mapping)
65 articles beg group active top article result prefix
66 fetched-articles group-method)
68 (while (< (car (car map)) (car sequence))
69 (setq offset (car (car map)))
71 (setq top (car (car map)))
72 (setq group (nth 1 (car map)))
73 (setq prefix (gnus-group-real-prefix group))
74 (setq active (nth 2 (car map)))
76 (while (and sequence (<= (car sequence) top))
77 (setq articles (cons (- (+ active (car sequence)) offset)
79 (setq sequence (cdr sequence)))
80 (setq articles (nreverse articles))
85 (gnus-find-method-for-group group))
86 (and (or (gnus-server-opened group-method)
87 (gnus-open-server group-method))
88 (gnus-request-group group t)
89 (gnus-retrieve-headers articles group)))))
91 (set-buffer nntp-server-buffer)
92 ;; If we got HEAD headers, we convert them into NOV
93 ;; headers. This is slow, inefficient and, come to think
94 ;; of it, downright evil. So sue me. I couldn't be
95 ;; bothered to write a header parse routine that could
96 ;; parse a mixed HEAD/NOV buffer.
97 (and (eq result 'headers) (nnvirtual-convert-headers))
98 (goto-char (point-min))
99 (setq fetched-articles nil)
102 article (read nntp-server-buffer)
103 fetched-articles (cons article fetched-articles))
104 (delete-region beg (point))
105 (insert (int-to-string (+ (- article active) offset)))
108 "[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t[^\t]*\t")
109 (goto-char (match-end 0))
111 "\t" (save-excursion (end-of-line) (point)) t)
113 (while (= (char-after (1- (point))) ? )
119 (or (= (char-after (1- (point))) ?\t)
121 (insert (format "Xref: %s %s:%d\t" (system-name)
123 (if (not (string= "" prefix))
124 (while (re-search-forward
126 (save-excursion (end-of-line) (point)) t)
128 (goto-char (match-beginning 0))
131 (or (= (char-after (1- (point))) ?\t)
134 (goto-char (point-max))
135 (insert-buffer-substring nntp-server-buffer)
136 ;; We have now massaged and inserted the headers from one
137 ;; group. In case some of the articles have expired or been
138 ;; cancelled, we have to mark them as read in the component
140 (let ((unfetched (gnus-sorted-complement
141 articles (nreverse fetched-articles))))
143 (gnus-group-make-articles-read group 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 "*virtual headers*")
153 (kill-buffer (current-buffer)))))))
155 (defun nnvirtual-open-server (newsgroups &optional something)
156 "Open a virtual newsgroup that contains NEWSGROUPS."
157 (nnheader-init-server-buffer))
159 (defun nnvirtual-close-server (&rest dum)
163 (defun nnvirtual-request-close ()
164 (setq nnvirtual-current-group nil
165 nnvirtual-current-groups nil
166 nnvirtual-current-mapping nil
167 nnvirtual-group-alist nil)
170 (defun nnvirtual-server-opened (&optional server)
171 "Return server process status, T or NIL.
172 If the stream is opened, return T, otherwise return NIL."
173 (and nntp-server-buffer
174 (get-buffer nntp-server-buffer)))
176 (defun nnvirtual-status-message (&optional server)
177 "Return server status response as string."
178 nnvirtual-status-string)
180 (defun nnvirtual-request-article (article &optional newsgroup server buffer)
181 "Select article by message number."
182 (nnvirtual-possibly-change-newsgroups newsgroup server t)
183 (and (numberp article)
184 (let ((map nnvirtual-current-mapping)
187 (while (< (car (car map)) article)
188 (setq offset (car (car map)))
189 (setq map (cdr map)))
190 (setq group-method (gnus-find-method-for-group (nth 1 (car map))))
191 (or (gnus-server-opened group-method)
192 (gnus-open-server group-method))
193 (gnus-request-group (nth 1 (car map)) t)
194 (gnus-request-article (- (+ (nth 2 (car map)) article) offset)
195 (nth 1 (car map)) buffer))))
197 (defun nnvirtual-request-group (group &optional server dont-check)
198 "Make GROUP the current newsgroup."
199 (nnvirtual-possibly-change-newsgroups group server dont-check)
200 (let ((map nnvirtual-current-mapping))
202 (set-buffer nntp-server-buffer)
207 (setq map (cdr map)))
208 (insert (format "211 %d 1 %d %s\n" (car (car map))
209 (car (car map)) group))
211 (setq nnvirtual-status-string "No component groups")
212 (setq nnvirtual-current-group nil)
215 (defun nnvirtual-request-type (group &optional article)
216 (nnvirtual-possibly-change-newsgroups group nil)
219 (gnus-request-type (car (nnvirtual-art-group article)))))
221 (defun nnvirtual-close-group (group &optional server)
222 (if (not nnvirtual-current-group)
224 (nnvirtual-possibly-change-newsgroups group server t)
225 (nnvirtual-update-marked)
226 (setq nnvirtual-current-group nil
227 nnvirtual-current-groups nil
228 nnvirtual-current-mapping nil)
229 (setq nnvirtual-group-alist
230 (delq (assoc group nnvirtual-group-alist) nnvirtual-group-alist))))
232 (defun nnvirtual-request-list (&optional server)
233 (setq nnvirtual-status-string "nnvirtual: LIST is not implemented.")
236 (defun nnvirtual-request-newgroups (date &optional server)
238 (setq nnvirtual-status-string "NEWGROUPS is not supported.")
241 (defun nnvirtual-request-list-newsgroups (&optional server)
242 (setq nnvirtual-status-string
243 "nnvirtual: LIST NEWSGROUPS is not implemented.")
247 ;;; Internal functions.
249 (defun nnvirtual-convert-headers ()
250 "Convert HEAD headers into NOV headers."
252 (set-buffer nntp-server-buffer)
253 (let* ((dependencies (make-vector 100 0))
254 (headers (gnus-get-newsgroup-headers dependencies))
258 (setq header (pop headers))
259 (insert (int-to-string (mail-header-number header)) "\t"
260 (or (mail-header-subject header) "") "\t"
261 (or (mail-header-from header) "") "\t"
262 (or (mail-header-date header) "") "\t"
263 (or (mail-header-id header) "") "\t"
264 (or (mail-header-references header) "") "\t"
265 (int-to-string (or (mail-header-chars header) 0)) "\t"
266 (int-to-string (or (mail-header-lines header) 0)) "\t"
267 (if (mail-header-xref header)
268 (concat "Xref: " (mail-header-xref header) "\t")
271 (defun nnvirtual-possibly-change-newsgroups (group regexp &optional check)
274 (and nnvirtual-current-group
275 (string= group nnvirtual-current-group))
276 (and (setq inf (assoc group nnvirtual-group-alist))
277 (string= (nth 3 inf) regexp)
279 (setq nnvirtual-current-group (car inf))
280 (setq nnvirtual-current-groups (nth 1 inf))
281 (setq nnvirtual-current-mapping (nth 2 inf)))))
282 (if (or (not check) (not inf))
284 (and inf (setq nnvirtual-group-alist
285 (delq inf nnvirtual-group-alist)))
286 (setq nnvirtual-current-mapping nil)
287 (setq nnvirtual-current-group group)
288 (let ((newsrc gnus-newsrc-alist)
289 (virt-group (gnus-group-prefixed-name
290 nnvirtual-current-group '(nnvirtual ""))))
291 (setq nnvirtual-current-groups nil)
293 (and (string-match regexp (car (car newsrc)))
294 (not (string= (car (car newsrc)) virt-group))
295 (setq nnvirtual-current-groups
296 (cons (car (car newsrc)) nnvirtual-current-groups)))
297 (setq newsrc (cdr newsrc))))
298 (if nnvirtual-current-groups
300 (nnvirtual-create-mapping group)
301 (setq nnvirtual-group-alist
302 (cons (list group nnvirtual-current-groups
303 nnvirtual-current-mapping regexp)
304 nnvirtual-group-alist)))
305 (setq nnvirtual-status-string
307 "nnvirtual: No newsgroups for this virtual newsgroup"))))))
308 nnvirtual-current-groups)
310 (defun nnvirtual-create-mapping (group)
311 (let* ((group (gnus-group-prefixed-name group (list 'nnvirtual "")))
312 (info (nth 2 (gnus-gethash group gnus-newsrc-hashtb)))
313 (groups nnvirtual-current-groups)
315 reads unread igroup itotal ireads)
316 ;; The virtual group doesn't exist. (?)
317 (or info (error "No such group: %s" group))
318 (setq nnvirtual-current-mapping nil)
320 ;; Added by Sudish Joseph <joseph@cis.ohio-state.edu>.
321 (setq igroup (car groups))
322 (let ((info (nth 2 (gnus-gethash igroup gnus-newsrc-hashtb)))
323 (active (gnus-gethash igroup gnus-active-hashtb)))
324 ;; See if the group has had its active list read this session
325 ;; if not, we do it now.
327 (if (gnus-activate-group igroup)
329 (gnus-get-unread-articles-in-group
330 info (gnus-gethash igroup gnus-active-hashtb))
331 (setq active (gnus-gethash igroup gnus-active-hashtb)))
332 (message "Couldn't open component group %s" igroup)))
335 ;; And then we do the mapping for this component group. If
336 ;; you feel tempted to cast your eyes to the soup below -
337 ;; don't. It'll hurt your soul. Suffice to say that it
338 ;; assigns ranges of nnvirtual article numbers to the
339 ;; different component groups. To get the article number
340 ;; from the nnvirtual number, one does something like
341 ;; (+ (- number offset) (car active)), where `offset' is the
342 ;; slice the mess below assigns, and active is the lowest
343 ;; active article in the component group.
344 (setq itotal (1+ (- (cdr active) (car active))))
345 (if (setq ireads (nth 2 info))
347 (if (not (listp (cdr ireads)))
348 (setq ireads (list (cons (car ireads) (cdr ireads))))
349 (setq ireads (copy-alist ireads)))))
350 (if (< (or (and (numberp (car ireads)) (car ireads))
351 (cdr (car ireads))) (car active))
352 (setq ireads (setq itreads (cdr ireads))))
353 (if (and ireads (< (or (and (numberp (car ireads))
355 (car (car ireads))) (car active)))
356 (setcar (or (and (numberp (car ireads)) ireads)
357 (car ireads)) (1+ (car active))))
359 (setcar (or (and (numberp (car itreads)) itreads)
362 1 (- (if (numberp (car itreads))
367 (if (not (numberp (car itreads)))
368 (setcdr (car itreads)
369 (+ (- (cdr (car itreads)) (car active)) offset)))
370 (setq itreads (cdr itreads)))
371 (setq reads (nconc reads ireads))))
372 (setq offset (+ offset (1- itotal)))
373 (setq nnvirtual-current-mapping
374 (cons (list offset igroup (car active))
375 nnvirtual-current-mapping)))
376 (setq groups (cdr groups))))
377 (setq nnvirtual-current-mapping
378 (nreverse nnvirtual-current-mapping))
379 ;; Set Gnus active info.
380 (gnus-sethash group (cons 1 (1- offset)) gnus-active-hashtb)
381 ;; Set Gnus read info.
382 (setcar (nthcdr 2 info) reads)
384 ;; Then we deal with the marks.
385 (let ((map nnvirtual-current-mapping)
386 (marks '(tick dormant reply expire score))
388 tick dormant reply expire score marked active)
390 (setq igroup (nth 1 (car map)))
391 (setq active (nth 2 (car map)))
392 (setq marked (nth 3 (nth 2 (gnus-gethash igroup gnus-newsrc-hashtb))))
395 (and (assq (car m) marked)
401 0 (+ (- art active) offset))
402 (cons (+ (- (car art) active) offset)
404 (cdr (assq (car m) marked)))
405 (symbol-value (car m)))))
407 (setq offset (car (car map)))
408 (setq map (cdr map)))
409 ;; Put the list of marked articles in the info of the virtual group.
413 (and (symbol-value (car m))
414 (setq marked (cons (cons (car m) (symbol-value (car m)))
418 (setcar (nthcdr 3 info) marked)
419 (setcdr (nthcdr 2 info) (list marked)))))))
421 (defun nnvirtual-update-marked ()
422 (let ((mark-lists '((gnus-newsgroup-marked . tick)
423 (gnus-newsgroup-dormant . dormant)
424 (gnus-newsgroup-expirable . expire)
425 (gnus-newsgroup-replied . reply)))
426 marks art-group group-alist g)
428 (setq marks (symbol-value (car (car mark-lists))))
429 ;; Find out what groups the mark belong to.
431 (setq art-group (nnvirtual-art-group (car marks)))
432 (if (setq g (assoc (car art-group) group-alist))
433 (nconc g (list (cdr art-group)))
434 (setq group-alist (cons (list (car art-group) (cdr art-group))
436 (setq marks (cdr marks)))
437 ;; The groups that don't have marks must have no marks. (Yup.)
438 (let ((groups nnvirtual-current-groups))
440 (or (assoc (car groups) group-alist)
441 (setq group-alist (cons (list (car groups)) group-alist)))
442 (setq groups (cdr groups))))
443 ;; The we update the list of marks.
445 (gnus-add-marked-articles
446 (car (car group-alist)) (cdr (car mark-lists))
447 (cdr (car group-alist)) nil t)
448 (gnus-group-update-group (car (car group-alist)) t)
449 (setq group-alist (cdr group-alist)))
450 (setq mark-lists (cdr mark-lists)))))
452 (defun nnvirtual-art-group (article)
453 (let ((map nnvirtual-current-mapping)
455 (while (< (car (car map)) (if (numberp article) article (car article)))
456 (setq offset (car (car map))
458 (cons (nth 1 (car map))
459 (if (numberp article)
460 (- (+ article (nth 2 (car map))) offset)
461 (cons (- (+ (car article) (nth 2 (car map))) offset)
464 (defun nnvirtual-catchup-group (group &optional server all)
465 (nnvirtual-possibly-change-newsgroups group server)
466 (let ((gnus-group-marked nnvirtual-current-groups)
467 (gnus-expert-user t))
469 (set-buffer gnus-group-buffer)
470 (gnus-group-catchup-current nil all))))
474 ;;; nnvirtual.el ends here