From: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Date: Mon, 26 Sep 2022 22:27:15 +0000 (+0530)
Subject: GH-65046: Fix docs about logging in `asyncio` (#97559)
X-Git-Tag: v3.12.0a1~346
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d68c37c0d08542a346a13b150a204208bb0408f5;p=thirdparty%2FPython%2Fcpython.git

GH-65046: Fix docs about logging in `asyncio` (#97559)

Explain that logging should not use network I/O.
---

diff --git a/Doc/library/asyncio-dev.rst b/Doc/library/asyncio-dev.rst
index 77f1128de50c..9676a352f4b2 100644
--- a/Doc/library/asyncio-dev.rst
+++ b/Doc/library/asyncio-dev.rst
@@ -148,6 +148,10 @@ adjusted::
    logging.getLogger("asyncio").setLevel(logging.WARNING)
 
 
+Network logging can block the event loop. It is recommended to use
+a separate thread for handling logs or use non-blocking IO.
+
+
 .. _asyncio-coroutine-not-scheduled:
 
 Detect never-awaited coroutines