[3.15] gh-89696: Fix loop.sock_connect docs on address resolution (GH-153651) (#153652)

gh-89696: Fix `loop.sock_connect` docs on address resolution (GH-153651)
(cherry picked from commit 1fece44570)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
This commit is contained in:
Miss Islington (bot)
2026-07-13 12:09:39 +02:00
committed by GitHub
parent 91084886e5
commit 9efded4664
+14 -5
View File
@@ -1156,12 +1156,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::