Update logging.config.listen() docstrings to mention dictConfig() (GH-155479)

vsajip <[email protected]> Mon, 10 Aug 2026 14:19:39 -0400 (EDT)
Newsgroups gmane.comp.python.cvs
Message-ID <[email protected]>
https://github.com/python/cpython/commit/791b5731d0c999d671e5a74a4c6557ddfa2a72a7
commit: 791b5731d0c999d671e5a74a4c6557ddfa2a72a7
branch: main
author: stevens <[email protected]>
committer: vsajip <[email protected]>
date: 2026-08-10T19:19:26+01:00
summary:

Update logging.config.listen() docstrings to mention dictConfig() (GH-155479)

logging.config.listen() docstring had omitted dictConfig() support.

files:
M Lib/logging/config.py

diff --git a/Lib/logging/config.py b/Lib/logging/config.py
index fab91e663a0f6aa..f566de5750dbf55 100644
--- a/Lib/logging/config.py
+++ b/Lib/logging/config.py
@@ -934,8 +934,9 @@ def listen(port=DEFAULT_LOGGING_CONFIG_PORT, verify=None):
     Start up a socket server on the specified port, and listen for new
     configurations.
 
-    These will be sent as a file suitable for processing by fileConfig().
-    Returns a Thread object on which you can call start() to start the server,
+    These will be sent as a file suitable for processing by dictConfig() or
+    fileConfig(). Returns a Thread object on which you can call start() to
+    start the server,
     and which you can join() when appropriate. To stop the server, call
     stopListening().
 
@@ -953,8 +954,8 @@ class ConfigStreamHandler(StreamRequestHandler):
         """
         Handler for a logging configuration request.
 
-        It expects a completely new logging configuration and uses fileConfig
-        to install it.
+        It expects a completely new logging configuration and uses dictConfig
+        or fileConfig to install it.
         """
         def handle(self):
             """
@@ -962,7 +963,7 @@ def handle(self):
 
             Each request is expected to be a 4-byte length, packed using
             struct.pack(">L", n), followed by the config file.
-            Uses fileConfig() to do the grunt work.
+            Uses dictConfig() or fileConfig() to do the grunt work.
             """
             try:
                 conn = self.connection

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]