Mercurial > hg > xemacs-beta

comparison lisp/games/cookie1.el @ 0:376386a54a3c r19-14

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r19-14
author cvs
date Mon, 13 Aug 2007 08:45:50 +0200
parents
children b82b59fe008d
comparison
equal deleted inserted replaced
-1:000000000000 0:376386a54a3c
1 ;;; cookie1.el --- retrieve random phrases from fortune cookie files
2
3 ;; Copyright (C) 1993 Free Software Foundation, Inc.
4
5 ;; Author: Eric S. Raymond <esr@snark.thyrsus.com>
6 ;; Maintainer: FSF
7 ;; Keywords: games
8 ;; Created: Mon Mar 22 17:06:26 1993
9
10 ;; This file is part of XEmacs.
11
12 ;; XEmacs is free software; you can redistribute it and/or modify it
13 ;; under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation; either version 2, or (at your option)
15 ;; any later version.
16
17 ;; XEmacs is distributed in the hope that it will be useful, but
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 ;; General Public License for more details.
21
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with XEmacs; see the file COPYING. If not, write to the Free
24 ;; Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
25
26 ;;; Synched up with: FSF 19.28.
27
28 ;;; Commentary:
29
30 ;; Support for random cookie fetches from phrase files, used for such
31 ;; critical applications as emulating Zippy the Pinhead and confounding
32 ;; the NSA Trunk Trawler.
33 ;;
34 ;; The two entry points are `cookie' and `cookie-insert'. The helper
35 ;; function `shuffle-vector' may be of interest to programmers.
36 ;;
37 ;; The code expects phrase files to be in one of two formats:
38 ;;
39 ;; * ITS-style LINS format (strings terminated by ASCII 0 characters,
40 ;; leading whitespace ignored).
41 ;;
42 ;; * UNIX fortune file format (quotes terminated by %% on a line by itself).
43 ;;
44 ;; Everything up to the first delimiter is treated as a comment. Other
45 ;; formats could be supported by adding alternates to the regexp
46 ;; `cookie-delimiter'.
47 ;;
48 ;; This code derives from Steve Strassman's 1987 spook.el package, but
49 ;; has been generalized so that it supports multiple simultaneous
50 ;; cookie databases and fortune files. It is intended to be called
51 ;; from other packages such as yow.el and spook.el.
52 ;;
53 ;; TO DO: teach cookie-snarf to auto-detect ITS PINS or UNIX fortune(6)
54 ;; format and do the right thing.
55
56 ;;; Code:
57
58 ; Randomize the seed in the random number generator.
59 (random t)
60
61 (defconst cookie-delimiter "\n%%\n\\|\0"
62 "Delimiter used to separate cookie file entries.")
63
64 (defvar cookie-cache (make-vector 511 0)
65 "Cache of cookie files that have already been snarfed.")
66
67 ;;;###autoload
68 (defun cookie (phrase-file startmsg endmsg)
69 "Return a random phrase from PHRASE-FILE. When the phrase file
70 is read in, display STARTMSG at beginning of load, ENDMSG at end."
71 (let ((cookie-vector (cookie-snarf phrase-file startmsg endmsg)))
72 (shuffle-vector cookie-vector)
73 (aref cookie-vector 1)))
74
75 ;;;###autoload
76 (defun cookie-insert (phrase-file &optional count startmsg endmsg)
77 "Insert random phrases from PHRASE-FILE; COUNT of them. When the phrase file
78 is read in, display STARTMSG at beginning of load, ENDMSG at end."
79 (let ((cookie-vector (cookie-snarf phrase-file startmsg endmsg)))
80 (shuffle-vector cookie-vector)
81 (let ((start (point)))
82 (insert ?\n)
83 (cookie1 (min (- (length cookie-vector) 1) (or count 1)) cookie-vector)
84 (insert ?\n)
85 (fill-region-as-paragraph start (point) nil))))
86
87 (defun cookie1 (arg cookie-vec)
88 "Inserts a cookie phrase ARG times."
89 (cond ((zerop arg) t)
90 (t (insert (aref cookie-vec arg))
91 (insert " ")
92 (cookie1 (1- arg) cookie-vec))))
93
94 ;;;###autoload
95 (defun cookie-snarf (phrase-file startmsg endmsg)
96 "Reads in the PHRASE-FILE, returns it as a vector of strings.
97 Emit STARTMSG and ENDMSG before and after. Caches the result; second
98 and subsequent calls on the same file won't go to disk."
99 (let ((sym (intern-soft phrase-file cookie-cache)))
100 (and sym (not (equal (symbol-function sym)
101 (nth 5 (file-attributes phrase-file))))
102 (yes-or-no-p (concat phrase-file
103 " has changed. Read new contents? "))
104 (setq sym nil))
105 (if sym
106 (symbol-value sym)
107 (setq sym (intern phrase-file cookie-cache))
108 (message startmsg)
109 (save-excursion
110 (let ((buf (generate-new-buffer "*cookie*"))
111 (result nil))
112 (set-buffer buf)
113 (fset sym (nth 5 (file-attributes phrase-file)))
114 (insert-file-contents (expand-file-name phrase-file))
115 (re-search-forward cookie-delimiter)
116 (while (progn (skip-chars-forward " \t\n\r\f") (not (eobp)))
117 (let ((beg (point)))
118 (re-search-forward cookie-delimiter)
119 ;; DBC --- here's the change
120 ;; This used to be (buffer-substring beg (1- (point))),
121 ;; which only worked if the regexp matched was one
122 ;; character long
123 (setq result (cons (buffer-substring beg
124 (match-beginning 0))
125 result))))
126 (kill-buffer buf)
127 (message endmsg)
128 (set sym (apply 'vector result)))))))
129
130 (defun read-cookie (prompt phrase-file startmsg endmsg &optional require-match)
131 "Prompt with PROMPT and read with completion among cookies in PHRASE-FILE.
132 STARTMSG and ENDMSG are passed along to `cookie-snarf'.
133 Optional fifth arg REQUIRE-MATCH non-nil forces a matching cookie."
134 ;; Make sure the cookies are in the cache.
135 (or (intern-soft phrase-file cookie-cache)
136 (cookie-snarf phrase-file startmsg endmsg))
137 (completing-read prompt
138 (let ((sym (intern phrase-file cookie-cache)))
139 ;; We cache the alist form of the cookie in a property.
140 (or (get sym 'completion-alist)
141 (let* ((alist nil)
142 (vec (cookie-snarf phrase-file
143 startmsg endmsg))
144 (i (length vec)))
145 (while (> (setq i (1- i)) 0)
146 (setq alist (cons (list (aref vec i)) alist)))
147 (put sym 'completion-alist alist))))
148 nil require-match nil nil))
149
150 ; Thanks to Ian G Batten <BattenIG@CS.BHAM.AC.UK>
151 ; [of the University of Birmingham Computer Science Department]
152 ; for the iterative version of this shuffle.
153 ;
154 ;;;###autoload
155 (defun shuffle-vector (vector)
156 "Randomly permute the elements of VECTOR (all permutations equally likely)"
157 (let ((i 0)
158 j
159 temp
160 (len (length vector)))
161 (while (< i len)
162 (setq j (+ i (random (- len i))))
163 (setq temp (aref vector i))
164 (aset vector i (aref vector j))
165 (aset vector j temp)
166 (setq i (1+ i))))
167 vector)
168
169 (provide 'cookie1)
170
171 ;;; cookie1.el ends here