From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Tue, 16 Nov 2021 11:47:02 +0000 (-0800) Subject: [3.9] Save a reference for ensure_future and create_task (GH-29163) (GH-29573) X-Git-Tag: v3.9.10~126 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fd206b680705de3e0408fd29c7943317563e61e1;p=thirdparty%2FPython%2Fcpython.git [3.9] Save a reference for ensure_future and create_task (GH-29163) (GH-29573) Co-authored-by: Joannah Nanjekye (cherry picked from commit c750adbe6990ee8239b27d5f4591283a06bfe862) Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com> Automerge-Triggered-By: GH:asvetlov --- diff --git a/Doc/library/asyncio-future.rst b/Doc/library/asyncio-future.rst index 939d4c1a8452..63c369263fd9 100644 --- a/Doc/library/asyncio-future.rst +++ b/Doc/library/asyncio-future.rst @@ -54,6 +54,9 @@ Future Functions See also the :func:`create_task` function which is the preferred way for creating new Tasks. + Save a reference to the result of this function, to avoid + a task disappearing mid execution. + .. versionchanged:: 3.5.1 The function accepts any :term:`awaitable` object. diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst index ca6e525e9359..e8bee20bc76b 100644 --- a/Doc/library/asyncio-task.rst +++ b/Doc/library/asyncio-task.rst @@ -274,6 +274,11 @@ Creating Tasks task = asyncio.ensure_future(coro()) ... + .. important:: + + Save a reference to the result of this function, to avoid + a task disappearing mid execution. + .. versionadded:: 3.7 .. versionchanged:: 3.8