https://github.com/python/cpython/commit/1fece4457032382947c7c2a5c9e95dc106ca7a7d
commit: 1fece4457032382947c7c2a5c9e95dc106ca7a7d
branch: main
author: Kumar Aditya <[email protected]>
committer: kumaraditya303 <[email protected]>
date: 2026-07-13T15:16:24+05:30
summary:
gh-89696: Fix `loop.sock_connect` docs on address resolution (#153651)
files:
M Doc/library/asyncio-eventloop.rst
diff --git a/Doc/library/asyncio-eventloop.rst
b/Doc/library/asyncio-eventloop.rst
index 65bc349e2a727d3..e6cdd4e57475b24 100644
--- a/Doc/library/asyncio-eventloop.rst
+++ b/Doc/library/asyncio-eventloop.rst
@@ -1145,12 +1145,21 @@ convenient.
*sock* must be a non-blocking socket.
+ With :class:`SelectorEventLoop`, *address* does not need to be resolved:
+ for :const:`~socket.AF_INET` and :const:`~socket.AF_INET6` sockets,
+ ``sock_connect`` first checks whether *address* is already resolved by
+ calling :func:`socket.inet_pton`, and uses :meth:`loop.getaddrinfo` to
+ resolve it if it is not.
+
+ :class:`ProactorEventLoop`, the default event loop on Windows, does not
+ resolve *address*. The host must already be a numeric IP address; passing
+ a host name raises :exc:`OSError`. Resolve the address with
+ :meth:`loop.getaddrinfo` first, or use :meth:`loop.create_connection`,
+ which resolves the address on every platform.
+
.. versionchanged:: 3.5.2
- ``address`` no longer needs to be resolved. ``sock_connect``
- will try to check if the *address* is already resolved by calling
- :func:`socket.inet_pton`. If not,
- :meth:`loop.getaddrinfo` will be used to resolve the
- *address*.
+ With :class:`SelectorEventLoop`, ``address`` no longer needs to be
+ resolved.
.. seealso::
_______________________________________________
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]
