]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.13] gh-138199: Address potential confusion re: threading (GH-138200) (GH-141929)
authorAlexander Nordin <alexander.f.nordin@gmail.com>
Tue, 25 Nov 2025 11:52:54 +0000 (03:52 -0800)
committerGitHub <noreply@github.com>
Tue, 25 Nov 2025 11:52:54 +0000 (06:52 -0500)
gh-138199: Address potential confusion regarding threading in the `asyncio` HOWTO (GH-138200)

(cherry picked from commit a4f422521337d3310b71bb081c195e64c2035bbb)

Doc/howto/a-conceptual-overview-of-asyncio.rst

index af1e39480cc1f6f7489699b6e5d141128eefad57..926e781dbdc658f77f697d1444a8b7c3fcba9297 100644 (file)
@@ -175,9 +175,12 @@ The recommended way to create tasks is via :func:`asyncio.create_task`.
 Creating a task automatically schedules it for execution (by adding a
 callback to run it in the event loop's to-do list, that is, collection of jobs).
 
-Since there's only one event loop (in each thread), :mod:`!asyncio` takes care of
-associating the task with the event loop for you. As such, there's no need
-to specify the event loop.
+:mod:`!asyncio` automatically associates tasks with the event loop for you.
+This automatic association was purposely designed into :mod:`!asyncio` for
+the sake of simplicity.
+Without it, you'd have to keep track of the event loop object and pass it to
+any coroutine function that wants to create tasks, adding redundant clutter
+to your code.
 
 ::