From: JosephSBoyle <48555120+JosephSBoyle@users.noreply.github.com>
Date: Wed, 15 Mar 2023 00:33:19 +0000 (+0000)
Subject: gh-102560 Add docstrings to asyncio.TaskGroup (#102565)
X-Git-Tag: v3.12.0a7~171
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e94edab727d07bef851e0e1a345e18a453be863d;p=thirdparty%2FPython%2Fcpython.git

gh-102560 Add docstrings to asyncio.TaskGroup (#102565)
---

diff --git a/Lib/asyncio/taskgroups.py b/Lib/asyncio/taskgroups.py
index 911419e1769c..0fdea3697ece 100644
--- a/Lib/asyncio/taskgroups.py
+++ b/Lib/asyncio/taskgroups.py
@@ -10,7 +10,21 @@ from . import tasks
 
 
 class TaskGroup:
+    """Asynchronous context manager for managing groups of tasks.
 
+    Example use:
+
+        async with asyncio.TaskGroup() as group:
+            task1 = group.create_task(some_coroutine(...))
+            task2 = group.create_task(other_coroutine(...))
+        print("Both tasks have completed now.")
+
+    All tasks are awaited when the context manager exits.
+
+    Any exceptions other than `asyncio.CancelledError` raised within
+    a task will cancel all remaining tasks and wait for them to exit.
+    The exceptions are then combined and raised as an `ExceptionGroup`.
+    """
     def __init__(self):
         self._entered = False
         self._exiting = False
@@ -135,6 +149,10 @@ class TaskGroup:
                 self._errors = None
 
     def create_task(self, coro, *, name=None, context=None):
+        """Create a new task in this group and return it.
+
+        Similar to `asyncio.create_task`.
+        """
         if not self._entered:
             raise RuntimeError(f"TaskGroup {self!r} has not been entered")
         if self._exiting and not self._tasks: