From: Kumar Aditya <kumaraditya@python.org>
Date: Tue, 4 Aug 2026 06:30:27 +0000 (+0530)
Subject: gh-104091: Suggest TaskGroup for running background tasks in asyncio.create_task... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;ds=inline;p=thirdparty%2FPython%2Fcpython.git

gh-104091: Suggest TaskGroup for running background tasks in asyncio.create_task() docs (#155133)
---

diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index b6f3662862eb..38364138a17d 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -288,6 +288,17 @@ Creating tasks
               # completion:
               task.add_done_callback(background_tasks.discard)
 
+      Note that this approach never awaits the tasks, so if a task
+      fails, its exception is never retrieved and asyncio logs a
+      "Task exception was never retrieved" message when the task is
+      garbage collected.  To avoid this, use :class:`asyncio.TaskGroup`
+      which keeps a strong reference to each task, awaits them and
+      propagates their exceptions::
+
+          async with asyncio.TaskGroup() as tg:
+              for i in range(10):
+                  tg.create_task(some_coro(param=i))
+
    .. versionadded:: 3.7
 
    .. versionchanged:: 3.8