annotate lisp/nneething.el @ 24419:30e478cd167e

(shell-command-default-error-buffer): Renamed from shell-command-on-region-default-error-buffer. (shell-command-on-region): Mention in echo area when there is some error output. Mention success or failure, too. Accumulate multiple error outputs going forward, with formfeed in between. Display the error buffer when we have put something in it. (shell-command): Add the ERROR-BUFFER argument feature.

;;; nneething.el --- random file access for Gnus
;; Copyright (C) 1995,96 Free Software Foundation, Inc.

;; Author: Lars Magne Ingebrigtsen <[e-mail]>
;; 	Masanobu UMEDA <[e-mail]>
;; Keywords: news, mail

;; This file is part of GNU Emacs.

;; GNU Emacs is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation; either version 2, or (at your option)
;; any later version.

;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING.  If not, write to the
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
;; Boston, MA 02111-1307, USA.

;;; Commentary:

;; Based on nnspool.el by Masanobu UMEDA <[e-mail]>.
;; For an overview of what the interface functions do, please see the
;; Gnus sources.  

;;; Code:

(require 'nnheader)
(require 'nnmail)
(require 'nnoo)
(eval-when-compile (require 'cl))

(nnoo-declare nneething)

(defvoo nneething-map-file-directory "~/.nneething/"
  "*Where nneething stores the map files.")

(defvoo nneething-map-file ".nneething"
  "*Name of the map files.")

(defvoo nneething-exclude-files nil
  "*Regexp saying what files to exclude from the group.
If this variable is nil, no files will be excluded.")



;;; Internal variables. 

(defconst nneething-version "nneething 1.0"
  "nneething version.")

(defvoo nneething-current-directory nil
  "Current news group directory.")

(defvoo nneething-status-string "")
(defvoo nneething-group-alist nil)

(defvoo nneething-message-id-number 0)
(defvoo nneething-work-buffer " *nneething work*")

(defvoo nneething-directory nil)
(defvoo nneething-group nil)
(defvoo nneething-map nil)
(defvoo nneething-read-only nil)
(defvoo nneething-active nil)



;;; Interface functions.

(nnoo-define-basics nneething)

(deffoo nneething-retrieve-headers (articles &optional group server fetch-old)
  (nneething-possibly-change-directory group)

  (save-excursion
    (set-buffer nntp-server-buffer)
    (erase-buffer)
    (let* ((number (length articles))
	   (count 0)
	   (large (and (numberp nnmail-large-newsgroup)
		       (> number nnmail-large-newsgroup)))
	   article file)

      (if (stringp (car articles))
	  'headers

	(while (setq article (pop articles))
	  (setq file (nneething-file-name article))

	  (when (and (file-exists-p file)
		     (or (file-directory-p file)
			 (not (zerop (nnheader-file-size file)))))
	    (insert (format "221 %d Article retrieved.\n" article))
	    (nneething-insert-head file)
	    (insert ".\n"))

	  (incf count)

	  (and large
	       (zerop (% count 20))
	       (message "nneething: Receiving headers... %d%%"
			(/ (* count 100) number))))

	(when large
	  (message "nneething: Receiving headers...done"))

	(nnheader-fold-continuation-lines)
	'headers))))

(deffoo nneething-request-article (id &optional group server buffer)
  (nneething-possibly-change-directory group)
  (let ((file (unless (stringp id) (nneething-file-name id)))
	(nntp-server-buffer (or buffer nntp-server-buffer)))
    (and (stringp file)			; We did not request by Message-ID.
	 (file-exists-p file)		; The file exists.
	 (not (file-directory-p file))	; It's not a dir.
	 (save-excursion
	   (nnmail-find-file file)	; Insert the file in the nntp buf.
	   (or (nnheader-article-p)	; Either it's a real article...
	       (progn
		 (goto-char (point-min))
		 (nneething-make-head file (current-buffer)) ; ... or we fake some headers.
		 (insert "\n")))
	   t))))

(deffoo nneething-request-group (group &optional dir dont-check)
  (nneething-possibly-change-directory group dir)
  (unless dont-check
    (nneething-create-mapping)
    (if (> (car nneething-active) (cdr nneething-active))
	(nnheader-insert "211 0 1 0 %s\n" group)
      (nnheader-insert
       "211 %d %d %d %s\n" 
       (- (1+ (cdr nneething-active)) (car nneething-active))
       (car nneething-active) (cdr nneething-active)
       group)))
  t)

(deffoo nneething-request-list (&optional server dir)
  (nnheader-report 'nneething "LIST is not implemented."))

(deffoo nneething-request-newgroups (date &optional server)
  (nnheader-report 'nneething "NEWSGROUPS is not implemented."))

(deffoo nneething-request-type (group &optional article)
  'unknown)

(deffoo nneething-close-group (group &optional server)
  (setq nneething-current-directory nil)
  t)


;;; Internal functions.

(defun nneething-possibly-change-directory (group &optional dir)
  (when group
    (if (and nneething-group
	     (string= group nneething-group))
	t
      (let (entry)
	(if (setq entry (assoc group nneething-group-alist))
	    (progn
	      (setq nneething-group group)
	      (setq nneething-directory (nth 1 entry))
	      (setq nneething-map (nth 2 entry))
	      (setq nneething-active (nth 3 entry)))
	  (setq nneething-group group)
	  (setq nneething-directory dir)
	  (setq nneething-map nil)
	  (setq nneething-active (cons 1 0))
	  (nneething-create-mapping)
	  (push (list group dir nneething-map nneething-active)
		nneething-group-alist))))))

(defun nneething-map-file ()
  ;; We make sure that the .nneething directory exists. 
  (unless (file-exists-p nneething-map-file-directory)
    (make-directory nneething-map-file-directory 'parents))
  ;; We store it in a special directory under the user's home dir.
  (concat (file-name-as-directory nneething-map-file-directory)
	  nneething-group nneething-map-file))

(defun nneething-create-mapping ()
  ;; Read nneething-active and nneething-map.
  (let ((map-file (nneething-map-file))
	(files (directory-files nneething-directory))
	touched map-files)
    (if (file-exists-p map-file)
	(condition-case nil
	    (load map-file nil t t)
	  (error nil)))
    (or nneething-active (setq nneething-active (cons 1 0)))
    ;; Old nneething had a different map format.
    (when (and (cdar nneething-map)
	       (atom (cdar nneething-map)))
      (setq nneething-map
	    (mapcar (lambda (n)
		      (list (cdr n) (car n) 
			    (nth 5 (file-attributes 
				    (nneething-file-name (car n))))))
		    nneething-map)))
    ;; Remove files matching the exclusion regexp.
    (when nneething-exclude-files
      (let ((f files)
	    prev)
	(while f
	  (if (string-match nneething-exclude-files (car f))
	      (if prev (setcdr prev (cdr f))
		(setq files (cdr files)))
	    (setq prev f))
	  (setq f (cdr f)))))
    ;; Remove deleted files from the map.
    (let ((map nneething-map)
	  prev)
      (while map
	(if (and (member (cadar map) files)
		 ;; We also remove files that have changed mod times.
		 (equal (nth 5 (file-attributes
				(nneething-file-name (cadar map))))
			(caddar map)))
	    (progn
	      (push (cadar map) map-files)
	      (setq prev map))
	  (setq touched t)
	  (if prev
	      (setcdr prev (cdr map))
	    (setq nneething-map (cdr nneething-map))))
	(setq map (cdr map))))
    ;; Find all new files and enter them into the map.
    (while files
      (unless (member (car files) map-files) 
	;; This file is not in the map, so we enter it.
	(setq touched t)
	(setcdr nneething-active (1+ (cdr nneething-active)))
	(push (list (cdr nneething-active) (car files) 
		    (nth 5 (file-attributes
			    (nneething-file-name (car files)))))
	      nneething-map))
      (setq files (cdr files)))
    (when (and touched 
	       (not nneething-read-only))
      (save-excursion
	(nnheader-set-temp-buffer " *nneething map*")
	(insert "(setq nneething-map '" (prin1-to-string nneething-map) ")\n"
		"(setq nneething-active '" (prin1-to-string nneething-active)
		")\n")
	(write-region (point-min) (point-max) map-file nil 'nomesg)
	(kill-buffer (current-buffer))))))

(defun nneething-insert-head (file)
  "Insert the head of FILE."
  (when (nneething-get-head file)
    (insert-buffer-substring nneething-work-buffer)
    (goto-char (point-max))))

(defun nneething-make-head (file &optional buffer)
  "Create a head by looking at the file attributes of FILE."
  (let ((atts (file-attributes file)))
    (insert 
     "Subject: " (file-name-nondirectory file) "\n"
     "Message-ID: <nneething-" 
     (int-to-string (incf nneething-message-id-number))
     "@" (system-name) ">\n"
     (if (equal '(0 0) (nth 5 atts)) ""
       (concat "Date: " (current-time-string (nth 5 atts)) "\n"))
     (or (if buffer
	     (save-excursion 
	       (set-buffer buffer)
	       (if (re-search-forward "<[a-zA-Z0-9_]@[-a-zA-Z0-9_]>" 1000 t)
		   (concat "From: " (match-string 0) "\n"))))
	 (nneething-from-line (nth 2 atts) file))
     (if (> (string-to-int (int-to-string (nth 7 atts))) 0)
	 (concat "Chars: " (int-to-string (nth 7 atts)) "\n")
       "")
     (if buffer 
	 (save-excursion
	   (set-buffer buffer)
	   (concat "Lines: " (int-to-string 
			      (count-lines (point-min) (point-max))) "\n"))
       "")
     )))

(defun nneething-from-line (uid &optional file)
  "Return a From header based of UID."
  (let* ((login (condition-case nil 
		    (user-login-name uid)
		  (error 
		   (cond ((= uid (user-uid)) (user-login-name))
			 ((zerop uid) "root")
			 (t (int-to-string uid))))))
	 (name (condition-case nil 
		   (user-full-name uid)
		 (error 
		  (cond ((= uid (user-uid)) (user-full-name))
			((zerop uid) "Ms. Root")))))
	 (host (if  (string-match "\\`/[^/@]*@\\([^:/]+\\):" file)
		   (prog1
		       (substring file 
				  (match-beginning 1) 
				  (match-end 1))
		     (if (string-match "/\\(users\\|home\\)/\\([^/]+\\)/" file)
			 (setq login (substring file
						(match-beginning 2)
						(match-end 2))
			       name nil)))
		 (system-name))))
    (concat "From: " login "@" host 
	    (if name (concat " (" name ")") "") "\n")))

(defun nneething-get-head (file)
  "Either find the head in FILE or make a head for FILE."
  (save-excursion
    (set-buffer (get-buffer-create nneething-work-buffer))
    (setq case-fold-search nil)
    (buffer-disable-undo (current-buffer))
    (erase-buffer)
    (cond 
     ((not (file-exists-p file))
      ;; The file do not exist. 
      nil)
     ((or (file-directory-p file)
	  (file-symlink-p file))
      ;; It's a dir, so we fudge a head.
      (nneething-make-head file) t)
     (t 
      ;; We examine the file.
      (nnheader-insert-head file)
      (if (nnheader-article-p)
	  (delete-region 
	   (progn
	     (goto-char (point-min))
	     (or (and (search-forward "\n\n" nil t)
		      (1- (point)))
		 (point-max)))
	   (point-max))
	(goto-char (point-min))
	(nneething-make-head file (current-buffer))
	(delete-region (point) (point-max)))
      t))))

(defun nneething-file-name (article)
  "Return the file name of ARTICLE."
  (concat (file-name-as-directory nneething-directory)
	  (if (numberp article)
	      (cadr (assq article nneething-map))
	    article)))

(provide 'nneething)

;;; nneething.el ends here