From: Bartosz Sławecki <bartosz@ilikepython.com>
Date: Wed, 16 Jul 2025 16:34:14 +0000 (+0200)
Subject: gh-126548: Add a thread-unsafety warning for `importlib.reload()` (GH-136704)
X-Git-Tag: v3.15.0a1~953
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=69d8fe50ddc4dbe757c9929a532e2e882f0261ba;p=thirdparty%2FPython%2Fcpython.git

gh-126548: Add a thread-unsafety warning for `importlib.reload()` (GH-136704)
---

diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index ea5a77028683..4f374be778d6 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -206,6 +206,10 @@ Functions
        :exc:`ModuleNotFoundError` is raised when the module being reloaded lacks
        a :class:`~importlib.machinery.ModuleSpec`.
 
+   .. warning::
+      This function is not thread-safe. Calling it from multiple threads can result
+      in unexpected behavior. It's recommended to use the :class:`threading.Lock`
+      or other synchronization primitives for thread-safe module reloading.
 
 :mod:`importlib.abc` -- Abstract base classes related to import
 ---------------------------------------------------------------