annotate lisp/tl/file-detect.el @ 110:fe104dbd9147 r20-1b7

Import from CVS: tag r20-1b7
author cvs
date Mon, 13 Aug 2007 09:19:45 +0200
parents 360340f9fd5f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
1 ;;; file-detect.el --- Emacs Lisp file detection utility
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
2
86
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
3 ;; Copyright (C) 1996,1997 Free Software Foundation, Inc.
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
5 ;; Author: MORIOKA Tomohiko <morioka@jaist.ac.jp>
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
6 ;; Version:
110
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
7 ;; $Id: file-detect.el,v 1.5 1997/03/16 03:05:44 steve Exp $
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
8 ;; Keywords: install, module
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
9
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
10 ;; This file is part of tl (Tiny Library).
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
11
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
12 ;; This program is free software; you can redistribute it and/or
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
13 ;; modify it under the terms of the GNU General Public License as
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
14 ;; published by the Free Software Foundation; either version 2, or (at
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
15 ;; your option) any later version.
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
16
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
17 ;; This program is distributed in the hope that it will be useful, but
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
20 ;; General Public License for more details.
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
21
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
108
360340f9fd5f Import from CVS: tag r20-1b6
cvs
parents: 86
diff changeset
23 ;; along with GNU Emacs; see the file COPYING. If not, write to the
360340f9fd5f Import from CVS: tag r20-1b6
cvs
parents: 86
diff changeset
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
25 ;; Boston, MA 02111-1307, USA.
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
26
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
27 ;;; Code:
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
28
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
29 (defvar default-load-path load-path)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
30
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
31 (defun add-path (path &rest options)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
32 "Add PATH to `load-path' if it exists under `default-load-path'
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
33 directories and it does not exist in `load-path'.
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
34
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
35 You can use following PATH styles:
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
36 load-path relative: \"PATH/\"
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
37 (it is searched from `defaul-load-path')
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
38 home directory relative: \"~/PATH/\" \"~USER/PATH/\"
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
39 absolute path: \"/HOO/BAR/BAZ/\"
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
40
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
41 You can specify following OPTIONS:
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
42 'all-paths search from `load-path'
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
43 instead of `default-load-path'
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
44 'append add PATH to the last of `load-path'
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
45
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
46 \[file-detect.el]"
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
47 (let ((rest (if (memq 'all-paths options)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
48 load-path
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
49 default-load-path))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
50 p)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
51 (if (and (catch 'tag
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
52 (while rest
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
53 (setq p (expand-file-name path (car rest)))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
54 (if (file-directory-p p)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
55 (throw 'tag p)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
56 )
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
57 (setq rest (cdr rest))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
58 ))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
59 (not (member p load-path))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
60 )
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
61 (setq load-path
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
62 (if (memq 'append options)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
63 (append load-path (list p))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
64 (cons p load-path)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
65 ))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
66 )))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
67
86
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
68 (defun add-latest-path (pattern &optional all-paths)
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
69 "Add latest path matched by PATTERN to `load-path'
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
70 if it exists under `default-load-path' directories
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
71 and it does not exist in `load-path'.
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
72
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
73 If optional argument ALL-PATHS is specified, it is searched from all
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
74 of load-path instead of default-load-path. [file-detect.el]"
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
75 (let ((path (get-latest-path pattern all-paths)))
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
76 (if path
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
77 (add-to-list 'load-path path)
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
78 )))
364816949b59 Import from CVS: tag r20-0b93
cvs
parents: 76
diff changeset
79
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
80 (defun get-latest-path (pat &optional all-paths)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
81 "Return latest directory in default-load-path
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
82 which is matched to regexp PAT.
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
83 If optional argument ALL-PATHS is specified,
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
84 it is searched from all of load-path instead of default-load-path.
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
85 \[file-detect.el]"
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
86 (catch 'tag
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
87 (let ((paths (if all-paths
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
88 load-path
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
89 default-load-path))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
90 dir)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
91 (while (setq dir (car paths))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
92 (let ((files (sort (directory-files dir t pat t)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
93 (function file-newer-than-file-p)))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
94 file)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
95 (while (setq file (car files))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
96 (if (file-directory-p file)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
97 (throw 'tag file)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
98 )
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
99 (setq files (cdr files))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
100 ))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
101 (setq paths (cdr paths))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
102 ))))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
103
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
104 (defun file-installed-p (file &optional paths)
108
360340f9fd5f Import from CVS: tag r20-1b6
cvs
parents: 86
diff changeset
105 "Return absolute-path of FILE if FILE exists in PATHS.
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
106 If PATHS is omitted, `load-path' is used. [file-detect.el]"
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
107 (if (null paths)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
108 (setq paths load-path)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
109 )
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
110 (catch 'tag
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
111 (let (path)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
112 (while paths
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
113 (setq path (expand-file-name file (car paths)))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
114 (if (file-exists-p path)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
115 (throw 'tag path)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
116 )
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
117 (setq paths (cdr paths))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
118 ))))
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
119
110
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
120 (defvar exec-suffix-list '("")
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
121 "*List of suffixes for executable.")
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
122
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
123 (defun exec-installed-p (file &optional paths suffixes)
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
124 "Return absolute-path of FILE if FILE exists in PATHS.
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
125 If PATHS is omitted, `exec-path' is used.
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
126 If suffixes is omitted, `exec-suffix-list' is used. [file-detect.el]"
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
127 (or paths
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
128 (setq paths exec-path)
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
129 )
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
130 (or suffixes
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
131 (setq suffixes exec-suffix-list)
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
132 )
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
133 (catch 'tag
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
134 (while paths
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
135 (let ((stem (expand-file-name file (car paths)))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
136 (sufs suffixes)
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
137 )
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
138 (while sufs
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
139 (let ((file (concat stem (car sufs))))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
140 (if (file-exists-p file)
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
141 (throw 'tag file)
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
142 ))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
143 (setq sufs (cdr sufs))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
144 ))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
145 (setq paths (cdr paths))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
146 )))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
147
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
148 (defun module-installed-p (module &optional paths)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
149 "Return t if module is provided or exists in PATHS.
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
150 If PATHS is omitted, `load-path' is used. [file-detect.el]"
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
151 (or (featurep module)
110
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
152 (exec-installed-p (symbol-name module) load-path '(".elc" ".el"))
fe104dbd9147 Import from CVS: tag r20-1b7
cvs
parents: 108
diff changeset
153 ))
4
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
154
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
155
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
156 ;;; @ end
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
157 ;;;
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
158
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
159 (provide 'file-detect)
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
160
b82b59fe008d Import from CVS: tag r19-15b3
cvs
parents:
diff changeset
161 ;;; file-detect.el ends here