3. update default format of morebuiltins.logs.LogHelper to "%(asctime)s | %(levelname)-5s | %(filename)+8s:%(lineno)+3s - %(message)s".

Author: ClericPy

CHANGELOG.md

@@ -3,6 +3,7 @@
 ### 1.3.3 (2025-09-01)
 1. add `morebuiltins.logs.LogHelper.handle_crash` to log uncaught exceptions.
 2. fix `morebuiltins.logs.LogHelper.bind_handler` to avoid adding duplicate queue handlers.
+3. update default format of `morebuiltins.logs.LogHelper` to `"%(asctime)s | %(levelname)-5s | %(filename)+8s:%(lineno)+3s - %(message)s"`.
 
 ### 1.3.2 (2025-08-02)
 1. fix typing-hint for `morebuiltins.funcs.threads` decorator, now it returns `Callable[..., Future]`.

doc.md

@@ -2759,8 +2759,9 @@ The default file handler is a SizedTimedRotatingFileHandler, which can rotate lo
 
 Examples::
 
+    # 1. Bind a StreamHandler to the "mylogger" logger, output to sys.stdout
     import logging
-    from morebuiltins.log import LogHelper
+    from morebuiltins.logs import LogHelper
 
     LogHelper.shorten_level()
     logger = LogHelper.bind_handler(name="mylogger", filename=sys.stdout, maxBytes=100 * 1024**2, backupCount=7)
@@ -2770,6 +2771,23 @@ Examples::
     logger.info("This is an info message")
     logger.fatal("This is a critical message")
 
+    # 2. Bind file and stderr in the same logger
+    import sys
+    import logging
+    from morebuiltins.logs import LogHelper
+    LogHelper.shorten_level()
+    logger = LogHelper.bind_handler(name="mylogger", filename="mylog.log", maxBytes=100 * 1024**2, backupCount=7)
+    logger = LogHelper.bind_handler(name="mylogger", filename=sys.stderr)
+    logger.info("This is an info message")
+
+    # 3. Use queue=True to make logging non-blocking, both file and stderr
+    import sys
+    from morebuiltins.logs import LogHelper
+    LogHelper.shorten_level()
+    logger = LogHelper.bind_handler(name="mylogger", filename="mylog.log", maxBytes=100 * 1024**2, backupCount=7, queue=True)
+    logger = LogHelper.bind_handler(name="mylogger", filename=sys.stderr, queue=True)
+    logger.info("This is an info message")
+
 ```
 
 

morebuiltins/logs.py

@@ -73,7 +73,7 @@ class LogHelper:
     """
 
     DEFAULT_FORMAT = (
-        "%(asctime)s %(levelname)-5s %(funcName)s:%(filename)s:%(lineno)s | %(message)s"
+        "%(asctime)s | %(levelname)-5s | %(filename)+8s:%(lineno)+3s - %(message)s"
     )
     DEFAULT_FORMATTER = logging.Formatter(DEFAULT_FORMAT)
     FILENAME_HANDLER_MAP: Dict[str, logging.Handler] = {}