Doc fixes

python · pablogsal · May 4, 2025 · May 1, 2025 · May 2, 2025 · May 2, 2025
commit 9dbe00d276b3bd8eb1201e1450a2db63239739bf
@@ -541,26 +541,21 @@ For example given this code:
 
   import asyncio
 
-  async def sleeper(name, delay):
-      await asyncio.sleep(delay)
-      print(f"{name} is done sleeping.")
+  async def play(track):
+      await asyncio.sleep(5)
+      print(f"🎵 Finished: {track}")
 
-  async def inner(name):
-      await asyncio.sleep(0.1)
-      await sleeper(name, 1)
-
-  async def task_group(name):
-      await asyncio.gather(
-          inner(f"{name}-1"),
-          inner(f"{name}-2"),
-      )
+  async def album(name, tracks):
+      async with asyncio.TaskGroup() as tg:
+          for track in tracks:
+              tg.create_task(play(track), name=track)
 
   async def main():
-      # Start two separate task groups
-      t1 = asyncio.create_task(task_group("groupA"))
-      t2 = asyncio.create_task(task_group("groupB"))
-      await t1
-      await t2
+      async with asyncio.TaskGroup() as tg:
+          tg.create_task(
+            album("Sundowning", ["TNDNBTG", "Levitate"]), name="Sundowning")
+          tg.create_task(
+            album("TMBTE", ["DYWTYLM", "Aqua Regia"]), name="TMBTE")
 
   if __name__ == "__main__":
       asyncio.run(main())
@@ -571,13 +566,15 @@ Executing the new tool on the running process will yield a table like this:
 
   python -m asyncio ps 12345
 
-    tid        task id              task name            coroutine chain                                    awaiter name         awaiter id
+  tid        task id              task name            coroutine chain                                    awaiter name         awaiter id
   ---------------------------------------------------------------------------------------------------------------------------------------
-  6826911    0x200013c0220        Task-2               main                                               Task-1               0x200013b0020
-  6826911    0x200013c0620        Task-4               task_group                                         Task-2               0x200013c0220
-  6826911    0x200013c0820        Task-5               task_group                                         Task-2               0x200013c0220
-  6826911    0x200013c0c20        Task-6               task_group                                         Task-3               0x200013c0420
-  6826911    0x200013c0e20        Task-7               task_group                                         Task-3               0x200013c0420
+  8138752    0x564bd3d0210        Task-1                                                                                       0x0
+  8138752    0x564bd3d0410        Sundowning           _aexit -> __aexit__ -> main                        Task-1               0x564bd3d0210
+  8138752    0x564bd3d0610        TMBTE                _aexit -> __aexit__ -> main                        Task-1               0x564bd3d0210
+  8138752    0x564bd3d0810        TNDNBTG              _aexit -> __aexit__ -> album                       Sundowning           0x564bd3d0410
+  8138752    0x564bd3d0a10        Levitate             _aexit -> __aexit__ -> album                       Sundowning           0x564bd3d0410
+  8138752    0x564bd3e0550        DYWTYLM              _aexit -> __aexit__ -> album                       TMBTE                 0x564bd3d0610
+  8138752    0x564bd3e0710        Aqua Regia           _aexit -> __aexit__ -> album                       TMBTE                 0x564bd3d0610
 
 
 or:
@@ -587,15 +584,21 @@ or:
   python -m asyncio pstree 12345
 
   └── (T) Task-1
-    └──  main
-        └── (T) Task-2
-            └──  task_group
-                ├── (T) Task-4
-                └── (T) Task-5
-  └── (T) Task-3
-      └──  task_group
-          ├── (T) Task-6
-          └── (T) Task-7
+      └──  main
+          └──  __aexit__
+              └──  _aexit
+                  ├── (T) Sundowning
+                  │   └──  album
+                  │       └──  __aexit__
+                  │           └──  _aexit
+                  │               ├── (T) TNDNBTG
+                  │               └── (T) Levitate
+                  └── (T) TMBTE
+                      └──  album
+                          └──  __aexit__
+                              └──  _aexit
+                                  ├── (T) DYWTYLM
+                                  └── (T) Aqua Regia
 
 If a cycle is detected in the async await graph (which could indicate a
 programming issue), the tool raises an error and lists the cycle paths that