From 5240decbc665a283ecf86637d18dafb2a6c437e3 Mon Sep 17 00:00:00 2001 From: Bar Harel Date: Mon, 18 Aug 2025 13:18:54 +0100 Subject: [PATCH] gh-127859: Fixed documentation for call_later and call_at for early wakeup in asyncio (GH-137859) (cherry picked from commit 92be979f64cbc12a32dc391d66caf4398fd24763) Co-authored-by: Bar Harel --- Doc/library/asyncio-eventloop.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst index 9561c40776f01c..0ccc7a2b4482ec 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -304,6 +304,12 @@ clocks to track time. custom :class:`contextvars.Context` for the *callback* to run in. The current context is used when no *context* is provided. + .. note:: + + For performance, callbacks scheduled with :meth:`loop.call_later` + may run up to one clock-resolution early (see + ``time.get_clock_info('monotonic').resolution``). + .. versionchanged:: 3.7 The *context* keyword-only parameter was added. See :pep:`567` for more details. @@ -324,6 +330,12 @@ clocks to track time. An instance of :class:`asyncio.TimerHandle` is returned which can be used to cancel the callback. + .. note:: + + For performance, callbacks scheduled with :meth:`loop.call_at` + may run up to one clock-resolution early (see + ``time.get_clock_info('monotonic').resolution``). + .. versionchanged:: 3.7 The *context* keyword-only parameter was added. See :pep:`567` for more details.