Applied minor improvement to logging preimport

Author: dhondta

docs/pages/enhancements.md

@@ -112,6 +112,7 @@ A context manager is also available:
 - `renameLogger`: renames a logger from an old to a new name.
 - `setLogger` / `setLoggers`: sets respectively one or multiple loggers using Tinyscript's logger configuration.
 - `setLoggingLevel`: sets a logging level to every logger matching the given patterns.
+- `silentLogger` : returns the logger configured to log nothing (useful to silent the logger of a dependency).
 - `unsetLogger` / `unsetLoggers`: unsets respectively one or multiple loggers (removing them from the root `logging` dictionary).
 - `InterceptionHandler`: handler that intercepts the last log record.
 - `RelativeTimeColoredFormatter`: custom formatter for handling relative log times.

src/tinyscript/VERSION.txt

@@ -1 +1 @@
-1.30.25
+1.30.26

src/tinyscript/preimports/log.py

@@ -14,15 +14,9 @@
 
 
 PY3 = sys.version[0] == "3"
+logging.NONE = 1000
 logging.START_TIME = None
 
-
-# setup a null logger
-logging.nullLogger = logging.getLogger("null")
-logging.nullLogger.setLevel(1000)
-logging.nullLogger.addHandler(logging.NullHandler())
-
-
 try:
     logging._acquireLock
 except AttributeError:
@@ -249,6 +243,17 @@ def setLoggingLevel(level="INFO", *patterns, **kwargs):
 logging.setLoggingLevel = setLoggingLevel
 
 
+def silentLogger(name):
+    """ Silent the input logger. """
+    (l := logging.getLogger(name)).setLevel(logging.NONE)
+    for h in l.handlers:
+        l.removeHandler(h)
+    l.addHandler(logging.NullHandler())
+    return l
+logging.silentLogger = silentLogger
+logging.nullLogger = silentLogger("null")  # setup a null logger
+
+
 def unsetLogger(name, force=False):
     """ Remove a logger. If the name does not exist in the dictionary of loggers, it raises an exception.
     

tests/test_preimports_logging.py

@@ -13,7 +13,7 @@ def f_with_logging(testcase, **kwargs):
     testcase.assertEqual(logger.name, "other")
 
 
-class LoggingInFunc(object):
+class LoggingInFunc:
     def f1(self, testcase):
         testcase.assertRaises(AttributeError, getattr, self, "logger")
 
@@ -48,6 +48,9 @@ def test_manipulate_loggers(self):
         h = logging.StreamHandler()
         l.addHandler(h)
         self.assertIn(h, l.handlers)
+        logging.silentLogger("test")
+        self.assertNotIn(h, l.handlers)
+        self.assertEqual(l.level, logging.NONE)
         self.assertIsNone(logging.setLoggers())
         self.assertIsNone(logging.setLogger("test"))
         self.assertNotIn(h, l.handlers)