https://github.com/python/cpython/commit/0e7c06a85880ba790fac4239b0ff1052399a36ae
commit: 0e7c06a85880ba790fac4239b0ff1052399a36ae
branch: main
author: kovan <[email protected]>
committer: picnixz <[email protected]>
date: 2026-02-07T12:22:51Z
summary:

gh-142044: Add note to prefer `asyncio.timeout[_at]` over `asyncio.Timeout` 
(#144449)

files:
M Doc/library/asyncio-task.rst

diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index 863b3e336572aa..1b7c8ff0c762a6 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -771,6 +771,9 @@ Timeouts
        An :ref:`asynchronous context manager <async-context-managers>`
        for cancelling overdue coroutines.
 
+       Prefer using :func:`asyncio.timeout` or :func:`asyncio.timeout_at`
+       rather than instantiating :class:`!Timeout` directly.
+
        ``when`` should be an absolute time at which the context should time 
out,
        as measured by the event loop's clock:
 

_______________________________________________
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]

Reply via email to