annotate lisp/url/url-handlers.el @ 60615:643e6516a779

(Info-isearch-initial-node): New internal variable. (Info-search): Signal an error in isearch mode when search leaves the initial node. Signal an error when `bound' is non-nil and nothing was found in the current subfile. (Info-isearch-search): Remove `condition-case'. (Info-isearch-wrap): Don't wrap when search failed during leaving the initial node. If `Info-isearch-search' is nil, wrap around the current node. (Info-isearch-start): New fun. (Info-mode): Add buffer-local hook `Info-isearch-start' to `isearch-mode-hook'.
author Juri Linkov <juri@jurta.org>
date Tue, 15 Mar 2005 10:46:00 +0000
parents 96433f173a6e
children 507abf822567 4ee39d9428b0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
1 ;;; url-handlers.el --- file-name-handler stuff for URL loading
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
2
57174
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
3 ;; Copyright (c) 1996, 1997, 1998, 1999, 2004 Free Software Foundation, Inc.
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
4
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
5 ;; Keywords: comm, data, processes, hypermedia
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
6
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
7 ;; This file is part of GNU Emacs.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
8 ;;
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
9 ;; GNU Emacs is free software; you can redistribute it and/or modify
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
10 ;; it under the terms of the GNU General Public License as published by
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
11 ;; the Free Software Foundation; either version 2, or (at your option)
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
12 ;; any later version.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
13 ;;
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
14 ;; GNU Emacs is distributed in the hope that it will be useful,
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
17 ;; GNU General Public License for more details.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
18 ;;
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
19 ;; You should have received a copy of the GNU General Public License
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
20 ;; along with GNU Emacs; see the file COPYING. If not, write to the
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
22 ;; Boston, MA 02111-1307, USA.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
23
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
24 ;;; Commentary:
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
25
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
26 ;;; Code:
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
27
58900
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
28 ;; (require 'url)
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
29 (eval-when-compile (require 'url-parse))
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
30 ;; (require 'url-util)
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
31 (eval-when-compile (require 'mm-decode))
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
32 ;; (require 'mailcap)
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
33 ;; The following functions in the byte compiler's warnings are known not
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
34 ;; to cause any real problem for the following reasons:
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
35 ;; - mm-save-part-to-file, mm-destroy-parts: always used
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
36 ;; after mm-dissect-buffer and defined in the same file.
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
37 ;; The following are autoloaded instead of `require'd to avoid eagerly
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
38 ;; loading all of URL when turning on url-handler-mode in the .emacs.
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
39 (autoload 'url-retrieve-synchronously "url" "Retrieve url synchronously.")
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
40 (autoload 'url-expand-file-name "url-expand" "Convert url to a fully specified url, and canonicalize it.")
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
41 (autoload 'mm-dissect-buffer "mm-decode" "Dissect the current buffer and return a list of MIME handles.")
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
42 (autoload 'url-scheme-get-property "url-methods" "Get property of a URL SCHEME.")
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
43
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
44 (eval-when-compile
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
45 (require 'cl))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
46
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
47 ;; Implementation status
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
48 ;; ---------------------
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
49 ;; Function Status
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
50 ;; ------------------------------------------------------------
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
51 ;; add-name-to-file Needs DAV Bindings
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
52 ;; copy-file Broken (assumes 1st item is URL)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
53 ;; delete-directory Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
54 ;; delete-file Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
55 ;; diff-latest-backup-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
56 ;; directory-file-name unnecessary (what about VMS)?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
57 ;; directory-files Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
58 ;; dired-call-process
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
59 ;; dired-compress-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
60 ;; dired-uncache
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
61 ;; expand-file-name Finished
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
62 ;; file-accessible-directory-p
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
63 ;; file-attributes Finished, better with DAV
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
64 ;; file-directory-p Needs DAV, finished
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
65 ;; file-executable-p Finished
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
66 ;; file-exists-p Finished
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
67 ;; file-local-copy
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
68 ;; file-modes
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
69 ;; file-name-all-completions Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
70 ;; file-name-as-directory
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
71 ;; file-name-completion Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
72 ;; file-name-directory
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
73 ;; file-name-nondirectory
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
74 ;; file-name-sans-versions why?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
75 ;; file-newer-than-file-p
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
76 ;; file-ownership-preserved-p No way to know
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
77 ;; file-readable-p Finished
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
78 ;; file-regular-p !directory_p
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
79 ;; file-symlink-p Needs DAV bindings
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
80 ;; file-truename Needs DAV bindings
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
81 ;; file-writable-p Check for LOCK?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
82 ;; find-backup-file-name why?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
83 ;; get-file-buffer why?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
84 ;; insert-directory Use DAV
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
85 ;; insert-file-contents Finished
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
86 ;; load
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
87 ;; make-directory Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
88 ;; make-symbolic-link Needs DAV bindings
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
89 ;; rename-file Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
90 ;; set-file-modes Use mod_dav specific executable flag?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
91 ;; set-visited-file-modtime Impossible?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
92 ;; shell-command Impossible?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
93 ;; unhandled-file-name-directory
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
94 ;; vc-registered Finished (DAV)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
95 ;; verify-visited-file-modtime
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
96 ;; write-region
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
97
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
98 (defvar url-handler-regexp
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
99 "\\`\\(https?\\|ftp\\|file\\|nfs\\)://"
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
100 "*A regular expression for matching URLs handled by file-name-handler-alist.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
101 Some valid URL protocols just do not make sense to visit interactively
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
102 \(about, data, info, irc, mailto, etc\). This regular expression
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
103 avoids conflicts with local files that look like URLs \(Gnus is
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
104 particularly bad at this\).")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
105
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
106 ;;;###autoload
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
107 (define-minor-mode url-handler-mode
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
108 "Use URL to handle URL-like file names."
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
109 :global t
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
110 (if (not (boundp 'file-name-handler-alist))
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
111 ;; Can't be turned ON anyway.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
112 (setq url-handler-mode nil)
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
113 ;; Remove old entry, if any.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
114 (setq file-name-handler-alist
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
115 (delq (rassq 'url-file-handler file-name-handler-alist)
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
116 file-name-handler-alist))
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
117 (if url-handler-mode
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
118 (push (cons url-handler-regexp 'url-file-handler)
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
119 file-name-handler-alist))))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
120
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
121 (defun url-run-real-handler (operation args)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
122 (let ((inhibit-file-name-handlers (cons 'url-file-handler
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
123 (if (eq operation inhibit-file-name-operation)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
124 inhibit-file-name-handlers)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
125 (inhibit-file-name-operation operation))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
126 (apply operation args)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
127
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
128 (defun url-file-handler (operation &rest args)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
129 "Function called from the `file-name-handler-alist' routines.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
130 OPERATION is what needs to be done (`file-exists-p', etc). ARGS are
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
131 the arguments that would have been passed to OPERATION."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
132 (let ((fn (or (get operation 'url-file-handlers)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
133 (intern-soft (format "url-%s" operation))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
134 (val nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
135 (hooked nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
136 (if (and fn (fboundp fn))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
137 (setq hooked t
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
138 val (apply fn args))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
139 (setq hooked nil
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
140 val (url-run-real-handler operation args)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
141 (url-debug 'handlers "%s %S%S => %S" (if hooked "Hooked" "Real")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
142 operation args val)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
143 val))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
144
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
145 (defun url-file-handler-identity (&rest args)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
146 ;; Identity function
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
147 (car args))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
148
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
149 ;; These are operations that we can fully support
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
150 (put 'file-readable-p 'url-file-handlers 'url-file-exists-p)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
151 (put 'substitute-in-file-name 'url-file-handlers 'url-file-handler-identity)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
152 (put 'file-name-absolute-p 'url-file-handlers (lambda (&rest ignored) t))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
153 (put 'expand-file-name 'url-file-handlers 'url-handler-expand-file-name)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
154
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
155 ;; These are operations that we do not support yet (DAV!!!)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
156 (put 'file-writable-p 'url-file-handlers 'ignore)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
157 (put 'file-symlink-p 'url-file-handlers 'ignore)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
158
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
159 (defun url-handler-expand-file-name (file &optional base)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
160 (if (file-name-absolute-p file)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
161 (expand-file-name file "/")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
162 (url-expand-file-name file base)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
163
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
164 ;; The actual implementation
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
165 ;;;###autoload
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
166 (defun url-copy-file (url newname &optional ok-if-already-exists keep-time)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
167 "Copy URL to NEWNAME. Both args must be strings.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
168 Signals a `file-already-exists' error if file NEWNAME already exists,
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
169 unless a third argument OK-IF-ALREADY-EXISTS is supplied and non-nil.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
170 A number as third arg means request confirmation if NEWNAME already exists.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
171 This is what happens in interactive use with M-x.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
172 Fourth arg KEEP-TIME non-nil means give the new file the same
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
173 last-modified time as the old one. (This works on only some systems.)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
174 A prefix arg makes KEEP-TIME non-nil."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
175 (if (and (file-exists-p newname)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
176 (not ok-if-already-exists))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
177 (error "Opening output file: File already exists, %s" newname))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
178 (let ((buffer (url-retrieve-synchronously url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
179 (handle nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
180 (if (not buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
181 (error "Opening input file: No such file or directory, %s" url))
57174
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
182 (with-current-buffer buffer
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
183 (setq handle (mm-dissect-buffer t)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
184 (mm-save-part-to-file handle newname)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
185 (kill-buffer buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
186 (mm-destroy-parts handle)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
187
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
188 ;;;###autoload
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
189 (defun url-file-local-copy (url &rest ignored)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
190 "Copy URL into a temporary file on this machine.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
191 Returns the name of the local copy, or nil, if FILE is directly
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
192 accessible."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
193 (let ((filename (make-temp-name "url")))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
194 (url-copy-file url filename)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
195 filename))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
196
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
197 ;;;###autoload
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
198 (defun url-insert-file-contents (url &optional visit beg end replace)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
199 (let ((buffer (url-retrieve-synchronously url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
200 (handle nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
201 (data nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
202 (if (not buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
203 (error "Opening input file: No such file or directory, %s" url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
204 (if visit (setq buffer-file-name url))
57174
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
205 (with-current-buffer buffer
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
206 (setq handle (mm-dissect-buffer t))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
207 (set-buffer (mm-handle-buffer handle))
57174
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
208 (setq data (if beg (buffer-substring beg end)
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
209 (buffer-string))))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
210 (kill-buffer buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
211 (mm-destroy-parts handle)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
212 (if replace (delete-region (point-min) (point-max)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
213 (save-excursion
57174
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
214 (let ((start (point)))
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
215 (insert data)
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
216 ;; FIXME: for text/plain data, we sometimes receive a `charset'
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
217 ;; annotation which we could use as a hint of the locale in use
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
218 ;; at the remote site. Not sure how/if that should be done. --Stef
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
219 (decode-coding-inserted-region
57361
d3a3ba2db17f (url-insert-file-contents): Use the URL to decide the
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57174
diff changeset
220 start (point) url visit beg end replace)))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
221 (list url (length data))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
222
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
223 (defun url-file-name-completion (url directory)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
224 (error "Unimplemented"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
225
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
226 (defun url-file-name-all-completions (file directory)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
227 (error "Unimplemented"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
228
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
229 ;; All other handlers map onto their respective backends.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
230 (defmacro url-handlers-create-wrapper (method args)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
231 `(defun ,(intern (format "url-%s" method)) ,args
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
232 ,(format "URL file-name-handler wrapper for `%s' call.\n---\n%s" method
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
233 (or (documentation method t) "No original documentation."))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
234 (setq url (url-generic-parse-url url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
235 (when (url-type url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
236 (funcall (url-scheme-get-property (url-type url) (quote ,method))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
237 ,@(remove '&rest (remove '&optional args))))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
238
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
239 (url-handlers-create-wrapper file-exists-p (url))
54931
2a15e5a02a89 Use new find-file-hook.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54829
diff changeset
240 (url-handlers-create-wrapper file-attributes (url &optional id-format))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
241 (url-handlers-create-wrapper file-symlink-p (url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
242 (url-handlers-create-wrapper file-writable-p (url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
243 (url-handlers-create-wrapper file-directory-p (url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
244 (url-handlers-create-wrapper file-executable-p (url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
245
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
246 (if (featurep 'xemacs)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
247 (progn
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
248 ;; XEmacs specific prototypes
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
249 (url-handlers-create-wrapper
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
250 directory-files (url &optional full match nosort files-only))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
251 (url-handlers-create-wrapper
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
252 file-truename (url &optional default)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
253 ;; Emacs specific prototypes
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
254 (url-handlers-create-wrapper
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
255 directory-files (url &optional full match nosort))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
256 (url-handlers-create-wrapper
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
257 file-truename (url &optional counter prev-dirs)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
258
54931
2a15e5a02a89 Use new find-file-hook.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54829
diff changeset
259 (add-hook 'find-file-hook 'url-handlers-set-buffer-mode)
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
260
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
261 (defun url-handlers-set-buffer-mode ()
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
262 "Set correct modes for the current buffer if visiting a remote file."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
263 (and (stringp buffer-file-name)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
264 (string-match url-handler-regexp buffer-file-name)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
265 (auto-save-mode 0)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
266
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
267 (provide 'url-handlers)
54699
7784ae10206d Resolve CVS conflicts
Miles Bader <miles@gnu.org>
parents: 54695
diff changeset
268
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
269 ;; arch-tag: 7300b99c-cc83-42ff-9147-79b2723c62ac
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
270 ;;; url-handlers.el ends here