Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

gh-101536: [docs] Improve attributes of `urllib.error.HTTPError` (#101612) 

* gh-101536: [docs] Improve attributes of `urllib.error.HTTPError`

* Address review
This commit is contained in:
Nikita Sobolev 2023-02-18 18:46:33 +03:00 committed by GitHub
parent 89413bbccb
commit af446bbb76
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Doc/library/urllib.error.rst
View File

@ -31,7 +31,7 @@ The following exceptions are raised by :mod:`urllib.error` as appropriate:
of :exc:`IOError`.
.. exception:: HTTPError
.. exception:: HTTPError(url, code, msg, hdrs, fp)
Though being an exception (a subclass of :exc:`URLError`), an
:exc:`HTTPError` can also function as a non-exceptional file-like return
@ -39,6 +39,11 @@ The following exceptions are raised by :mod:`urllib.error` as appropriate:
is useful when handling exotic HTTP errors, such as requests for
authentication.
.. attribute:: url
Contains the request URL.
An alias for *filename* attribute.
.. attribute:: code
An HTTP status code as defined in :rfc:`2616`. This numeric value corresponds
@ -48,14 +53,20 @@ The following exceptions are raised by :mod:`urllib.error` as appropriate:
.. attribute:: reason
This is usually a string explaining the reason for this error.
An alias for *msg* attribute.
.. attribute:: headers
The HTTP response headers for the HTTP request that caused the
:exc:`HTTPError`.
An alias for *hdrs* attribute.
.. versionadded:: 3.4
.. attribute:: fp
A file-like object where the HTTP error body can be read from.
.. exception:: ContentTooShortError(msg, content)
This exception is raised when the :func:`~urllib.request.urlretrieve`