annotate lisp/url/url.el @ 102632:1287a731cd99

(Ffile_attributes): Make sure UID and GID are always positive, even if the value is too large for a positive EMACS_INT. Doc fix.
author Eli Zaretskii <eliz@gnu.org>
date Wed, 18 Mar 2009 20:37:34 +0000
parents a9dc0e7c3f2b
children 1d1d5d9bd884
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
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,
100908
a9dc0e7c3f2b Add 2009 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 99107
diff changeset
4 ;; 2005, 2006, 2007, 2008, 2009 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 ;;
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
25
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
26 ;; Registered URI schemes: http://www.iana.org/assignments/uri-schemes
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
30 (eval-when-compile (require 'cl))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
31
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
32 (eval-when-compile
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
33 (require 'mm-decode)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
34 (require 'mm-view))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
35
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
36 (require 'mailcap)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
37 (require 'url-vars)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
38 (require 'url-cookie)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
39 (require 'url-history)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
40 (require 'url-expand)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
41 (require 'url-privacy)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
42 (require 'url-methods)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
43 (require 'url-proxy)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
44 (require 'url-parse)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
45 (require 'url-util)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
53
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
56 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
57 Emacs."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
58 (unless url-setup-done
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
59
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
60 ;; Make OS/2 happy
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
61 ;;(push '("http" "80") tcp-binary-process-input-services)
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 (mailcap-parse-mailcaps)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
64 (mailcap-parse-mimetypes)
64748
875dcc490074 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64330
diff changeset
65
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
66 ;; Register all the authentication schemes we can handle
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
67 (url-register-auth-scheme "basic" nil 4)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
68 (url-register-auth-scheme "digest" nil 7)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
69
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
70 (setq url-cookie-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
71 (or url-cookie-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
74 (setq url-history-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
75 (or url-history-file
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
78 ;; 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
79 ;; for URL completion, etc.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
80 (url-history-parse-history)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
81 (url-history-setup-save-timer)
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 ;; Ditto for cookies
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
84 (url-cookie-setup-save-timer)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
85 (url-cookie-parse-file url-cookie-file)
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 ;; Read in proxy gateways
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
88 (let ((noproxy (and (not (assoc "no_proxy" url-proxy-services))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
89 (or (getenv "NO_PROXY")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
90 (getenv "no_PROXY")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
91 (getenv "no_proxy")))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
92 (if noproxy
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
93 (setq url-proxy-services
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
94 (cons (cons "no_proxy"
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
95 (concat "\\("
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
96 (mapconcat
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
97 (lambda (x)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
98 (cond
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
99 ((= x ?,) "\\|")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
100 ((= x ? ) "")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
101 ((= x ?.) (regexp-quote "."))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
102 ((= x ?*) ".*")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
103 ((= x ??) ".")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
104 (t (char-to-string x))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
105 noproxy "") "\\)"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
106 url-proxy-services))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
107
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
108 (url-setup-privacy-info)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
109 (run-hooks 'url-load-hook)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
110 (setq url-setup-done t)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
111
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
112 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
113 ;;; Retrieval functions
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
123 (defun url-retrieve (url callback &optional cbargs)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
137
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
162 (url-do-setup)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
163 (url-gc-dead-buffers)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
164 (if (stringp url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
165 (set-text-properties 0 (length url) nil url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
166 (if (not (vectorp url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
167 (setq url (url-generic-parse-url url)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
168 (if (not (functionp callback))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
169 (error "Must provide a callback function to url-retrieve"))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
170 (unless (url-type url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
171 (error "Bad url: %s" (url-recreate-url url)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
172 (let ((loader (url-scheme-get-property (url-type url) 'loader))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
173 (url-using-proxy (if (url-host url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
174 (url-find-proxy-for-url url (url-host url))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
175 (buffer nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
176 (asynch (url-scheme-get-property (url-type url) 'asynchronous-p)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
177 (if url-using-proxy
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
178 (setq asynch t
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
179 loader 'url-proxy))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
180 (if asynch
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
181 (setq buffer (funcall loader url callback cbargs))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
182 (setq buffer (funcall loader url))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
188 buffer))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
189
67975
ea32c9f0c8e7 (url-retrieve, url-retrieve-synchronously): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 67850
diff changeset
190 ;;;###autoload
54695
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
191 (defun url-retrieve-synchronously (url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
192 "Retrieve URL synchronously.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
193 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
194 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
195 no further processing). URL is either a string or a parsed URL."
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
196 (url-do-setup)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
197
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
198 (lexical-let ((retrieval-done nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
199 (asynch-buffer nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
200 (setq asynch-buffer
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
201 (url-retrieve url (lambda (&rest ignored)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
202 (url-debug 'retrieval "Synchronous fetching done (%S)" (current-buffer))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
203 (setq retrieval-done t
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
259 asynch-buffer)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
260
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
261 (defun url-mm-callback (&rest ignored)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
266 (if (eq (mm-display-part handle) 'external)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
267 (progn
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
268 (set-process-sentinel
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
269 ;; Fixme: this shouldn't have to know the form of the
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
270 ;; undisplayer produced by `mm-display-part'.
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
271 (get-buffer-process (cdr (mm-handle-undisplayer handle)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
272 `(lambda (proc event)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
273 (mm-destroy-parts (quote ,handle))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
274 (message "Viewing externally")
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
275 (kill-buffer (current-buffer)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
281
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
282 (defun url-mm-url (url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
288 (require 'mm-decode)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
289 (require 'mm-view)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
290 (url-retrieve url 'url-mm-callback nil))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
291
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
292 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
293 ;;; Miscellaneous
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
294 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
295 (defvar url-dead-buffer-list nil)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
296
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
297 (defun url-mark-buffer-as-dead (buff)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
298 (push buff url-dead-buffer-list))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
299
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
300 (defun url-gc-dead-buffers ()
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
301 (let ((buff))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
302 (while (setq buff (pop url-dead-buffer-list))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
303 (if (buffer-live-p buff)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
304 (kill-buffer buff)))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
305
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
306 (cond
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
307 ((fboundp 'display-warning)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
308 (defalias 'url-warn 'display-warning))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
309 ((fboundp 'warn)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
310 (defun url-warn (class message &optional level)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
311 (warn "(%s/%s) %s" class (or level 'warning) message)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
312 (t
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
315 (goto-char (point-max))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
316 (save-excursion
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
317 (insert (format "(%s/%s) %s\n" class (or level 'warning) message)))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
318 (display-buffer (current-buffer))))))
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
319
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
320 (provide 'url)
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
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
3fb37923e567 Initial revision
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff changeset
323 ;;; url.el ends here