logger-36 2025.4__py3-none-any.whl → 2025.6__py3-none-any.whl

logger_36/__init__.py

@@ -11,12 +11,13 @@ except ModuleNotFoundError:
 else:
     import site
     from pathlib import Path as path_t
+
     paths = site.getsitepackages() + [site.getusersitepackages()]
     folder = path_t(__file__).parent
     if folder not in paths:
         beartype_this_package()
 
-from logger_36.instance.logger import LOGGER
+from logger_36.instance.logger import L
 from logger_36.version import __version__
 
 """

logger_36/api/logger.py

@@ -4,7 +4,7 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from logger_36.type.logger import logger_t
+from logger_36.type.logger import logger_t  # noqa
 
 """
 COPYRIGHT NOTICE

logger_36/api/storage.py

@@ -4,7 +4,7 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from logger_36.task.storage import html_reader_t
+from logger_36.task.storage import html_reader_t  # noqa
 
 """
 COPYRIGHT NOTICE

logger_36/catalog/config/console_rich.py

@@ -4,10 +4,10 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import logging as lggg
+import logging as l
 
-from rich.color import Color as color_t
-from rich.style import Style as style_t
+from rich.color import Color as color_t  # noqa
+from rich.style import Style as style_t  # noqa
 
 """
 Colors: See https://rich.readthedocs.io/en/stable/appendix/colors.html.
@@ -16,13 +16,13 @@ WHITE_COLOR = "grey85"
 GRAY_COLOR = "grey58"
 
 LEVEL_COLOR: dict[int, str | style_t] = {
-    lggg.DEBUG: "orchid",
-    lggg.INFO: GRAY_COLOR,
-    lggg.WARNING: "yellow1",
-    lggg.ERROR: "dark_orange",
-    lggg.CRITICAL: "bright_red",
+    l.DEBUG: "orchid",
+    l.INFO: GRAY_COLOR,
+    l.WARNING: "yellow1",
+    l.ERROR: "dark_orange",
+    l.CRITICAL: "bright_red",
 }
-ACTUAL_COLOR = LEVEL_COLOR[lggg.CRITICAL]
+ACTUAL_COLOR = LEVEL_COLOR[l.CRITICAL]
 EXPECTED_COLOR = "green3"
 DATE_TIME_COLOR = "sky_blue3"
 

logger_36/{config/logger.py → catalog/config/optional.py}

@@ -4,57 +4,14 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import logging as lggg
-
-from logger_36.catalog.handler.console import console_handler_t
-from logger_36.catalog.handler.console_rich import console_rich_handler_t
-from logger_36.catalog.handler.file import file_handler_t
-from logger_36.catalog.handler.generic import generic_handler_t
-from logger_36.constant.handler import HANDLER_CODES, handler_codes_h
-from logger_36.instance.logger import LOGGER
-from logger_36.task.format.message import MessageWithActualExpected
-
-
-def SetLOGLevel(
-    level: int,
-    /,
-    *,
-    logger: lggg.Logger | None = None,
-    which: handler_codes_h | str = "a",
-) -> None:
-    """
-    which: g=generic, c=console, f=file, a=all, str=name.
-    """
-    if logger is None:
-        logger = LOGGER
-
-    which_is_name = which not in HANDLER_CODES
-    found = False
-    for handler in logger.handlers:
-        if (
-            (which == "a")
-            or ((which == "g") and isinstance(handler, generic_handler_t))
-            or (
-                (which == "c")
-                and isinstance(handler, (console_handler_t, console_rich_handler_t))
-            )
-            or ((which == "f") and isinstance(handler, file_handler_t))
-            or (which == handler.name)
-        ):
-            handler.setLevel(level)
-            if which_is_name:
-                return
-            found = True
-
-    if not found:
-        raise ValueError(
-            MessageWithActualExpected(
-                "Handler not found",
-                actual=which,
-                expected=f"{str(HANDLER_CODES)[1:-1]}, or a handler name",
-            )
-        )
-
+try:
+    import rich  # noqa
+except ModuleNotFoundError:
+    RICH_IS_AVAILABLE = False
+    from logger_36.constant.error import MISSING_RICH_MESSAGE
+else:
+    RICH_IS_AVAILABLE = True
+    MISSING_RICH_MESSAGE = None
 
 """
 COPYRIGHT NOTICE

logger_36/catalog/handler/console.py

@@ -5,7 +5,7 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 import dataclasses as d
-import logging as lggg
+import logging as l
 import textwrap as txt_
 import typing as h
 
@@ -13,18 +13,25 @@ from logger_36.constant.message import LINE_INDENT
 from logger_36.constant.record import SHOW_W_RULE_ATTR
 from logger_36.task.format.rule import RuleAsText
 from logger_36.type.handler import handler_extension_t
+from logger_36.type.handler import message_from_record_raw_p as message_from_record_p
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
-class console_handler_t(lggg.Handler):
+class console_handler_t(l.Handler):
+    """
+    kind: See logger_36.constant.handler.handler_codes_h.
+    """
+
+    kind: h.ClassVar[str] = "c"
+
     extension: handler_extension_t = d.field(init=False)
-    MessageFromRecord: h.Callable[..., tuple[str, str | None]] = d.field(init=False)
+    MessageFromRecord: message_from_record_p = d.field(init=False)
 
     name: d.InitVar[str | None] = None
-    level: d.InitVar[int] = lggg.NOTSET
+    level: d.InitVar[int] = l.NOTSET
     should_store_memory_usage: d.InitVar[bool] = False
     message_width: d.InitVar[int] = -1
-    formatter: d.InitVar[lggg.Formatter | None] = None
+    formatter: d.InitVar[l.Formatter | None] = None
 
     def __post_init__(
         self,
@@ -32,10 +39,10 @@ class console_handler_t(lggg.Handler):
         level: int,
         should_store_memory_usage: bool,
         message_width: int,
-        formatter: lggg.Formatter | None,
+        formatter: l.Formatter | None,
     ) -> None:
         """"""
-        lggg.Handler.__init__(self)
+        l.Handler.__init__(self)
 
         self.extension = handler_extension_t(
             name=name,
@@ -48,7 +55,7 @@ class console_handler_t(lggg.Handler):
 
         self.MessageFromRecord = self.extension.MessageFromRecord
 
-    def emit(self, record: lggg.LogRecord, /) -> None:
+    def emit(self, record: l.LogRecord, /) -> None:
         """"""
         if hasattr(record, SHOW_W_RULE_ATTR):
             message = RuleAsText(record.msg)

logger_36/catalog/handler/console_rich.py

@@ -5,7 +5,7 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 import dataclasses as d
-import logging as lggg
+import logging as l
 import textwrap as txt_
 import typing as h
 
@@ -24,11 +24,14 @@ from logger_36.constant.message import CONTEXT_LENGTH, LINE_INDENT
 from logger_36.constant.record import SHOW_W_RULE_ATTR
 from logger_36.task.format.rule import Rule, rule_t
 from logger_36.type.handler import handler_extension_t
-from rich.console import Console as console_t
-from rich.console import RenderableType as renderable_t
-from rich.markup import escape as EscapedVersion
-from rich.text import Text as text_t
-from rich.traceback import install as InstallTracebackHandler
+from logger_36.type.handler import (
+    message_from_record_preprocessed_p as message_from_record_p,
+)
+from rich.console import Console as console_t  # noqa
+from rich.console import RenderableType as renderable_t  # noqa
+from rich.markup import escape as EscapedVersion  # noqa
+from rich.text import Text as text_t  # noqa
+from rich.traceback import install as InstallTracebackHandler  # noqa
 
 _COMMON_TRACEBACK_ARGUMENTS = ("theme", "width")
 _EXCLUSIVE_TRACEBACK_ARGUMENTS = (
@@ -45,8 +48,10 @@ _EXCLUSIVE_TRACEBACK_ARGUMENTS = (
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
-class console_rich_handler_t(lggg.Handler):
+class console_rich_handler_t(l.Handler):
     """
+    kind: See logger_36.constant.handler.handler_codes_h.
+
     alternating_lines:
     - Initial value:
         - 1: enabled for dark background
@@ -55,17 +60,19 @@ class console_rich_handler_t(lggg.Handler):
     - Runtime value: 0/1=do not/do highlight next time.
     """
 
+    kind: h.ClassVar[str] = "c"
+
     extension: handler_extension_t = d.field(init=False)
     console: console_t = d.field(init=False)
-    MessageFromRecord: h.Callable[..., str] = d.field(init=False)
+    MessageFromRecord: message_from_record_p = d.field(init=False)
     alternating_lines: int = 0
     background_is_light: bool = True
 
     name: d.InitVar[str | None] = None
-    level: d.InitVar[int] = lggg.NOTSET
+    level: d.InitVar[int] = l.NOTSET
     should_store_memory_usage: d.InitVar[bool] = False
     message_width: d.InitVar[int] = -1
-    formatter: d.InitVar[lggg.Formatter | None] = None
+    formatter: d.InitVar[l.Formatter | None] = None
     should_install_traceback: d.InitVar[bool] = False
     should_record: d.InitVar[bool] = False
 
@@ -77,13 +84,13 @@ class console_rich_handler_t(lggg.Handler):
         level: int,
         should_store_memory_usage: bool,
         message_width: int,
-        formatter: lggg.Formatter | None,
+        formatter: l.Formatter | None,
         should_install_traceback: bool,
         should_record: bool,
         rich_kwargs: dict[str, h.Any] | None,
     ) -> None:
         """"""
-        lggg.Handler.__init__(self)
+        l.Handler.__init__(self)
 
         self.extension = handler_extension_t(
             name=name,
@@ -127,7 +134,7 @@ class console_rich_handler_t(lggg.Handler):
         else:
             self.alternating_lines = -1
 
-    def emit(self, record: lggg.LogRecord, /) -> None:
+    def emit(self, record: l.LogRecord, /) -> None:
         """"""
         if hasattr(record, SHOW_W_RULE_ATTR):
             richer = Rule(record.msg, DATE_TIME_COLOR)

logger_36/catalog/handler/file.py

@@ -5,7 +5,7 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 import dataclasses as d
-import logging as lggg
+import logging as l
 import textwrap as txt_
 import typing as h
 from pathlib import Path as path_t
@@ -14,19 +14,25 @@ from logger_36.constant.message import LINE_INDENT
 from logger_36.constant.record import SHOW_W_RULE_ATTR
 from logger_36.task.format.rule import RuleAsText
 from logger_36.type.handler import handler_extension_t
+from logger_36.type.handler import message_from_record_raw_p as message_from_record_p
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
-class file_handler_t(lggg.FileHandler):
+class file_handler_t(l.FileHandler):
+    """
+    kind: See logger_36.constant.handler.handler_codes_h.
+    """
+
+    kind: h.ClassVar[str] = "f"
 
     extension: handler_extension_t = d.field(init=False)
-    MessageFromRecord: h.Callable[..., tuple[str, str | None]] = d.field(init=False)
+    MessageFromRecord: message_from_record_p = d.field(init=False)
 
     name: d.InitVar[str | None] = None
-    level: d.InitVar[int] = lggg.NOTSET
+    level: d.InitVar[int] = l.NOTSET
     should_store_memory_usage: d.InitVar[bool] = False
     message_width: d.InitVar[int] = -1
-    formatter: d.InitVar[lggg.Formatter | None] = None
+    formatter: d.InitVar[l.Formatter | None] = None
 
     path: d.InitVar[path_t | None] = None
     handler_args: d.InitVar[tuple[h.Any, ...] | None] = None
@@ -38,13 +44,13 @@ class file_handler_t(lggg.FileHandler):
         level: int,
         should_store_memory_usage: bool,
         message_width: int,
-        formatter: lggg.Formatter | None,
+        formatter: l.Formatter | None,
         path: path_t | None,
         handler_args: tuple[h.Any, ...] | None,
         handler_kwargs: dict[str, h.Any] | None,
     ) -> None:
         """"""
-        lggg.FileHandler.__init__(self, path, *handler_args, **handler_kwargs)
+        l.FileHandler.__init__(self, path, *handler_args, **handler_kwargs)
 
         self.extension = handler_extension_t(
             name=name,
@@ -57,7 +63,7 @@ class file_handler_t(lggg.FileHandler):
 
         self.MessageFromRecord = self.extension.MessageFromRecord
 
-    def emit(self, record: lggg.LogRecord, /) -> None:
+    def emit(self, record: l.LogRecord, /) -> None:
         """"""
         if hasattr(record, SHOW_W_RULE_ATTR):
             message = RuleAsText(record.msg)

logger_36/catalog/handler/generic.py

@@ -5,22 +5,26 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 import dataclasses as d
-import logging as lggg
+import logging as l
 import typing as h
 
-try:
+from logger_36.catalog.config.optional import RICH_IS_AVAILABLE
+
+if RICH_IS_AVAILABLE:
     from logger_36.catalog.config.console_rich import DATE_TIME_COLOR
     from logger_36.catalog.handler.console_rich import HighlightedVersion
     from rich.console import Console as console_t  # noqa
     from rich.console import ConsoleOptions as console_options_t  # noqa
     from rich.markup import escape as EscapedForRich  # noqa
     from rich.terminal_theme import DEFAULT_TERMINAL_THEME  # noqa
-except ModuleNotFoundError:
-    console_t = console_options_t = EscapedForRich = DEFAULT_TERMINAL_THEME = None
+else:
+    DATE_TIME_COLOR = HighlightedVersion = console_t = console_options_t = (
+        EscapedForRich
+    ) = DEFAULT_TERMINAL_THEME = None
 
 from logger_36.constant.record import SHOW_W_RULE_ATTR
 from logger_36.task.format.rule import Rule, RuleAsText
-from logger_36.type.handler import handler_extension_t
+from logger_36.type.handler import handler_extension_t, message_from_record_h
 
 
 @h.runtime_checkable
@@ -34,8 +38,10 @@ class display_rule_p(h.Protocol):
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
-class generic_handler_t(lggg.Handler):
+class generic_handler_t(l.Handler):
     """
+    kind: See logger_36.constant.handler.handler_codes_h.
+
     alternating_lines:
         - Initial value:
             - 1: enabled for dark background
@@ -54,6 +60,8 @@ class generic_handler_t(lggg.Handler):
         it is indeed called at the end of the emit method.
     """
 
+    kind: h.ClassVar[str] = "g"
+
     ShowMessage: show_message_p
     # "None -> h.Any" (twice below) since None | None is invalid.
     console: console_t | h.Any = None
@@ -63,13 +71,13 @@ class generic_handler_t(lggg.Handler):
 
     DisplayRule: display_rule_p = d.field(init=False)
     extension: handler_extension_t = d.field(init=False)
-    MessageFromRecord: h.Callable[..., tuple[str, str | None]] = d.field(init=False)
+    MessageFromRecord: message_from_record_h = d.field(init=False)
 
     name: d.InitVar[str | None] = None
-    level: d.InitVar[int] = lggg.NOTSET
+    level: d.InitVar[int] = l.NOTSET
     should_store_memory_usage: d.InitVar[bool] = False
     message_width: d.InitVar[int] = -1
-    formatter: d.InitVar[lggg.Formatter | None] = None
+    formatter: d.InitVar[l.Formatter | None] = None
 
     supports_html: d.InitVar[bool] = False
     should_record: d.InitVar[bool] = False
@@ -81,13 +89,13 @@ class generic_handler_t(lggg.Handler):
         level: int,
         should_store_memory_usage: bool,
         message_width: int,
-        formatter: lggg.Formatter | None,
+        formatter: l.Formatter | None,
         supports_html: bool,
         should_record: bool,
         rich_kwargs: dict[str, h.Any] | None,
     ) -> None:
         """"""
-        lggg.Handler.__init__(self)
+        l.Handler.__init__(self)
 
         self.extension = handler_extension_t(
             name=name,
@@ -124,7 +132,7 @@ class generic_handler_t(lggg.Handler):
         else:
             self.alternating_lines = -1
 
-    def emit(self, record: lggg.LogRecord, /) -> None:
+    def emit(self, record: l.LogRecord, /) -> None:
         """"""
         if self.console is None:
             if hasattr(record, SHOW_W_RULE_ATTR):

logger_36/catalog/logger/chronos.py

@@ -4,12 +4,12 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from logger_36.instance.logger import LOGGER
+from logger_36.instance.logger import L
 from logger_36.task.measure.chronos import ElapsedTime
 from logger_36.type.logger import logger_t
 
 
-def LogElapsedTime(*, logger: logger_t = LOGGER) -> None:
+def LogElapsedTime(*, logger: logger_t = L) -> None:
     """"""
     logger.info(f"Elapsed Time: {ElapsedTime()}")
 

logger_36/catalog/logger/gpu.py

@@ -4,29 +4,29 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import sys as sstm
+import sys as s
 
 from logger_36.constant.error import GPU_LOGGING_ERROR
-from logger_36.instance.logger import LOGGER
+from logger_36.instance.logger import L
 from logger_36.type.logger import logger_t
 
 try:
     import tensorflow as tsfl  # noqa
     import tensorrt as tsrt  # noqa
-
-    _GPU_LOGGING_ERROR = None
 except ModuleNotFoundError:
     tsfl = tsrt = None
     _GPU_LOGGING_ERROR = GPU_LOGGING_ERROR
+else:
+    _GPU_LOGGING_ERROR = None
 
 
-def LogGPURelatedDetails(*, logger: logger_t = LOGGER) -> None:
+def LogGPURelatedDetails(*, logger: logger_t = L) -> None:
     """"""
     global _GPU_LOGGING_ERROR
 
     if None in (tsfl, tsrt):
         if _GPU_LOGGING_ERROR is not None:
-            print(_GPU_LOGGING_ERROR, file=sstm.stderr)
+            print(_GPU_LOGGING_ERROR, file=s.stderr)
             _GPU_LOGGING_ERROR = None
         return
 

logger_36/catalog/logger/memory.py

@@ -6,7 +6,7 @@ SEE COPYRIGHT NOTICE BELOW
 
 from logger_36.config.memory import LENGTH_100, MAX_N_SAMPLES
 from logger_36.constant.memory import storage_units_h
-from logger_36.instance.logger import LOGGER
+from logger_36.instance.logger import L
 from logger_36.task.format.memory import FormattedUsage, UsageBar
 from logger_36.task.format.message import MessageWithActualExpected
 from logger_36.type.logger import logger_t
@@ -18,7 +18,7 @@ def LogMemoryUsages(
     decimals: int = None,
     max_n_samples: int | None = MAX_N_SAMPLES,
     length_100: int = LENGTH_100,
-    logger: logger_t = LOGGER,
+    logger: logger_t = L,
 ) -> None:
     """"""
     if not logger.any_handler_stores_memory:
@@ -71,7 +71,7 @@ def LogMaximumMemoryUsage(
     *,
     unit: storage_units_h | None = "a",
     decimals: int | None = None,
-    logger: logger_t = LOGGER,
+    logger: logger_t = L,
 ) -> None:
     """
     unit: b or None=bytes, k=kilo, m=mega, g=giga, a=auto

logger_36/catalog/logger/system.py

@@ -5,7 +5,7 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 from logger_36.constant.system import MAX_DETAIL_NAME_LENGTH, SYSTEM_DETAILS_AS_DICT
-from logger_36.instance.logger import LOGGER
+from logger_36.instance.logger import L
 from logger_36.task.inspection import Modules
 from logger_36.type.logger import logger_t
 
@@ -15,7 +15,7 @@ def LogSystemDetails(
     modules_with_version: bool = True,
     modules_formatted: bool = True,
     should_restrict_modules_to_loaded: bool = True,
-    logger: logger_t = LOGGER,
+    logger: logger_t = L,
 ) -> None:
     """"""
     details = "\n".join(

logger_36/constant/error.py

@@ -16,7 +16,7 @@ MEMORY_MEASURE_ERROR = (
     "is not installed or not importable."
 )
 
-MISSING_RICH_ERROR = (
+MISSING_RICH_MESSAGE = (
     "The Rich console handler is not available because the Rich package "
     "(https://rich.readthedocs.io/en/stable/) "
     "is not installed or not importable. "

logger_36/constant/handler.py

@@ -6,8 +6,8 @@ SEE COPYRIGHT NOTICE BELOW
 
 import typing as h
 
-handler_codes_h = h.Literal["g", "c", "f", "a"]
-HANDLER_CODES: tuple[str, ...] = h.get_args(handler_codes_h)
+handler_codes_h = h.Literal["g", "c", "f", "a"]  # g=generic, c=console, f=file, a=all.
+HANDLER_KINDS: tuple[str, ...] = h.get_args(handler_codes_h)
 
 ANONYMOUS = "<Anonymous>"
 

logger_36/constant/logger.py

@@ -4,21 +4,14 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import logging as lggg
-import re as regx
-import typing as h
+import re as r
 
 LOGGER_NAME = "logger-36"
 
 # https://docs.python.org/3/library/logging.html#logging.captureWarnings
 WARNING_LOGGER_NAME = "py.warnings"
 WARNING_TYPE_PATTERN = r"\s*([^:]+):([0-9]+):\s*([^:]+)\s*:((.|\n)*)"
-WARNING_TYPE_COMPILED_PATTERN = regx.compile(WARNING_TYPE_PATTERN)
-
-# Second version: with self as first parameter.
-logger_handle_h = (
-    h.Callable[[lggg.LogRecord], None] | h.Callable[[lggg.Logger, lggg.LogRecord], None]
-)
+WARNING_TYPE_COMPILED_PATTERN = r.compile(WARNING_TYPE_PATTERN)
 
 """
 COPYRIGHT NOTICE

logger_36/content.py

@@ -4,9 +4,9 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from logger_36.constant.message import LINE_INDENT
-from logger_36.task.format.message import MessageWithActualExpected
-from logger_36.task.format.rule import Rule, RuleAsText
+from logger_36.constant.message import LINE_INDENT  # noqa
+from logger_36.task.format.message import MessageWithActualExpected  # noqa
+from logger_36.task.format.rule import Rule, RuleAsText  # noqa
 
 """
 COPYRIGHT NOTICE