logging: Add handler param to basicConfig.

greezybacon · greezybacon · commit 9d4e1ae34d0d · 2025-06-11T07:35:43.000-05:00
CPython allows specifying a list of handlers in the initialization of
logging with basicConfig(handlers=&lt;iterable&gt;). This adds similar support
but only with a single handler. It allows to initialize logging with a
single, specialized handler.

Signed-off-by: Jared Hancock &lt;jared@greezybacon.me&gt;
diff --git a/python-stdlib/logging/logging.py b/python-stdlib/logging/logging.py
@@ -223,6 +223,7 @@ def basicConfig(
     format=None,
     datefmt=None,
     level=WARNING,
+    handler=None,
     stream=None,
     encoding="UTF-8",
     force=False,
@@ -237,10 +238,14 @@ def basicConfig(
             h.close()
         logger.handlers = []
 
-        if filename is None:
-            handler = StreamHandler(stream)
-        else:
-            handler = FileHandler(filename, filemode, encoding)
+        if handler is not None:
+            if filename is None:
+                handler = StreamHandler(stream)
+            else:
+                handler = FileHandler(filename, filemode, encoding)
+        elif stream or filename:
+            raise ValueError("'stream' or 'filename' should not be "
+                             "specified together with 'handler'")
 
         handler.setLevel(level)
         handler.setFormatter(Formatter(format, datefmt))
