From 945b5e89112dc20b046ea975f401cab94572fb5e 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 d8dd03aba5c74a..54103a438c8553 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -298,6 +298,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. @@ -318,6 +324,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.