cpython: c6930661599b (original) (raw)

Mercurial > cpython

changeset 99372:c6930661599b

Issue #22989, #21228: Merge urlopen() doc from 3.5 [#22989]

Martin Panter vadmium+py@gmail.com
date	Thu, 26 Nov 2015 11:04:06 +0000
parents	3c1ec06f5324(current diff)b55c006b79bc(diff)
children	9fcfdb53e8af
files	Misc/ACKS
diffstat	2 files changed, 14 insertions(+), 7 deletions(-)[+] [-] Doc/library/urllib.request.rst 20 Misc/ACKS 1

line wrap: on

line diff

--- a/Doc/library/urllib.request.rst +++ b/Doc/library/urllib.request.rst @@ -59,13 +59,7 @@ The :mod:urllib.request module defines The cadefault parameter is ignored.

For http and https urls, this function returns a
:class:http.client.HTTPResponse object which has the following
:ref:httpresponse-objects methods. -
For ftp, file, and data urls and requests explicitly handled by legacy
:class:URLopener and :class:FancyURLopener classes, this function
returns a :class:urllib.response.addinfourl object which can work as

This function always returns an object which can work as :term:context manager and has methods such as
- :meth:~urllib.response.addinfourl.geturl --- return the URL of the resource retrieved, @@ -77,6 +71,18 @@ The :mod:urllib.request module defines
- :meth:~urllib.response.addinfourl.getcode -- return the HTTP status code of the response.
For http and https urls, this function returns a
:class:http.client.HTTPResponse object slightly modified. In addition
to the three new methods above, the msg attribute contains the
same information as the :attr:~http.client.HTTPResponse.reason
attribute --- the reason phrase returned by server --- instead of
the response headers as it is specified in the documentation for
:class:~http.client.HTTPResponse. +
For ftp, file, and data urls and requests explicitly handled by legacy
:class:URLopener and :class:FancyURLopener classes, this function
returns a :class:urllib.response.addinfourl object. + Raises :exc:~urllib.error.URLError on errors. Note that None may be returned if no handler handles the request (though

--- a/Misc/ACKS +++ b/Misc/ACKS @@ -444,6 +444,7 @@ Arnaud Fontaine Michael Foord Amaury Forgeot d'Arc Doug Fort +Evens Fortuné Chris Foster John Fouhy Andrew Francis