summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-11-16 03:47:02 -0800
committerGitHub <noreply@github.com>2021-11-16 03:47:02 -0800
commitfd206b680705de3e0408fd29c7943317563e61e1 (patch)
tree35c2dd93e264a4bce6823c4fd1355e955970efdf
parenta40d066e8ef548b52eca2b0e27c219ddd7e11592 (diff)
downloadcpython-git-fd206b680705de3e0408fd29c7943317563e61e1.tar.gz
[3.9] Save a reference for ensure_future and create_task (GH-29163) (GH-29573)
Co-authored-by: Joannah Nanjekye <jnanjekye@python.org> (cherry picked from commit c750adbe6990ee8239b27d5f4591283a06bfe862) Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com> Automerge-Triggered-By: GH:asvetlov
-rw-r--r--Doc/library/asyncio-future.rst3
-rw-r--r--Doc/library/asyncio-task.rst5
2 files changed, 8 insertions, 0 deletions
diff --git a/Doc/library/asyncio-future.rst b/Doc/library/asyncio-future.rst
index 939d4c1a84..63c369263f 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 ca6e525e93..e8bee20bc7 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