annotate lisp/url/url.el @ 64560:8e6e95602853

(eshell-ls-decorated-name): Doc fix. (eshell-ls-missing, eshell-ls-dired-initial-args, eshell-ls-use-in-dired): Fix typos in docstrings.
author Juanma Barranquero <lekktu@gmail.com>
date Thu, 21 Jul 2005 10:03:50 +0000
parents ba29905c8f52
children 875dcc490074
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.el --- Uniform Resource Locator retrieval tool
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
2
59518
d91d1f84814f (url-retrieve-synchronously): Use accept-process-output rather than sit-for.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 58343
diff changeset
3 ;; Copyright (c) 1996, 1997, 1998, 1999, 2001, 2004, 2005
d91d1f84814f (url-retrieve-synchronously): Use accept-process-output rather than sit-for.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 58343
diff changeset
4 ;; Free Software Foundation, Inc.
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
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 ;; Author: Bill Perry <wmperry@gnu.org>
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
7 ;; Keywords: comm, data, processes, hypermedia
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
8
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
9 ;; This file is part of GNU Emacs.
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
10 ;;
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
12 ;; it under the terms of the GNU General Public License as published by
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
13 ;; the Free Software Foundation; either version 2, or (at your option)
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
14 ;; any later version.
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
15 ;;
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
16 ;; GNU Emacs is distributed in the hope that it will be useful,
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
19 ;; GNU General Public License for more details.
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
20 ;;
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
21 ;; You should have received a copy of the GNU General Public License
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
22 ;; 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: 63288
diff changeset
23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
a8fa7c632ee4 Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 63288
diff changeset
24 ;; Boston, MA 02110-1301, USA.
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
25
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
26 ;;; Commentary:
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
27
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
28 ;; Registered URI schemes: http://www.iana.org/assignments/uri-schemes
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
29
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
30 ;;; Code:
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
31
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
32 (eval-when-compile (require 'cl))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
33 ;; Don't require CL at runtime if we can avoid it (Emacs 21).
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
34 ;; Otherwise we need it for hashing functions. `puthash' was never
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
35 ;; defined in the Emacs 20 cl.el for some reason.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
36 (if (fboundp 'puthash)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
37 nil ; internal or CL is loaded
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
38 (defalias 'puthash 'cl-puthash)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
39 (autoload 'cl-puthash "cl")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
40 (autoload 'gethash "cl")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
41 (autoload 'maphash "cl")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
42 (autoload 'make-hash-table "cl"))
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 'mm-decode)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
46 (require 'mm-view))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
47
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
48 (require 'mailcap)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
49 (require 'url-vars)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
50 (require 'url-cookie)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
51 (require 'url-history)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
52 (require 'url-expand)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
53 (require 'url-privacy)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
54 (require 'url-methods)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
55 (require 'url-proxy)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
56 (require 'url-parse)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
57 (require 'url-util)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
58
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
59 ;; Fixme: customize? convert-standard-filename?
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
60 ;;;###autoload
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
61 (defvar url-configuration-directory "~/.url")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
62
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
63 (defun url-do-setup ()
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
64 "Setup the url package.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
65 This is to avoid conflict with user settings if URL is dumped with
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
66 Emacs."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
67 (unless url-setup-done
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
68
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
69 ;; Make OS/2 happy
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
70 ;;(push '("http" "80") tcp-binary-process-input-services)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
71
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
72 (mailcap-parse-mailcaps)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
73 (mailcap-parse-mimetypes)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
74
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
75 ;; Register all the authentication schemes we can handle
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
76 (url-register-auth-scheme "basic" nil 4)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
77 (url-register-auth-scheme "digest" nil 7)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
78
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
79 (setq url-cookie-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
80 (or url-cookie-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
81 (expand-file-name "cookies" url-configuration-directory)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
82
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
83 (setq url-history-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
84 (or url-history-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
85 (expand-file-name "history" url-configuration-directory)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
86
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
87 ;; Parse the global history file if it exists, so that it can be used
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
88 ;; for URL completion, etc.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
89 (url-history-parse-history)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
90 (url-history-setup-save-timer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
91
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
92 ;; Ditto for cookies
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
93 (url-cookie-setup-save-timer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
94 (url-cookie-parse-file url-cookie-file)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
95
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
96 ;; Read in proxy gateways
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
97 (let ((noproxy (and (not (assoc "no_proxy" url-proxy-services))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
98 (or (getenv "NO_PROXY")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
99 (getenv "no_PROXY")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
100 (getenv "no_proxy")))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
101 (if noproxy
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
102 (setq url-proxy-services
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
103 (cons (cons "no_proxy"
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
104 (concat "\\("
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
105 (mapconcat
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
106 (lambda (x)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
107 (cond
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
108 ((= x ?,) "\\|")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
109 ((= x ? ) "")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
110 ((= x ?.) (regexp-quote "."))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
111 ((= x ?*) ".*")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
112 ((= x ??) ".")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
113 (t (char-to-string x))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
114 noproxy "") "\\)"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
115 url-proxy-services))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
116
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
117 (url-setup-privacy-info)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
118 (run-hooks 'url-load-hook)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
119 (setq url-setup-done t)))
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 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
122 ;;; Retrieval functions
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
123 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
124 (defun url-retrieve (url callback &optional cbargs)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
125 "Retrieve URL asynchronously and call CALLBACK with CBARGS when finished.
64330
ba29905c8f52 (url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents: 64084
diff changeset
126 URL is either a string or a parsed URL.
ba29905c8f52 (url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents: 64084
diff changeset
127
ba29905c8f52 (url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents: 64084
diff changeset
128 CALLBACK is called when the object has been completely retrieved, with
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
129 the current buffer containing the object, and any MIME headers associated
64330
ba29905c8f52 (url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents: 64084
diff changeset
130 with it. Normally it gets the arguments in the list CBARGS.
ba29905c8f52 (url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents: 64084
diff changeset
131 However, if what we find is a redirect, CALLBACK is given
ba29905c8f52 (url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents: 64084
diff changeset
132 two additional args, `:redirect' and the redirected URL,
ba29905c8f52 (url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents: 64084
diff changeset
133 followed by CBARGS.
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
134
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
135 Return the buffer URL will load into, or nil if the process has
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
136 already completed."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
137 (url-do-setup)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
138 (url-gc-dead-buffers)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
139 (if (stringp url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
140 (set-text-properties 0 (length url) nil url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
141 (if (not (vectorp url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
142 (setq url (url-generic-parse-url url)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
143 (if (not (functionp callback))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
144 (error "Must provide a callback function to url-retrieve"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
145 (unless (url-type url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
146 (error "Bad url: %s" (url-recreate-url url)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
147 (let ((loader (url-scheme-get-property (url-type url) 'loader))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
148 (url-using-proxy (if (url-host url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
149 (url-find-proxy-for-url url (url-host url))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
150 (buffer nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
151 (asynch (url-scheme-get-property (url-type url) 'asynchronous-p)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
152 (if url-using-proxy
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
153 (setq asynch t
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
154 loader 'url-proxy))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
155 (if asynch
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
156 (setq buffer (funcall loader url callback cbargs))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
157 (setq buffer (funcall loader url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
158 (if buffer
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
159 (with-current-buffer buffer
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
160 (apply callback cbargs))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
161 (url-history-update-url url (current-time))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
162 buffer))
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 (defun url-retrieve-synchronously (url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
165 "Retrieve URL synchronously.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
166 Return the buffer containing the data, or nil if there are no data
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
167 associated with it (the case for dired, info, or mailto URLs that need
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
168 no further processing). URL is either a string or a parsed URL."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
169 (url-do-setup)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
170
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
171 (lexical-let ((retrieval-done nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
172 (asynch-buffer nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
173 (setq asynch-buffer
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
174 (url-retrieve url (lambda (&rest ignored)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
175 (url-debug 'retrieval "Synchronous fetching done (%S)" (current-buffer))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
176 (setq retrieval-done t
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
177 asynch-buffer (current-buffer)))))
63288
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
178 (if (null asynch-buffer)
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
179 ;; We do not need to do anything, it was a mailto or something
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
180 ;; similar that takes processing completely outside of the URL
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
181 ;; package.
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
182 nil
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
183 (let ((proc (get-buffer-process asynch-buffer)))
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
184 ;; If the access method was synchronous, `retrieval-done' should
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
185 ;; hopefully already be set to t. If it is nil, and `proc' is also
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
186 ;; nil, it implies that the async process is not running in
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
187 ;; asynch-buffer. This happens e.g. for FTP files. In such a case
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
188 ;; url-file.el should probably set something like a `url-process'
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
189 ;; buffer-local variable so we can find the exact process that we
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
190 ;; should be waiting for. In the mean time, we'll just wait for any
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
191 ;; process output.
59518
d91d1f84814f (url-retrieve-synchronously): Use accept-process-output rather than sit-for.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 58343
diff changeset
192 (while (not retrieval-done)
d91d1f84814f (url-retrieve-synchronously): Use accept-process-output rather than sit-for.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 58343
diff changeset
193 (url-debug 'retrieval
d91d1f84814f (url-retrieve-synchronously): Use accept-process-output rather than sit-for.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 58343
diff changeset
194 "Spinning in url-retrieve-synchronously: %S (%S)"
d91d1f84814f (url-retrieve-synchronously): Use accept-process-output rather than sit-for.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 58343
diff changeset
195 retrieval-done asynch-buffer)
63288
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
196 (if (and proc (memq (process-status proc)
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
197 '(closed exit signal failed)))
61630
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
198 ;; FIXME: It's not clear whether url-retrieve's callback is
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
199 ;; guaranteed to be called or not. It seems that url-http
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
200 ;; decides sometimes consciously not to call it, so it's not
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
201 ;; clear that it's a bug, but even if we need to decide how
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
202 ;; url-http can then warn us that the download has completed.
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
203 ;; In the mean time, we use this here workaround.
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
204 (setq retrieval-done t)
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
205 ;; We used to use `sit-for' here, but in some cases it wouldn't
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
206 ;; work because apparently pending keyboard input would always
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
207 ;; interrupt it before it got a chance to handle process input.
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
208 ;; `sleep-for' was tried but it lead to other forms of
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
209 ;; hanging. --Stef
63288
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
210 (unless (or (accept-process-output proc) (null proc))
61630
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
211 ;; accept-process-output returned nil, maybe because the process
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
212 ;; exited (and may have been replaced with another).
68114d546e48 (url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 59518
diff changeset
213 (setq proc (get-buffer-process asynch-buffer))))))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
214 asynch-buffer)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
215
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
216 (defun url-mm-callback (&rest ignored)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
217 (let ((handle (mm-dissect-buffer t)))
63288
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
218 (url-mark-buffer-as-dead (current-buffer))
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
219 (with-current-buffer
5439e59a340c (url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 61630
diff changeset
220 (generate-new-buffer (url-recreate-url url-current-object))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
221 (if (eq (mm-display-part handle) 'external)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
222 (progn
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
223 (set-process-sentinel
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
224 ;; Fixme: this shouldn't have to know the form of the
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
225 ;; undisplayer produced by `mm-display-part'.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
226 (get-buffer-process (cdr (mm-handle-undisplayer handle)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
227 `(lambda (proc event)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
228 (mm-destroy-parts (quote ,handle))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
229 (message "Viewing externally")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
230 (kill-buffer (current-buffer)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
231 (display-buffer (current-buffer))
58343
d9b4c5625386 (url-mm-callback): Delay the invocation
Masatake YAMATO <jet@gyve.org>
parents: 57515
diff changeset
232 (add-hook 'kill-buffer-hook
d9b4c5625386 (url-mm-callback): Delay the invocation
Masatake YAMATO <jet@gyve.org>
parents: 57515
diff changeset
233 `(lambda () (mm-destroy-parts ',handle))
d9b4c5625386 (url-mm-callback): Delay the invocation
Masatake YAMATO <jet@gyve.org>
parents: 57515
diff changeset
234 nil
d9b4c5625386 (url-mm-callback): Delay the invocation
Masatake YAMATO <jet@gyve.org>
parents: 57515
diff changeset
235 t)))))
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
236
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
237 (defun url-mm-url (url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
238 "Retrieve URL and pass to the appropriate viewing application."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
239 (require 'mm-decode)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
240 (require 'mm-view)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
241 (url-retrieve url 'url-mm-callback nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
242
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 ;;; Miscellaneous
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 (defvar url-dead-buffer-list nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
247
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
248 (defun url-mark-buffer-as-dead (buff)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
249 (push buff url-dead-buffer-list))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
250
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
251 (defun url-gc-dead-buffers ()
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
252 (let ((buff))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
253 (while (setq buff (pop url-dead-buffer-list))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
254 (if (buffer-live-p buff)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
255 (kill-buffer buff)))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
256
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
257 (cond
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
258 ((fboundp 'display-warning)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
259 (defalias 'url-warn 'display-warning))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
260 ((fboundp 'warn)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
261 (defun url-warn (class message &optional level)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
262 (warn "(%s/%s) %s" class (or level 'warning) message)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
263 (t
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
264 (defun url-warn (class message &optional level)
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
265 (with-current-buffer (get-buffer-create "*URL-WARNINGS*")
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
266 (goto-char (point-max))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
267 (save-excursion
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
268 (insert (format "(%s/%s) %s\n" class (or level 'warning) message)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
269 (display-buffer (current-buffer))))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
270
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
271 (provide 'url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
272
54832
8a894d554fb1 (url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 54770
diff changeset
273 ;; arch-tag: bc182f1f-d187-4f10-b961-47af2066579a
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
274 ;;; url.el ends here