util.logging.configure: Allow the stream to be configured

Author: opcode81

CHANGELOG.md

@@ -17,6 +17,8 @@
       * Use autocommit and remove option of using deferred commits as it's the only way to guarantee
         that no stale data is read due to transactions going on too long
       * Handle duplicate key upon insertion due to race condition by providing a more informative Exception
+  * `util.logging`:
+      * `configure`: Allow the output stream to be configured 
 
 
 ## 1.4.0 (2025-01-21)

src/sensai/util/logging.py

@@ -68,18 +68,21 @@ def set_configure_callback(callback: Callable[[], None], append: bool = True) ->
 
 
 # noinspection PyShadowingBuiltins
-def configure(format=LOG_DEFAULT_FORMAT, level=lg.DEBUG):
+def configure(format=LOG_DEFAULT_FORMAT, level=lg.DEBUG, stream=sys.stdout):
     """
-    Configures logging to stdout with the given format and log level,
+    Configures logging to the given stream with the given format and log level,
     also configuring the default log levels of some overly verbose libraries as well as some pandas output options.
 
+    Note: the configuration can be extended by registering a callback via :func:`set_configure_callback`.
+
     :param format: the log format
     :param level: the minimum log level
+    :param stram: the output stream for whcih to configure a log handler
     """
     global _logFormat
     _logFormat = format
     remove_log_handlers()
-    basicConfig(level=level, format=format, stream=sys.stdout)
+    basicConfig(level=level, format=format, stream=stream)
     getLogger("matplotlib").setLevel(lg.INFO)
     getLogger("urllib3").setLevel(lg.INFO)
     getLogger("msal").setLevel(lg.INFO)