Jun 7, 2022 · May 26, 2022 · May 26, 2022 · May 26, 2022 · Jun 7, 2022
diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
   .. important::

      Save a reference to the result of this function, to avoid
      a task disappearing mid execution.
      a task disappearing mid execution. The event loop only keeps
      weak references to all task. Without a strong reference, the
      task may get garbage-collected at any time. If you want to have
      "fire-and-forget" background tasks you can do something like this::

          # create an empty set to store references to background tasks
          background_tasks = set()

          # start 10 background tasks
          for i in range(10):
              task = asyncio.create_task(some_coro(param=i))

              # Add task to set. This creates a strong reference.
              background_tasks.add(task)

              # To prevent accumulation of references to already finished
              # tasks, make each task remove its own reference from set after
              # completion:
              task.add_done_callback(lambda t: background_tasks.discard(t))

   .. versionadded:: 3.7

diff --git a/Misc/NEWS.d/next/Documentation/2022-05-26-14-51-25.gh-issue-88831.5Cccr5.rst b/Misc/NEWS.d/next/Documentation/2022-05-26-14-51-25.gh-issue-88831.5Cccr5.rst
 Augmented documentation of asyncio.create_task(). Clarified the need to keep strong references to tasks and added a code snippet detailing how to to this.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -226,7 +226,25 @@ Creating Tasks
		.. important::

		Save a reference to the result of this function, to avoid
		a task disappearing mid execution.
		a task disappearing mid execution. The event loop only keeps
		weak references to all task. Without a strong reference, the
		task may get garbage-collected at any time. If you want to have
		"fire-and-forget" background tasks you can do something like this::

		# create an empty set to store references to background tasks
		background_tasks = set()

		# start 10 background tasks
		for i in range(10):
		task = asyncio.create_task(some_coro(param=i))

		# Add task to set. This creates a strong reference.
		background_tasks.add(task)

		# To prevent accumulation of references to already finished
		# tasks, make each task remove its own reference from set after
		# completion:
		task.add_done_callback(lambda t: background_tasks.discard(t))
ambv marked this conversation as resolved. OutdatedShow resolvedHide resolved

		.. versionadded:: 3.7

Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Augmented documentation of asyncio.create_task(). Clarified the need to keep strong references to tasks and added a code snippet detailing how to to this.