mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-12-12 19:33:52 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fix Issue17069: Document getcode method in urllib.request.rst

Browse Source
This commit is contained in:
Senthil Kumaran 2013-02-07 00:47:01 -08:00
parent 1acaf0bce2
commit b98e96a23f
1 changed files with 12 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Doc/library/urllib.request.rst
View File

@ -57,16 +57,24 @@ The :mod:`urllib.request` module defines the following functions:
If neither *cafile* nor *capath* is specified, an HTTPS request
will not do any verification of the server's certificate.
This function returns a file-like object that works as a :term:`context manager`,
with two additional methods from the :mod:`urllib.response` module
For http and https urls, this function returns a
:class:`http.client.HTTPResponse` object which has the following
:ref:`httpresponse-objects` methods.
* :meth:`geturl` --- return the URL of the resource retrieved,
For ftp, file, data urls and requests are explicity handled by legacy
:class:`URLopener` and :class:`FancyURLopener` class, this function returns
an :class:`urllib.response.addinfourl` 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,
commonly used to determine if a redirect was followed
* :meth:`info` --- return the meta-information of the page, such as headers,
* :meth:`~urllib.response.addinfourl.info` --- return the meta-information of the page, such as headers,
in the form of an :func:`email.message_from_string` instance (see
`Quick Reference to HTTP Headers <http://www.cs.tut.fi/~jkorpela/http.html>`_)
* :meth:`~urllib.response.addinfourl.getcode` -- return the HTTP status code of the response.
Raises :exc:`URLError` on errors.
Note that ``None`` may be returned if no handler handles the request (though