From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Mon, 9 Mar 2026 16:43:01 +0000 (+0100) Subject: [3.13] gh-141617: clarify `concurrent.futures.ThreadPoolExecutor` deadlock example... X-Git-Tag: v3.13.13~119 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=ae696e7847b535f963000ccc05fa6bc5083ea8a8;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-141617: clarify `concurrent.futures.ThreadPoolExecutor` deadlock example (GH-141620) (#145687) gh-141617: clarify `concurrent.futures.ThreadPoolExecutor` deadlock example (GH-141620) --------- (cherry picked from commit 171133aa84cd2fa8738bdbb0c76435645810e8d3) Co-authored-by: Yashraj Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com> --- diff --git a/Doc/library/concurrent.futures.rst b/Doc/library/concurrent.futures.rst index 09d7a0d0ec21..86d3a9566d9e 100644 --- a/Doc/library/concurrent.futures.rst +++ b/Doc/library/concurrent.futures.rst @@ -147,7 +147,9 @@ And:: print(f.result()) executor = ThreadPoolExecutor(max_workers=1) - executor.submit(wait_on_future) + future = executor.submit(wait_on_future) + # Note: calling future.result() would also cause a deadlock because + # the single worker thread is already waiting for wait_on_future(). .. class:: ThreadPoolExecutor(max_workers=None, thread_name_prefix='', initializer=None, initargs=())