1 ;;; locate.el --- interface to the locate command
3 ;; Copyright (C) 1996, 1998 Free Software Foundation, Inc.
5 ;; Author: Peter Breton <pbreton@cs.umb.edu>
7 ;; This file is part of GNU Emacs.
9 ;; GNU Emacs is free software; you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation; either version 2, or (at your option)
14 ;; GNU Emacs is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 ;; GNU General Public License for more details.
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs; see the file COPYING. If not, write to the
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 ;; Boston, MA 02111-1307, USA.
26 ;; Search a database of files and use dired commands on
30 ;;;;; Building a database of files ;;;;;;;;;
32 ;; You can create a simple files database with a port of the Unix find command
33 ;; and one of the various Windows NT various scheduling utilities,
34 ;; for example the AT command from the NT Resource Kit, WinCron which is
35 ;; included with Microsoft FrontPage, or the shareware NTCron program.
37 ;; To set up a function which searches the files database, do something
40 ;; (defvar locate-fcodes-file "c:/users/peter/fcodes")
41 ;; (defvar locate-make-command-line 'nt-locate-make-command-line)
43 ;; (defun nt-locate-make-command-line (arg)
44 ;; (list "grep" "-i" arg locate-fcodes-file))
46 ;;;;;;;; ADVICE For dired-make-relative: ;;;;;;;;;
48 ;; For certain dired commands to work right, you should also include the
49 ;; following in your _emacs/.emacs:
51 ;; (defadvice dired-make-relative (before set-no-error activate)
52 ;; "For locate mode and Windows, don't return errors"
53 ;; (if (and (eq major-mode 'locate-mode)
54 ;; (memq system-type (list 'windows-nt 'ms-dos)))
58 ;; Otherwise, `dired-make-relative' will give error messages like
59 ;; "FILENAME: not in directory tree growing at /"
63 ;; Locate.el provides an interface to a program which searches a
64 ;; database of file names. By default, this program is the GNU locate
65 ;; command, but it could also be the BSD-style find command, or even a
66 ;; user specified command.
68 ;; To use the BSD-style "fast find", or any other shell command of the
71 ;; SHELLPROGRAM Name-to-find
73 ;; set the variable `locate-command' in your .emacs file.
75 ;; To use a more complicated expression, create a function which
76 ;; takes a string (the name to find) as input and returns a list.
77 ;; The first element should be the command to be executed, the remaining
78 ;; elements should be the arguments (including the name to find). Then put
80 ;; (setq locate-make-command-line 'my-locate-command-line)
82 ;; in your .emacs, using the name of your function in place of
83 ;; my-locate-command-line.
85 ;; You should make sure that whichever command you use works correctly
86 ;; from a shell prompt. GNU locate and BSD find expect the file databases
87 ;; to either be in standard places or located via environment variables.
88 ;; If the latter, make sure these environment variables are set in
89 ;; your emacs process.
91 ;; Locate-mode assumes that each line output from the locate-command
92 ;; consists exactly of a file name, possibly preceded or trailed by
93 ;; whitespace. If your file database has other information on the line (for
94 ;; example, the file size), you will need to redefine the function
95 ;; `locate-get-file-positions' to return a list consisting of the first
96 ;; character in the file name and the last character in the file name.
98 ;; To use locate-mode, simply type M-x locate and then the string
99 ;; you wish to find. You can use almost all of the dired commands in
100 ;; the resulting *Locate* buffer. It is worth noting that your commands
101 ;; do not, of course, affect the file database. For example, if you
102 ;; compress a file in the locate buffer, the actual file will be
103 ;; compressed, but the entry in the file database will not be
104 ;; affected. Consequently, the database and the filesystem will be out
105 ;; of sync until the next time the database is updated.
107 ;; The command `locate-with-filter' keeps only lines matching a
108 ;; regular expression; this is often useful to constrain a big search.
118 (defvar locate-current-filter nil
)
121 "Interface to the locate command."
125 (defcustom locate-command
"locate"
126 "*The executable program used to search a database of files."
130 (defvar locate-history-list nil
131 "The history list used by the \\[locate] command.")
133 (defvar locate-grep-history-list nil
134 "The history list used by the \\[locate-with-filter] command.")
136 (defcustom locate-make-command-line
'locate-default-make-command-line
137 "*Function used to create the locate command line."
141 (defcustom locate-buffer-name
"*Locate*"
142 "*Name of the buffer to show results from the \\[locate] command."
146 (defcustom locate-fcodes-file nil
147 "*File name for the database of file names."
148 :type
'(choice file
(const nil
))
151 (defcustom locate-header-face nil
152 "*Face used to highlight the locate header."
156 (defcustom locate-update-command
"updatedb"
157 "The command used to update the locate database."
161 (defcustom locate-prompt-for-command nil
162 "If non-nil, the default behavior of the locate command is to prompt for a command to run.
163 Otherwise, that behavior is invoked via a prefix argument."
170 (defun locate-default-make-command-line (search-string)
171 (list locate-command search-string
))
173 (defun locate-word-at-point ()
175 (buffer-substring-no-properties
177 (skip-chars-backward "-a-zA-Z0-9.")
180 (skip-chars-forward "-a-zA-Z0-9.")
181 (skip-chars-backward "." pt
)
185 (defun locate (arg search-string
&optional filter
)
186 "Run the program `locate', putting results in `*Locate*' buffer.
187 With prefix arg, prompt for the locate command to run."
191 (if (or (and current-prefix-arg
(not locate-prompt-for-command
))
192 (and (not current-prefix-arg
) locate-prompt-for-command
))
193 (read-from-minibuffer "Run locate command: "
194 nil nil nil
'locate-history-list
)
195 (read-from-minibuffer "Locate: " (locate-word-at-point) nil
196 nil
'locate-history-list
)
198 (let* ((locate-cmd-list (funcall locate-make-command-line search-string
))
199 (locate-cmd (car locate-cmd-list
))
200 (locate-cmd-args (cdr locate-cmd-list
))
202 (or (and arg
(not locate-prompt-for-command
))
203 (and (not arg
) locate-prompt-for-command
)))
206 ;; Find the Locate buffer
207 (save-window-excursion
208 (set-buffer (get-buffer-create locate-buffer-name
))
212 (setq locate-current-filter filter
)
214 (if run-locate-command
215 (shell-command search-string locate-buffer-name
)
216 (apply 'call-process locate-cmd nil t nil locate-cmd-args
))
219 (locate-filter-output filter
))
223 (and (not (string-equal (buffer-name) locate-buffer-name
))
224 (switch-to-buffer-other-window locate-buffer-name
))
226 (run-hooks 'dired-mode-hook
)
227 (run-hooks 'locate-post-command-hook
)
232 (defun locate-with-filter (search-string filter
)
233 "Run the locate command with a filter.
235 The filter is a regular expression. Only results matching the filter are
236 shown; this is often useful to constrain a big search."
238 (list (read-from-minibuffer "Locate: " nil nil
239 nil
'locate-history-list
)
240 (read-from-minibuffer "Filter: " nil nil
241 nil
'locate-grep-history-list
)))
242 (locate nil search-string filter
))
244 (defun locate-filter-output (filter)
245 "Filter output from the locate command."
246 (goto-char (point-min))
247 (delete-non-matching-lines filter
))
249 (defvar locate-mode-map nil
250 "Local keymap for Locate mode buffers.")
256 (setq locate-mode-map
(copy-keymap dired-mode-map
))
258 ;; Undefine Useless Dired Menu bars
259 (define-key locate-mode-map
[menu-bar Dired
] 'undefined
)
260 (define-key locate-mode-map
[menu-bar subdir
] 'undefined
)
262 (define-key locate-mode-map
[menu-bar mark executables
] 'undefined
)
263 (define-key locate-mode-map
[menu-bar mark directory
] 'undefined
)
264 (define-key locate-mode-map
[menu-bar mark directories
] 'undefined
)
265 (define-key locate-mode-map
[menu-bar mark symlinks
] 'undefined
)
267 (define-key locate-mode-map
[mouse-2
] 'locate-mouse-view-file
)
268 (define-key locate-mode-map
"\C-c\C-t" 'locate-tags
)
270 (define-key locate-mode-map
"U" 'dired-unmark-all-files
)
271 (define-key locate-mode-map
"V" 'locate-find-directory
)
274 ;; This variable is used to indent the lines and then to search for
276 (defconst locate-filename-indentation
4
277 "The amount of indentation for each file.")
279 (defun locate-get-file-positions ()
285 ;; Assumes names end at the end of the line
286 (forward-char locate-filename-indentation
)
287 (list (point) eol
))))
290 (defun locate-current-line-number ()
291 "Return the current line number, as an integer."
292 (+ (count-lines (point-min) (point))
293 (if (eq (current-column) 0)
297 (defun locate-get-filename ()
298 (let ((pos (locate-get-file-positions))
299 (lineno (locate-current-line-number)))
300 (and (not (eq lineno
1))
302 (buffer-substring (elt pos
0) (elt pos
1)))))
304 (defun locate-mouse-view-file (event)
305 "In Locate mode, view a file, using the mouse."
308 (goto-char (posn-point (event-start event
)))
309 (view-file (locate-get-filename))))
311 ;; Define a mode for locate
312 ;; Default directory is set to "/" so that dired commands, which
313 ;; expect to be in a tree, will work properly
314 (defun locate-mode ()
315 "Major mode for the `*Locate*' buffer made by \\[locate]."
316 (kill-all-local-variables)
317 ;; Avoid clobbering this variables
318 (make-local-variable 'dired-subdir-alist
)
319 (use-local-map locate-mode-map
)
320 (setq major-mode
'locate-mode
322 default-directory
"/")
323 (dired-alist-add-1 default-directory
(point-min-marker))
324 (make-local-variable 'dired-move-to-filename-regexp
)
325 ;; This should support both Unix and Windoze style names
326 (setq dired-move-to-filename-regexp
328 (make-string (1- locate-filename-indentation
) ?\
)
329 "\\(/\\|[A-Za-z]:\\)"))
330 (make-local-variable 'dired-actual-switches
)
331 (setq dired-actual-switches
"")
332 (make-local-variable 'dired-permission-flags-regexp
)
333 (setq dired-permission-flags-regexp
335 (make-string (1- locate-filename-indentation
) ?\
)
337 (make-local-variable 'revert-buffer-function
)
338 (setq revert-buffer-function
'locate-update
)
339 (run-hooks 'locate-mode-hook
))
341 (defun locate-do-setup ()
342 (let ((search-string (car locate-history-list
)))
343 (goto-char (point-min))
346 ;; Nothing returned from locate command?
349 (kill-buffer locate-buffer-name
)
350 (if locate-current-filter
351 (error "Locate: no match for %s in database using filter %s"
352 search-string locate-current-filter
)
353 (error "Locate: no match for %s in database" search-string
))))
355 (locate-insert-header search-string
)
358 (insert-char ?\ locate-filename-indentation t
)
359 (locate-set-properties)
362 (defun locate-set-properties ()
364 (let ((pos (locate-get-file-positions)))
365 (dired-insert-set-properties (elt pos
0) (elt pos
1)))))
367 (defun locate-insert-header (search-string)
368 (let ((locate-format-string "Matches for %s")
370 (concat " *Matches for \\(" (regexp-quote search-string
) "\\)"))
371 (locate-format-args (list search-string
))
374 (and locate-fcodes-file
375 (setq locate-format-string
376 (concat locate-format-string
" in %s")
378 (concat locate-regexp-match
380 (regexp-quote locate-fcodes-file
)
383 (append (list locate-fcodes-file
) locate-format-args
)))
385 (and locate-current-filter
386 (setq locate-format-string
387 (concat locate-format-string
" using filter %s")
389 (concat locate-regexp-match
392 (regexp-quote locate-current-filter
)
395 (append (list locate-current-filter
) locate-format-args
)))
397 (setq locate-format-string
398 (concat locate-format-string
": \n\n")
400 (concat locate-regexp-match
": \n"))
402 (insert (apply 'format locate-format-string
(reverse locate-format-args
)))
405 (goto-char (point-min))
406 (if (not (looking-at locate-regexp-match
))
408 (add-text-properties (match-beginning 1) (match-end 1)
409 (list 'face locate-header-face
))
410 (and (match-beginning 2)
411 (add-text-properties (match-beginning 2) (match-end 2)
412 (list 'face locate-header-face
)))
413 (and (match-beginning 3)
414 (add-text-properties (match-beginning 3) (match-end 3)
415 (list 'face locate-header-face
)))
418 (defun locate-tags ()
419 "Visit a tags table in `*Locate*' mode."
421 (let ((tags-table (locate-get-filename)))
422 (and (y-or-n-p (format "Visit tags table %s? " tags-table
))
423 (visit-tags-table tags-table
))))
425 ;; From Stephen Eglen <stephen@cns.ed.ac.uk>
426 (defun locate-update (ignore1 ignore2
)
427 "Update the locate database.
428 Database is updated using the shell command in `locate-update-command'."
429 (let ((str (car locate-history-list
)))
430 (cond ((yes-or-no-p "Update locate database (may take a few seconds)? ")
431 (shell-command locate-update-command
)
434 ;;; Modified three functions from `dired.el':
435 ;;; dired-find-directory,
436 ;;; dired-find-directory-other-window
437 ;;; dired-get-filename
439 (defun locate-find-directory ()
440 "Visit the directory of the file mentioned on this line."
442 (let ((directory-name (locate-get-dirname)))
443 (if (file-directory-p directory-name
)
444 (find-file directory-name
)
445 (if (file-symlink-p directory-name
)
446 (error "Directory is a symlink to a nonexistent target")
447 (error "Directory no longer exists; run `updatedb' to update database")))))
449 (defun locate-find-directory-other-window ()
450 "Visit the directory of the file named on this line in other window."
452 (find-file-other-window (locate-get-dirname)))
454 (defun locate-get-dirname ()
455 "Return the directory name of the file mentioned on this line."
456 (let (file (filepos (locate-get-file-positions)))
457 (if (setq file
(buffer-substring (nth 0 filepos
) (nth 1 filepos
)))
459 ;; Get rid of the mouse-face property that file names have.
460 (set-text-properties 0 (length file
) nil file
)
461 (setq file
(file-name-directory file
))
462 ;; Unquote names quoted by ls or by dired-insert-directory.
463 ;; Using read to unquote is much faster than substituting
464 ;; \007 (4 chars) -> ^G (1 char) etc. in a lisp loop.
468 ;; some ls -b don't escape quotes, argh!
469 ;; This is not needed for GNU ls, though.
470 (or (dired-string-replace-match
471 "\\([^\\]\\|\\`\\)\"" file
"\\1\\\\\"" nil t
)
474 (and file buffer-file-coding-system
475 (not file-name-coding-system
)
476 (setq file
(encode-coding-string file buffer-file-coding-system
)))
479 ;; Only for GNU locate
480 (defun locate-in-alternate-database (search-string database
)
481 "Run the GNU locate command, using an alternate database."
486 (read-from-minibuffer "Locate: " nil nil
487 nil
'locate-history-list
))
488 (read-file-name "Locate using Database: " )
490 (or (file-exists-p database
)
491 (error "Database file %s does not exist" database
))
492 (let ((locate-make-command-line
493 (function (lambda (string)
495 (list (concat "--database="
496 (expand-file-name database
))
498 (locate nil search-string
)))
502 ;;; locate.el ends here