logger-36 2025.5__py3-none-any.whl → 2025.7__py3-none-any.whl

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

@@ -6,8 +6,8 @@ SEE COPYRIGHT NOTICE BELOW
 
 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.

logger_36/catalog/config/optional.py

@@ -0,0 +1,60 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+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
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

logger_36/catalog/handler/console.py

@@ -6,19 +6,23 @@ SEE COPYRIGHT NOTICE BELOW
 
 import dataclasses as d
 import logging as l
-import textwrap as txt_
 import typing as h
 
-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 MessageFromRecordRaw_h, handler_extension_t
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
 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: MessageFromRecordRaw_h = d.field(init=False)
 
     name: d.InitVar[str | None] = None
     level: d.InitVar[int] = l.NOTSET
@@ -56,18 +60,16 @@ class console_handler_t(l.Handler):
             message = self.MessageFromRecord(record)
         print(message)
 
-    def ShowMessage(self, message: str, /, *, indented: bool = False) -> None:
+    def LogAsIs(self, message: str, /) -> None:
         """
         See documentation of
-        logger_36.catalog.handler.generic.generic_handler_t.ShowMessage.
+        logger_36.catalog.handler.generic.generic_handler_t.LogAsIs.
         """
-        if indented:
-            message = txt_.indent(message, LINE_INDENT)
         print(message)
 
     def DisplayRule(self, /, *, text: str | None = None, color: str = "white") -> None:
         """"""
-        self.ShowMessage(RuleAsText(text))
+        self.LogAsIs(RuleAsText(text))
 
 
 """

logger_36/catalog/handler/console_rich.py

@@ -6,7 +6,6 @@ SEE COPYRIGHT NOTICE BELOW
 
 import dataclasses as d
 import logging as l
-import textwrap as txt_
 import typing as h
 
 from logger_36.catalog.config.console_rich import (
@@ -20,15 +19,15 @@ from logger_36.catalog.config.console_rich import (
     WHITE_COLOR,
 )
 from logger_36.config.message import ACTUAL_PATTERNS, EXPECTED_PATTERNS, WHERE_SEPARATOR
-from logger_36.constant.message import CONTEXT_LENGTH, LINE_INDENT
+from logger_36.constant.message import CONTEXT_LENGTH
 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.task.format.rule import Rule
+from logger_36.type.handler import MessageFromRecordPreprocessed_p, handler_extension_t
+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 = (
@@ -47,6 +46,8 @@ _EXCLUSIVE_TRACEBACK_ARGUMENTS = (
 @d.dataclass(slots=True, repr=False, eq=False)
 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,9 +56,11 @@ class console_rich_handler_t(l.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: MessageFromRecordPreprocessed_p = d.field(init=False)
     alternating_lines: int = 0
     background_is_light: bool = True
 
@@ -145,18 +148,16 @@ class console_rich_handler_t(l.Handler):
             )
         self.console.print(richer, crop=False, overflow="ignore")
 
-    def ShowMessage(self, message: str | rule_t, /, *, indented: bool = False) -> None:
+    def LogAsIs(self, message: str | renderable_t, /) -> None:
         """
         See documentation of
-        logger_36.catalog.handler.generic.generic_handler_t.ShowMessage.
+        logger_36.catalog.handler.generic.generic_handler_t.LogAsIs.
         """
-        if isinstance(message, str) and indented:
-            message = txt_.indent(message, LINE_INDENT)
         self.console.print(message, crop=False, overflow="ignore")
 
     def DisplayRule(self, /, *, text: str | None = None, color: str = "white") -> None:
         """"""
-        self.ShowMessage(Rule(text, color))
+        self.LogAsIs(Rule(text, color))
 
 
 def HighlightedVersion(

logger_36/catalog/handler/file.py

@@ -6,21 +6,24 @@ SEE COPYRIGHT NOTICE BELOW
 
 import dataclasses as d
 import logging as l
-import textwrap as txt_
 import typing as h
 from pathlib import Path as path_t
 
-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 MessageFromRecordRaw_h, handler_extension_t
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
 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: MessageFromRecordRaw_h = d.field(init=False)
 
     name: d.InitVar[str | None] = None
     level: d.InitVar[int] = l.NOTSET
@@ -66,19 +69,17 @@ class file_handler_t(l.FileHandler):
         print(message, file=self.stream)
         self.stream.flush()
 
-    def ShowMessage(self, message: str, /, *, indented: bool = False) -> None:
+    def LogAsIs(self, message: str, /) -> None:
         """
         See documentation of
-        logger_36.catalog.handler.generic.generic_handler_t.ShowMessage.
+        logger_36.catalog.handler.generic.generic_handler_t.LogAsIs.
         """
-        if indented:
-            message = txt_.indent(message, LINE_INDENT)
         print(message, file=self.stream)
         self.stream.flush()
 
     def DisplayRule(self, /, *, text: str | None = None, color: str = "white") -> None:
         """"""
-        self.ShowMessage(RuleAsText(text))
+        self.LogAsIs(RuleAsText(text))
 
 
 """

logger_36/catalog/handler/generic.py

@@ -8,34 +8,37 @@ import dataclasses as d
 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 MessageFromRecord_h, handler_extension_t
 
-@h.runtime_checkable
-class show_message_p(h.Protocol):
-    def __call__(self, message: str, /, *, indented: bool = False) -> None: ...
+LogAsIs_h = h.Callable[[str | h.Any], None]
 
 
 @h.runtime_checkable
-class display_rule_p(h.Protocol):
+class DisplayRule_p(h.Protocol):
     def __call__(self, /, *, text: str | None = None, color: str = "white") -> None: ...
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
 class generic_handler_t(l.Handler):
     """
+    kind: See logger_36.constant.handler.handler_codes_h.
+
     alternating_lines:
         - Initial value:
             - 1: enabled for dark background
@@ -43,7 +46,7 @@ class generic_handler_t(l.Handler):
             - anything else: disabled
         - Runtime value: 0/1=do not/do highlight next time.
 
-    ShowMessage:
+    LogAsIs:
         Log a message as is, i.e. without formatting. If this is a method, it should
         contain the same call(s) as the final ones in the emit methods that are used to
         output the formatted log messages. This means that there is some code
@@ -54,16 +57,18 @@ class generic_handler_t(l.Handler):
         it is indeed called at the end of the emit method.
     """
 
-    ShowMessage: show_message_p
+    kind: h.ClassVar[str] = "g"
+
+    LogAsIs: LogAsIs_h
     # "None -> h.Any" (twice below) since None | None is invalid.
     console: console_t | h.Any = None
     console_options: console_options_t | h.Any = None
     alternating_lines: int = 0
     background_is_light: bool = True
 
-    DisplayRule: display_rule_p = d.field(init=False)
+    DisplayRule: DisplayRule_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: MessageFromRecord_h = d.field(init=False)
 
     name: d.InitVar[str | None] = None
     level: d.InitVar[int] = l.NOTSET
@@ -170,17 +175,17 @@ class generic_handler_t(l.Handler):
                 "<pre style='margin-bottom:0px'>" + "".join(html_segments) + "</pre>"
             )
 
-        self.ShowMessage(message)
+        self.LogAsIs(message)
 
     def _DisplayRuleAsText(
         self, /, *, text: str | None = None, color: str = "white"
     ) -> None:
         """"""
-        self.ShowMessage(RuleAsText(text))
+        self.LogAsIs(RuleAsText(text))
 
     def _DisplayRule(self, /, *, text: str | None = None, color: str = "white") -> None:
         """"""
-        self.ShowMessage(Rule(text, color))
+        self.LogAsIs(Rule(text, color))
 
 
 """

logger_36/catalog/logger/gpu.py

@@ -13,11 +13,11 @@ 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 = L) -> None:

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 l
-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[[l.LogRecord], None] | h.Callable[[l.Logger, l.LogRecord], None]
-)
+WARNING_TYPE_COMPILED_PATTERN = r.compile(WARNING_TYPE_PATTERN)
 
 """
 COPYRIGHT NOTICE

logger_36/{config/logger.py → constant/path.py}

@@ -4,54 +4,23 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import logging as l
+import inspect as nspt
+import tempfile as tmps
+from pathlib import Path as path_t
 
-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 L
-from logger_36.task.format.message import MessageWithActualExpected
-
-
-def SetLOGLevel(
-    level: int,
-    /,
-    *,
-    logger: l.Logger = L,
-    which: handler_codes_h | str = "a",
-) -> None:
-    """
-    which: g=generic, c=console, f=file, a=all, str=name.
-    """
-    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",
-            )
-        )
+USER_FOLDER = path_t.home()
 
+frame = nspt.stack()[-1]
+if path_t(frame.filename).exists():
+    PROJECT_FILE = path_t(frame.filename)
+    if PROJECT_FILE.is_relative_to(USER_FOLDER):
+        PROJECT_FILE_RELATIVE = path_t("~") / PROJECT_FILE.relative_to(USER_FOLDER)
+    else:
+        PROJECT_FILE_RELATIVE = PROJECT_FILE
+    PROJECT_FOLDER = PROJECT_FILE.parent
+else:
+    PROJECT_FILE = PROJECT_FILE_RELATIVE = "<unknown>"
+    PROJECT_FOLDER = path_t(tmps.mkdtemp())
 
 """
 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

logger_36/exception.py

@@ -4,12 +4,15 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
+import re as r
 import sys as s
 import tempfile as tmpf
 import traceback as tcbk
 import types as t
 from pathlib import Path as path_t
 
+from logger_36.constant.path import USER_FOLDER
+
 _ORIGINAL_EXCEPTION_HANDLER = s.excepthook
 
 
@@ -30,24 +33,56 @@ def _HandleException(
     while trace.tb_next is not None:
         trace = trace.tb_next
     frame = trace.tb_frame
-    module = frame.f_code.co_filename
-    function = frame.f_code.co_name
-    line = frame.f_lineno
-
-    home = str(path_t.home())
-    if module.startswith(home):
-        module = "~" + module[home.__len__() :]
-
-    message = str(exception)
+    code = frame.f_code
+    module = path_t(code.co_filename)
+    function = code.co_name
+    line_number = frame.f_lineno
+    line_content = module.read_text().splitlines()[line_number - 1].strip()
+
+    # Format module.
+    if module.is_relative_to(USER_FOLDER):
+        module = path_t("~") / module.relative_to(USER_FOLDER)
+
+    # Format line content.
+    if line_content.startswith("raise "):
+        # Do not display code of explicit exception raising.
+        line_content = None
+
+    # Find variables appearing in the line.
+    if line_content is None:
+        line_content = variables = ""
+    else:
+        all_variables = frame.f_locals
+        found_names = []
+        for match in r.finditer(r"[^\d\W]\w*", line_content):
+            name = match.group()
+            if name in all_variables:
+                found_names.append(name)
+        if found_names.__len__() > 0:
+            longest = max(map(len, found_names))
+            variables = map(
+                lambda _: f"{_:{longest}} = {all_variables[_]}", sorted(found_names)
+            )
+            variables = "        " + "\n        ".join(variables) + "\n"
+        else:
+            variables = ""
+
+        line_content = f"    {line_content}\n"
+
+    # Format message.
+    message = str(exception).strip()
     if message.__len__() > 0:
-        message = f"    {message}\n"
+        message = f"    {message[0].title()}{message[1:]}\n"
 
     document = tmpf.NamedTemporaryFile(delete=False)
 
     print(
         f"{stripe.__name__}\n"
-        f"    {module}.{function}@{line}\n"
-        f"{message}    Full report at: {document.name}",
+        f"    {module}:{function}@{line_number}\n"
+        f"{line_content}"
+        f"{variables}"
+        f"{message}"
+        f"    Full report at: {document.name}",
         file=s.stderr,
     )
 

logger_36/gpu.py

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