https://github.com/python/cpython/commit/11aef219f5186fcb9b8121651e5bdbd7e84c3a4e
commit: 11aef219f5186fcb9b8121651e5bdbd7e84c3a4e
branch: main
author: Bénédikt Tran <[email protected]>
committer: picnixz <[email protected]>
date: 2025-12-14T11:12:20+01:00
summary:
gh-141938: document treatment of `OSError` raised by
`HTTPConnection.getresponse` (#142339)
files:
M Doc/library/http.client.rst
diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst
index 7c258b324d9867..ddf3d40d221fcd 100644
--- a/Doc/library/http.client.rst
+++ b/Doc/library/http.client.rst
@@ -319,6 +319,12 @@ HTTPConnection Objects
:class:`str` or bytes-like object that is not also a file as the
body representation.
+ .. note::
+
+ Note that you must have read the whole response or call :meth:`close`
+ if :meth:`getresponse` raised an non-:exc:`ConnectionError` exception
+ before you can send a new request to the server.
+
.. versionchanged:: 3.2
*body* can now be an iterable.
@@ -334,16 +340,15 @@ HTTPConnection Objects
Should be called after a request is sent to get the response from the
server.
Returns an :class:`HTTPResponse` instance.
- .. note::
-
- Note that you must have read the whole response before you can send a new
- request to the server.
-
.. versionchanged:: 3.5
If a :exc:`ConnectionError` or subclass is raised, the
:class:`HTTPConnection` object will be ready to reconnect when
a new request is sent.
+ Note that this does not apply to :exc:`OSError`\s raised by the
underlying
+ socket. Instead the caller is responsible to call :meth:`close` on the
+ existing connection.
+
.. method:: HTTPConnection.set_debuglevel(level)
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
