annotate lisp/url/url-handlers.el @ 68522:081be1a1c981

*** empty log message ***
author Kim F. Storm <storm@cua.dk>
date Wed, 01 Feb 2006 10:41:27 +0000
parents 11f1a38de9af
children 73f175471c73 c69d44922688
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
64748
875dcc490074 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64084
diff changeset
3 ;; Copyright (C) 1996, 1997, 1998, 1999, 2004,
67976
11f1a38de9af (url-retrieve-synchronously): Don't autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66938
diff changeset
4 ;; 2005, 2006 Free Software Foundation, Inc.
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
5
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
6 ;; Keywords: comm, data, processes, hypermedia
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
7
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
8 ;; This file is part of GNU Emacs.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
9 ;;
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
10 ;; 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
11 ;; 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
12 ;; 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
13 ;; any later version.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
14 ;;
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
15 ;; 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
16 ;; 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
17 ;; 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
18 ;; GNU General Public License for more details.
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
19 ;;
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
20 ;; 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
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
64084
a8fa7c632ee4 Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 63287
diff changeset
22 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
a8fa7c632ee4 Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 63287
diff changeset
23 ;; Boston, MA 02110-1301, USA.
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
24
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
25 ;;; Commentary:
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
26
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
27 ;;; Code:
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
28
58900
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
29 ;; (require 'url)
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
30 (eval-when-compile (require 'url-parse))
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
31 ;; (require 'url-util)
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
32 (eval-when-compile (require 'mm-decode))
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
33 ;; (require 'mailcap)
96433f173a6e Don't `require' everything eagerly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 57427
diff changeset
34 ;; 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
35 ;; 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
36 ;; - 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
37 ;; 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
38 ;; 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
39 ;; 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
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."
61290
507abf822567 (url-handler-mode): Specify :group.
Lute Kamstra <lute@gnu.org>
parents: 58900
diff changeset
109 :global t :group 'url
54829
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)
63287
3e75cb9c1c5b (vc-registered): Explicitly disable VC for URL files.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61290
diff changeset
158 ;; Just like for ange-ftp: let's not waste time trying to look for RCS/foo,v
3e75cb9c1c5b (vc-registered): Explicitly disable VC for URL files.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61290
diff changeset
159 ;; files and such since we can't do anything clever with them anyway.
3e75cb9c1c5b (vc-registered): Explicitly disable VC for URL files.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61290
diff changeset
160 (put 'vc-registered 'url-file-handlers 'ignore)
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
161
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
162 (defun url-handler-expand-file-name (file &optional base)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
163 (if (file-name-absolute-p file)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
164 (expand-file-name file "/")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
165 (url-expand-file-name file base)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
166
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
167 ;; The actual implementation
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
168 ;;;###autoload
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
169 (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
170 "Copy URL to NEWNAME. Both args must be strings.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
171 Signals a `file-already-exists' error if file NEWNAME already exists,
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
172 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
173 A number as third arg means request confirmation if NEWNAME already exists.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
174 This is what happens in interactive use with M-x.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
175 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
176 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
177 A prefix arg makes KEEP-TIME non-nil."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
178 (if (and (file-exists-p newname)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
179 (not ok-if-already-exists))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
180 (error "Opening output file: File already exists, %s" newname))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
181 (let ((buffer (url-retrieve-synchronously url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
182 (handle nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
183 (if (not buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
184 (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
185 (with-current-buffer buffer
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
186 (setq handle (mm-dissect-buffer t)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
187 (mm-save-part-to-file handle newname)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
188 (kill-buffer buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
189 (mm-destroy-parts handle)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
190
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
191 ;;;###autoload
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
192 (defun url-file-local-copy (url &rest ignored)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
193 "Copy URL into a temporary file on this machine.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
194 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
195 accessible."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
196 (let ((filename (make-temp-name "url")))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
197 (url-copy-file url filename)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
198 filename))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
199
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
200 ;;;###autoload
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
201 (defun url-insert-file-contents (url &optional visit beg end replace)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
202 (let ((buffer (url-retrieve-synchronously url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
203 (handle nil)
66938
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
204 (charset nil)
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
205 (data nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
206 (if (not buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
207 (error "Opening input file: No such file or directory, %s" url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
208 (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
209 (with-current-buffer buffer
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
210 (setq handle (mm-dissect-buffer t))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
211 (set-buffer (mm-handle-buffer handle))
57174
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
212 (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
213 (buffer-string))))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
214 (kill-buffer buffer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
215 (mm-destroy-parts handle)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
216 (if replace (delete-region (point-min) (point-max)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
217 (save-excursion
66938
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
218 (setq charset (mail-content-type-get (mm-handle-type handle)
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
219 'charset))
57174
4202aed8aa86 (url-insert-file-contents): Decode contents.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54931
diff changeset
220 (let ((start (point)))
66938
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
221 (if charset
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
222 (insert (mm-decode-string data (mm-charset-to-coding-system charset)))
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
223 (progn
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
224 (insert data)
bb91429003e2 (url-insert-file-contents): Use the charset info
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66225
diff changeset
225 (decode-coding-inserted-region start (point) url visit beg end replace)))))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
226 (list url (length data))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
227
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
228 (defun url-file-name-completion (url directory)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
229 (error "Unimplemented"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
230
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
231 (defun url-file-name-all-completions (file directory)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
232 (error "Unimplemented"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
233
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
234 ;; All other handlers map onto their respective backends.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
235 (defmacro url-handlers-create-wrapper (method args)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
236 `(defun ,(intern (format "url-%s" method)) ,args
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
237 ,(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
238 (or (documentation method t) "No original documentation."))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
239 (setq url (url-generic-parse-url url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
240 (when (url-type url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
241 (funcall (url-scheme-get-property (url-type url) (quote ,method))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
242 ,@(remove '&rest (remove '&optional args))))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
243
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
244 (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
245 (url-handlers-create-wrapper file-attributes (url &optional id-format))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
246 (url-handlers-create-wrapper file-symlink-p (url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
247 (url-handlers-create-wrapper file-writable-p (url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
248 (url-handlers-create-wrapper file-directory-p (url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
249 (url-handlers-create-wrapper file-executable-p (url))
66225
eb65acc95303 Remove XEmacs conditionals.
Eli Zaretskii <eliz@gnu.org>
parents: 64748
diff changeset
250 (url-handlers-create-wrapper directory-files (url &optional full match nosort))
eb65acc95303 Remove XEmacs conditionals.
Eli Zaretskii <eliz@gnu.org>
parents: 64748
diff changeset
251 (url-handlers-create-wrapper file-truename (url &optional counter prev-dirs))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
252
54931
2a15e5a02a89 Use new find-file-hook.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54829
diff changeset
253 (add-hook 'find-file-hook 'url-handlers-set-buffer-mode)
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
254
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
255 (defun url-handlers-set-buffer-mode ()
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
256 "Set correct modes for the current buffer if visiting a remote file."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
257 (and (stringp buffer-file-name)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
258 (string-match url-handler-regexp buffer-file-name)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
259 (auto-save-mode 0)))
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 (provide 'url-handlers)
54699
7784ae10206d Resolve CVS conflicts
Miles Bader <miles@gnu.org>
parents: 54695
diff changeset
262
54829
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
263 ;; arch-tag: 7300b99c-cc83-42ff-9147-79b2723c62ac
e38bd75fb54e (url-handler-mode): New minor mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
264 ;;; url-handlers.el ends here