Mercurial > emacs
annotate lisp/url/url.el @ 107168:282ddc0ca465
* simple.el (save-interprogram-paste-before-kill): Doc fix.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Tue, 16 Feb 2010 09:40:45 -0500 |
parents | 1d1d5d9bd884 |
children | ecbe0edc4f69 376148b31b5e |
rev | line source |
---|---|
54695 | 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 |
64748
875dcc490074
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64330
diff
changeset
|
3 ;; Copyright (C) 1996, 1997, 1998, 1999, 2001, 2004, |
106815 | 4 ;; 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. |
54832
8a894d554fb1
(url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
54770
diff
changeset
|
5 |
54695 | 6 ;; Author: Bill Perry <wmperry@gnu.org> |
7 ;; Keywords: comm, data, processes, hypermedia | |
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 ;; |
94668
8259d0d8e107
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
11 ;; GNU Emacs is free software: you can redistribute it and/or modify |
54832
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 |
94668
8259d0d8e107
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
13 ;; the Free Software Foundation, either version 3 of the License, or |
8259d0d8e107
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
14 ;; (at your option) any later version. |
8259d0d8e107
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
15 |
54832
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. |
94668
8259d0d8e107
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
20 |
54832
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 |
94668
8259d0d8e107
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
54832
8a894d554fb1
(url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
54770
diff
changeset
|
23 |
8a894d554fb1
(url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
54770
diff
changeset
|
24 ;;; Commentary: |
54695 | 25 |
26 ;; Registered URI schemes: http://www.iana.org/assignments/uri-schemes | |
27 | |
54832
8a894d554fb1
(url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
54770
diff
changeset
|
28 ;;; Code: |
8a894d554fb1
(url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
54770
diff
changeset
|
29 |
54695 | 30 (eval-when-compile (require 'cl)) |
31 | |
32 (eval-when-compile | |
33 (require 'mm-decode) | |
34 (require 'mm-view)) | |
35 | |
36 (require 'mailcap) | |
37 (require 'url-vars) | |
38 (require 'url-cookie) | |
39 (require 'url-history) | |
40 (require 'url-expand) | |
41 (require 'url-privacy) | |
42 (require 'url-methods) | |
43 (require 'url-proxy) | |
44 (require 'url-parse) | |
45 (require 'url-util) | |
46 | |
87255
54b328f5434f
(url-configuration-directory): Make it a defcustom.
Glenn Morris <rgm@gnu.org>
parents:
86275
diff
changeset
|
47 |
54b328f5434f
(url-configuration-directory): Make it a defcustom.
Glenn Morris <rgm@gnu.org>
parents:
86275
diff
changeset
|
48 (defcustom url-configuration-directory |
99107
83e9dcef8ef7
Fix braino in previous change.
Juanma Barranquero <lekktu@gmail.com>
parents:
99106
diff
changeset
|
49 (locate-user-emacs-file "url/" ".url/") |
87255
54b328f5434f
(url-configuration-directory): Make it a defcustom.
Glenn Morris <rgm@gnu.org>
parents:
86275
diff
changeset
|
50 "Directory used by the URL package for cookies, history, etc." |
54b328f5434f
(url-configuration-directory): Make it a defcustom.
Glenn Morris <rgm@gnu.org>
parents:
86275
diff
changeset
|
51 :type 'directory |
54b328f5434f
(url-configuration-directory): Make it a defcustom.
Glenn Morris <rgm@gnu.org>
parents:
86275
diff
changeset
|
52 :group 'url) |
54695 | 53 |
54 (defun url-do-setup () | |
96486
7369ded3b436
Typo and docstring fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
94668
diff
changeset
|
55 "Setup the URL package. |
54695 | 56 This is to avoid conflict with user settings if URL is dumped with |
57 Emacs." | |
58 (unless url-setup-done | |
59 | |
60 ;; Make OS/2 happy | |
61 ;;(push '("http" "80") tcp-binary-process-input-services) | |
62 | |
63 (mailcap-parse-mailcaps) | |
64 (mailcap-parse-mimetypes) | |
64748
875dcc490074
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64330
diff
changeset
|
65 |
54695 | 66 ;; Register all the authentication schemes we can handle |
67 (url-register-auth-scheme "basic" nil 4) | |
68 (url-register-auth-scheme "digest" nil 7) | |
69 | |
70 (setq url-cookie-file | |
71 (or url-cookie-file | |
72 (expand-file-name "cookies" url-configuration-directory))) | |
64748
875dcc490074
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64330
diff
changeset
|
73 |
54695 | 74 (setq url-history-file |
75 (or url-history-file | |
76 (expand-file-name "history" url-configuration-directory))) | |
64748
875dcc490074
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64330
diff
changeset
|
77 |
54695 | 78 ;; Parse the global history file if it exists, so that it can be used |
79 ;; for URL completion, etc. | |
80 (url-history-parse-history) | |
81 (url-history-setup-save-timer) | |
82 | |
83 ;; Ditto for cookies | |
84 (url-cookie-setup-save-timer) | |
85 (url-cookie-parse-file url-cookie-file) | |
86 | |
87 ;; Read in proxy gateways | |
88 (let ((noproxy (and (not (assoc "no_proxy" url-proxy-services)) | |
89 (or (getenv "NO_PROXY") | |
90 (getenv "no_PROXY") | |
91 (getenv "no_proxy"))))) | |
92 (if noproxy | |
93 (setq url-proxy-services | |
94 (cons (cons "no_proxy" | |
95 (concat "\\(" | |
96 (mapconcat | |
97 (lambda (x) | |
98 (cond | |
99 ((= x ?,) "\\|") | |
100 ((= x ? ) "") | |
101 ((= x ?.) (regexp-quote ".")) | |
102 ((= x ?*) ".*") | |
103 ((= x ??) ".") | |
104 (t (char-to-string x)))) | |
105 noproxy "") "\\)")) | |
106 url-proxy-services)))) | |
107 | |
108 (url-setup-privacy-info) | |
109 (run-hooks 'url-load-hook) | |
110 (setq url-setup-done t))) | |
111 | |
112 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
113 ;;; Retrieval functions | |
114 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
69044
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
115 |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
116 (defvar url-redirect-buffer nil |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
117 "New buffer into which the retrieval will take place. |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
118 Sometimes while retrieving a URL, the URL library needs to use another buffer |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
119 than the one returned initially by `url-retrieve'. In this case, it sets this |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
120 variable in the original buffer as a forwarding pointer.") |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
121 |
67975
ea32c9f0c8e7
(url-retrieve, url-retrieve-synchronously): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
67850
diff
changeset
|
122 ;;;###autoload |
54695 | 123 (defun url-retrieve (url callback &optional cbargs) |
124 "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
|
125 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
|
126 |
ba29905c8f52
(url-retrieve): The callback function can get an additional keyword arg pair.
Richard M. Stallman <rms@gnu.org>
parents:
64084
diff
changeset
|
127 CALLBACK is called when the object has been completely retrieved, with |
54695 | 128 the current buffer containing the object, and any MIME headers associated |
73502
147c5e159c28
* url.el (url-retrieve): Minor doc clarification.
Chong Yidong <cyd@stupidchicken.com>
parents:
73501
diff
changeset
|
129 with it. It is called as (apply CALLBACK STATUS CBARGS). |
147c5e159c28
* url.el (url-retrieve): Minor doc clarification.
Chong Yidong <cyd@stupidchicken.com>
parents:
73501
diff
changeset
|
130 STATUS is a list with an even number of elements representing |
147c5e159c28
* url.el (url-retrieve): Minor doc clarification.
Chong Yidong <cyd@stupidchicken.com>
parents:
73501
diff
changeset
|
131 what happened during the request, with most recent events first, |
147c5e159c28
* url.el (url-retrieve): Minor doc clarification.
Chong Yidong <cyd@stupidchicken.com>
parents:
73501
diff
changeset
|
132 or an empty list if no events have occurred. Each pair is one of: |
73501
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
133 |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
134 \(:redirect REDIRECTED-TO) - the request was redirected to this URL |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
135 \(:error (ERROR-SYMBOL . DATA)) - an error occurred. The error can be |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
136 signaled with (signal ERROR-SYMBOL DATA). |
54695 | 137 |
138 Return the buffer URL will load into, or nil if the process has | |
73501
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
139 already completed (i.e. URL was a mailto URL or similar; in this case |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
140 the callback is not called). |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
141 |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
142 The variables `url-request-data', `url-request-method' and |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
143 `url-request-extra-headers' can be dynamically bound around the |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
144 request; dynamic binding of other variables doesn't necessarily |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
145 take effect." |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
146 ;;; XXX: There is code in Emacs that does dynamic binding |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
147 ;;; of the following variables around url-retrieve: |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
148 ;;; url-standalone-mode, url-gateway-unplugged, w3-honor-stylesheets, |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
149 ;;; url-confirmation-func, url-cookie-multiple-line, |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
150 ;;; url-cookie-{{,secure-}storage,confirmation} |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
151 ;;; url-standalone-mode and url-gateway-unplugged should work as |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
152 ;;; usual. url-confirmation-func is only used in nnwarchive.el and |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
153 ;;; webmail.el; the latter should be updated. Is |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
154 ;;; url-cookie-multiple-line needed anymore? The other url-cookie-* |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
155 ;;; are (for now) only used in synchronous retrievals. |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
156 (url-retrieve-internal url callback (cons nil cbargs))) |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
157 |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
158 (defun url-retrieve-internal (url callback cbargs) |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
159 "Internal function; external interface is `url-retrieve'. |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
160 CBARGS is what the callback will actually receive - the first item is |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
161 the list of events, as described in the docstring of `url-retrieve'." |
54695 | 162 (url-do-setup) |
163 (url-gc-dead-buffers) | |
164 (if (stringp url) | |
165 (set-text-properties 0 (length url) nil url)) | |
166 (if (not (vectorp url)) | |
167 (setq url (url-generic-parse-url url))) | |
168 (if (not (functionp callback)) | |
169 (error "Must provide a callback function to url-retrieve")) | |
170 (unless (url-type url) | |
171 (error "Bad url: %s" (url-recreate-url url))) | |
172 (let ((loader (url-scheme-get-property (url-type url) 'loader)) | |
173 (url-using-proxy (if (url-host url) | |
174 (url-find-proxy-for-url url (url-host url)))) | |
175 (buffer nil) | |
176 (asynch (url-scheme-get-property (url-type url) 'asynchronous-p))) | |
177 (if url-using-proxy | |
178 (setq asynch t | |
179 loader 'url-proxy)) | |
180 (if asynch | |
181 (setq buffer (funcall loader url callback cbargs)) | |
182 (setq buffer (funcall loader url)) | |
183 (if buffer | |
54832
8a894d554fb1
(url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
54770
diff
changeset
|
184 (with-current-buffer buffer |
54695 | 185 (apply callback cbargs)))) |
67236
7a5248410af9
(url-retrieve): Test url-history-track.
Richard M. Stallman <rms@gnu.org>
parents:
66118
diff
changeset
|
186 (if url-history-track |
7a5248410af9
(url-retrieve): Test url-history-track.
Richard M. Stallman <rms@gnu.org>
parents:
66118
diff
changeset
|
187 (url-history-update-url url (current-time))) |
54695 | 188 buffer)) |
189 | |
67975
ea32c9f0c8e7
(url-retrieve, url-retrieve-synchronously): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
67850
diff
changeset
|
190 ;;;###autoload |
54695 | 191 (defun url-retrieve-synchronously (url) |
192 "Retrieve URL synchronously. | |
193 Return the buffer containing the data, or nil if there are no data | |
194 associated with it (the case for dired, info, or mailto URLs that need | |
195 no further processing). URL is either a string or a parsed URL." | |
196 (url-do-setup) | |
197 | |
198 (lexical-let ((retrieval-done nil) | |
199 (asynch-buffer nil)) | |
200 (setq asynch-buffer | |
201 (url-retrieve url (lambda (&rest ignored) | |
202 (url-debug 'retrieval "Synchronous fetching done (%S)" (current-buffer)) | |
203 (setq retrieval-done t | |
204 asynch-buffer (current-buffer))))) | |
63288
5439e59a340c
(url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
61630
diff
changeset
|
205 (if (null asynch-buffer) |
5439e59a340c
(url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
61630
diff
changeset
|
206 ;; 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
|
207 ;; 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
|
208 ;; package. |
5439e59a340c
(url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
61630
diff
changeset
|
209 nil |
5439e59a340c
(url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
61630
diff
changeset
|
210 (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
|
211 ;; 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
|
212 ;; 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
|
213 ;; 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
|
214 ;; 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
|
215 ;; 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
|
216 ;; 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
|
217 ;; 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
|
218 ;; 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
|
219 (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
|
220 (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
|
221 "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
|
222 retrieval-done asynch-buffer) |
69044
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
223 (if (buffer-local-value 'url-redirect-buffer asynch-buffer) |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
224 (setq proc (get-buffer-process |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
225 (setq asynch-buffer |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
226 (buffer-local-value 'url-redirect-buffer |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
227 asynch-buffer)))) |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
228 (if (and proc (memq (process-status proc) |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
229 '(closed exit signal failed)) |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
230 ;; Make sure another process hasn't been started. |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
231 (eq proc (or (get-buffer-process asynch-buffer) proc))) |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
232 ;; FIXME: It's not clear whether url-retrieve's callback is |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
233 ;; guaranteed to be called or not. It seems that url-http |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
234 ;; decides sometimes consciously not to call it, so it's not |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
235 ;; clear that it's a bug, but even then we need to decide how |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
236 ;; url-http can then warn us that the download has completed. |
8edc29039fd2
(url-redirect-buffer): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
68123
diff
changeset
|
237 ;; In the mean time, we use this here workaround. |
73501
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
238 ;; XXX: The callback must always be called. Any |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
239 ;; exception is a bug that should be fixed, not worked |
437fb645afb4
* url-http.el (url-http-mark-connection-as-free): Verify that
Chong Yidong <cyd@stupidchicken.com>
parents:
69044
diff
changeset
|
240 ;; around. |
79396
e1aef858fc08
(url-retrieve-synchronously): Call delete-process.
Richard M. Stallman <rms@gnu.org>
parents:
78222
diff
changeset
|
241 (progn ;; Call delete-process so we run any sentinel now. |
e1aef858fc08
(url-retrieve-synchronously): Call delete-process.
Richard M. Stallman <rms@gnu.org>
parents:
78222
diff
changeset
|
242 (delete-process proc) |
e1aef858fc08
(url-retrieve-synchronously): Call delete-process.
Richard M. Stallman <rms@gnu.org>
parents:
78222
diff
changeset
|
243 (setq retrieval-done t))) |
61630
68114d546e48
(url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
59518
diff
changeset
|
244 ;; 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
|
245 ;; 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
|
246 ;; 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
|
247 ;; `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
|
248 ;; hanging. --Stef |
73814
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
249 (unless (or (with-local-quit |
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
250 (accept-process-output proc)) |
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
251 (null proc)) |
61630
68114d546e48
(url-retrieve-synchronously): Work around the fact that
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
59518
diff
changeset
|
252 ;; accept-process-output returned nil, maybe because the process |
73814
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
253 ;; exited (and may have been replaced with another). If we got |
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
254 ;; a quit, just stop. |
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
255 (when quit-flag |
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
256 (delete-process proc)) |
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
257 (setq proc (and (not quit-flag) |
22da3e31207f
(url-retrieve-synchronously): Allow quitting when inhibit-quit is t.
Magnus Henoch <mange@freemail.hu>
parents:
73502
diff
changeset
|
258 (get-buffer-process asynch-buffer))))))) |
54695 | 259 asynch-buffer))) |
260 | |
261 (defun url-mm-callback (&rest ignored) | |
262 (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
|
263 (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
|
264 (with-current-buffer |
5439e59a340c
(url-retrieve-synchronously): Don't exit precipitously when
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
61630
diff
changeset
|
265 (generate-new-buffer (url-recreate-url url-current-object)) |
54695 | 266 (if (eq (mm-display-part handle) 'external) |
267 (progn | |
268 (set-process-sentinel | |
269 ;; Fixme: this shouldn't have to know the form of the | |
270 ;; undisplayer produced by `mm-display-part'. | |
271 (get-buffer-process (cdr (mm-handle-undisplayer handle))) | |
272 `(lambda (proc event) | |
273 (mm-destroy-parts (quote ,handle)))) | |
274 (message "Viewing externally") | |
275 (kill-buffer (current-buffer))) | |
276 (display-buffer (current-buffer)) | |
64748
875dcc490074
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64330
diff
changeset
|
277 (add-hook 'kill-buffer-hook |
58343
d9b4c5625386
(url-mm-callback): Delay the invocation
Masatake YAMATO <jet@gyve.org>
parents:
57515
diff
changeset
|
278 `(lambda () (mm-destroy-parts ',handle)) |
d9b4c5625386
(url-mm-callback): Delay the invocation
Masatake YAMATO <jet@gyve.org>
parents:
57515
diff
changeset
|
279 nil |
d9b4c5625386
(url-mm-callback): Delay the invocation
Masatake YAMATO <jet@gyve.org>
parents:
57515
diff
changeset
|
280 t))))) |
54695 | 281 |
282 (defun url-mm-url (url) | |
283 "Retrieve URL and pass to the appropriate viewing application." | |
66118
c0fac24c378a
*** empty log message ***
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
66100
diff
changeset
|
284 ;; These requires could advantageously be moved to url-mm-callback or |
c0fac24c378a
*** empty log message ***
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
66100
diff
changeset
|
285 ;; turned into autoloads, but I suspect that it would introduce some bugs |
c0fac24c378a
*** empty log message ***
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
66100
diff
changeset
|
286 ;; because loading those files from a process sentinel or filter may |
c0fac24c378a
*** empty log message ***
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
66100
diff
changeset
|
287 ;; result in some undesirable carner cases. |
54695 | 288 (require 'mm-decode) |
289 (require 'mm-view) | |
290 (url-retrieve url 'url-mm-callback nil)) | |
291 | |
292 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
293 ;;; Miscellaneous | |
294 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
295 (defvar url-dead-buffer-list nil) | |
296 | |
297 (defun url-mark-buffer-as-dead (buff) | |
298 (push buff url-dead-buffer-list)) | |
299 | |
300 (defun url-gc-dead-buffers () | |
301 (let ((buff)) | |
302 (while (setq buff (pop url-dead-buffer-list)) | |
303 (if (buffer-live-p buff) | |
304 (kill-buffer buff))))) | |
305 | |
306 (cond | |
307 ((fboundp 'display-warning) | |
308 (defalias 'url-warn 'display-warning)) | |
309 ((fboundp 'warn) | |
310 (defun url-warn (class message &optional level) | |
311 (warn "(%s/%s) %s" class (or level 'warning) message))) | |
312 (t | |
313 (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
|
314 (with-current-buffer (get-buffer-create "*URL-WARNINGS*") |
54695 | 315 (goto-char (point-max)) |
316 (save-excursion | |
317 (insert (format "(%s/%s) %s\n" class (or level 'warning) message))) | |
318 (display-buffer (current-buffer)))))) | |
319 | |
320 (provide 'url) | |
321 | |
54832
8a894d554fb1
(url-retrieve): Use with-current-buffer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
54770
diff
changeset
|
322 ;; arch-tag: bc182f1f-d187-4f10-b961-47af2066579a |
54695 | 323 ;;; url.el ends here |