logger-36 2025.22__tar.gz → 2025.24__tar.gz

{logger_36-2025.22 → logger_36-2025.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logger-36
-Version: 2025.22
+Version: 2025.24
 Summary: Simple logger with a catalog of handlers
 Home-page: https://src.koda.cnrs.fr/eric.debreuve/logger-36/
 Author: Eric Debreuve

logger_36-2025.24/package/logger_36/api/memory.py

@@ -0,0 +1,40 @@
+"""
+Copyright CNRS (https://www.cnrs.fr/index.php/en)
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from logger_36.task.measure.memory import CanCheckUsage as CanCheckMemoryUsage  # noqa
+from logger_36.task.measure.memory import CurrentUsage as CurrentMemoryUsage  # noqa
+
+"""
+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.
+"""

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/api/storage.py

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

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/api/time.py

@@ -4,7 +4,6 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from logger_36.catalog.logger.chronos import LogElapsedTime  # noqa
 from logger_36.task.measure.chronos import ElapsedTime, TimeStamp  # noqa
 
 """

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/catalog/handler/console.py

@@ -8,7 +8,7 @@ import logging as l
 import sys as s
 import typing as h
 
-from logger_36.type.handler import handler_t as base_t
+from logger_36.type.handler import non_file_handler_t as base_t
 
 
 class console_handler_t(base_t):

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/catalog/handler/console_rich.py

@@ -26,7 +26,7 @@ from logger_36.catalog.config.console_rich import (
 )
 from logger_36.config.message import ACTUAL_PATTERNS, EXPECTED_PATTERNS, WHERE_SEPARATOR
 from logger_36.constant.message import CONTEXT_LENGTH
-from logger_36.type.handler import handler_t as base_t
+from logger_36.type.handler import non_file_handler_t as base_t
 
 _COMMON_TRACEBACK_ARGUMENTS = ("theme", "width")
 _EXCLUSIVE_TRACEBACK_ARGUMENTS = (

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/catalog/handler/generic.py

@@ -23,7 +23,7 @@ else:
         RULE_COLOR
     ) = HighlightedVersion = None
 
-from logger_36.type.handler import handler_t as base_t
+from logger_36.type.handler import non_file_handler_t as base_t
 
 
 class generic_handler_t(base_t):

logger_36-2025.22/package/logger_36/extension/html_.py → logger_36-2025.24/package/logger_36/catalog/handler/memory.py

@@ -4,60 +4,68 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import dataclasses as d
-import re as r
-from html.parser import HTMLParser as base_t
+import json
+import logging as l
+import typing as h
 
-_BODY_END_PATTERN = r"</[bB][oO][dD][yY]>(.|\n)*$"
+from logger_36.type.handler import non_file_handler_t as base_t
 
+formats_h = h.Literal["dict", "json", "message", "raw"]
 
-@d.dataclass(slots=True, repr=False, eq=False)
-class html_content_t(base_t):
-    source: str = ""
-    inside_body: bool = d.field(init=False, default=False)
-    body_position_start: tuple[int, int] = d.field(init=False, default=(-1, -1))
-    body_position_end: tuple[int, int] = d.field(init=False, default=(-1, -1))
-    pieces: list[str] = d.field(init=False, default_factory=list)
 
-    @property
-    def body(self) -> str:
+class memory_handler_t(base_t):
+    def __init__(
+        self, name: str | None, message_width: int, level: int, format_: formats_h
+    ) -> None:
         """"""
-        output = self.source.splitlines()
-        output = "\n".join(
-            output[self.body_position_start[0] : (self.body_position_end[0] + 1)]
-        )
-        output = output[self.body_position_start[1] :]
-        output = r.sub(_BODY_END_PATTERN, "", output, count=1)
-
-        return output.strip()
-
-    @property
-    def body_as_text(self) -> str:
+        assert format_ in h.get_args(formats_h)
+
+        base_t.__init__(self, name, message_width, None, level)
+
+        self.format_ = format_
+        self.records = []
+
+    @classmethod
+    def New(
+        cls,
+        /,
+        *,
+        name: str | None = None,
+        message_width: int = -1,
+        level: int = l.NOTSET,
+        format_: formats_h = "message",
+        **_,
+    ) -> h.Self:
         """"""
-        return "".join(self.pieces).strip()
+        return cls(name, message_width, level, format_)
 
-    def __post_init__(self) -> None:
+    def emit(self, record: l.LogRecord, /) -> None:
         """"""
-        base_t.__init__(self)
-        self.source = self.source.strip()
-        self.feed(self.source)
-
-    def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]], /) -> None:
+        level = record.levelno
+
+        if self.format_ == "raw":
+            is_not_a_rule = True
+        elif self.format_ == "dict":
+            record = dict(record.__dict__)
+            is_not_a_rule = True
+        elif self.format_ == "json":
+            record = json.dumps(record.__dict__)
+            is_not_a_rule = True
+        else:
+            record, is_not_a_rule = self.MessageFromRecord(record)
+
+        self.records.append((level, record, is_not_a_rule))
+
+    def EmitMessage(self, message: str, /) -> None:
         """"""
-        if tag == "body":
-            self.body_position_start = self.getpos()
-            self.inside_body = True
-
-    def handle_endtag(self, tag: str, /) -> None:
-        """"""
-        if tag == "body":
-            self.body_position_end = self.getpos()
-            self.inside_body = False
-
-    def handle_data(self, data: str, /) -> None:
-        """"""
-        if self.inside_body:
-            self.pieces.append(data)
+        if self.format_ == "message":
+            message_key = "msg"
+        else:
+            message_key = "message"
+        record = l.makeLogRecord(
+            {"name": "<UNKNOWN LOGGER>", "levelno": l.INFO, message_key: message}
+        )
+        self.emit(record)
 
 
 """

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/catalog/logger/system.py

@@ -5,16 +5,17 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 from logger_36.constant.system import MAX_DETAIL_NAME_LENGTH, SYSTEM_DETAILS_AS_DICT
+from logger_36.extension.inspection import Modules
 from logger_36.instance.logger import L
-from logger_36.task.inspection import Modules
 from logger_36.type.logger import logger_t
 
 
 def LogSystemDetails(
     *,
+    should_restrict_modules_to_loaded: bool = True,
     modules_with_version: bool = True,
     modules_formatted: bool = True,
-    should_restrict_modules_to_loaded: bool = True,
+    indent: int = 4,
     logger: logger_t = L,
 ) -> None:
     """"""
@@ -23,10 +24,10 @@ def LogSystemDetails(
         for _key, _vle in SYSTEM_DETAILS_AS_DICT.items()
     )
     modules = Modules(
-        modules_with_version,
-        modules_formatted,
         only_loaded=should_restrict_modules_to_loaded,
-        indent=4,
+        with_version=modules_with_version,
+        formatted=modules_formatted,
+        indent=indent,
     )
 
     logger.info(

logger_36-2025.22/package/logger_36/api/system.py → logger_36-2025.24/package/logger_36/config/rule.py

@@ -4,7 +4,8 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from logger_36.catalog.logger.system import LogSystemDetails  # noqa
+RULE_CHARACTER = "-"
+DEFAULT_RULE_LENGTH = 50
 
 """
 COPYRIGHT NOTICE

logger_36-2025.24/package/logger_36/constant/date_time.py

@@ -0,0 +1,46 @@
+"""
+Copyright CNRS (https://www.cnrs.fr/index.php/en)
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from datetime import datetime as date_time_t
+
+# This module is imported early. Therefore, the current date and time should be close
+# enough to the real start date and time of the main script.
+START_DATE_TIME = date_time_t.now()
+
+DATE_TIME_ORIGIN = date_time_t.fromtimestamp(1970, None)
+DATE_ORIGIN = DATE_TIME_ORIGIN.date()
+
+"""
+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.
+"""

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/constant/path.py

@@ -12,15 +12,16 @@ USER_FOLDER = path_t.home()
 
 frame = e.stack(context=0)[-1]  # -1=root caller.
 if path_t(frame.filename).exists():
-    PROJECT_FILE = path_t(frame.filename)
-    if PROJECT_FILE.is_relative_to(USER_FOLDER):
-        PROJECT_FILE_RELATIVE = PROJECT_FILE.relative_to(USER_FOLDER)
+    LAUNCH_ROOT_FILE = path_t(frame.filename)
+    LAUNCH_FOLDER = LAUNCH_ROOT_FILE.parent
+
+    if LAUNCH_ROOT_FILE.is_relative_to(USER_FOLDER):
+        LAUNCH_ROOT_FILE_relative = LAUNCH_ROOT_FILE.relative_to(USER_FOLDER)
     else:
-        PROJECT_FILE_RELATIVE = PROJECT_FILE
-    PROJECT_FOLDER = PROJECT_FILE.parent
+        LAUNCH_ROOT_FILE_relative = LAUNCH_ROOT_FILE
 else:
-    PROJECT_FILE = PROJECT_FILE_RELATIVE = "<unknown>"
-    PROJECT_FOLDER = path_t(tmps.mkdtemp())
+    LAUNCH_ROOT_FILE = LAUNCH_ROOT_FILE_relative = "<unknown launch root file>"
+    LAUNCH_FOLDER = path_t(tmps.mkdtemp())
 
 """
 COPYRIGHT NOTICE

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/constant/record.py

@@ -4,7 +4,6 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-INTERNAL_INFO_ATTR = "internal_info"
 SHOW_WHERE_ATTR = "should_show_where"
 SHOW_W_RULE_ATTR = "should_show_w_rule"
 WHEN_OR_ELAPSED_ATTR = "when_or_elapsed"

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/constant/rule.py

@@ -4,9 +4,9 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-RULE_CHARACTER = "-"
+from logger_36.config.rule import DEFAULT_RULE_LENGTH, RULE_CHARACTER
+
 MIN_HALF_RULE_LENGTH = 4
-DEFAULT_RULE_LENGTH = 50
 DEFAULT_RULE = DEFAULT_RULE_LENGTH * RULE_CHARACTER
 
 """

{logger_36-2025.22/package/logger_36/task → logger_36-2025.24/package/logger_36/extension}/inspection.py

@@ -4,14 +4,16 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import importlib.metadata as mprt
 import pkgutil as pkgs
 import sys as s
-from types import FunctionType, MethodType
 
 
 def Modules(
-    with_version: bool, formatted: bool, /, *, only_loaded: bool = True, indent: int = 0
+    *,
+    only_loaded: bool = True,
+    with_version: bool = True,
+    formatted: bool = False,
+    indent: int = 0,
 ) -> tuple[str, ...] | str:
     """"""
     output = []
@@ -61,23 +63,6 @@ def Modules(
     return tuple(output)
 
 
-def WhereFunction(function: FunctionType, /) -> str:
-    """"""
-    return f"{function.__module__}:{function.__name__}"
-
-
-def WhereMethod(instance: object, method: MethodType, /) -> str:
-    """
-    method: Could be a str instead, which would require changing method.__name__ into
-    getattr(cls, method). But if the method name changes while forgetting to change the
-    string in the call to WhereMethod accordingly, then an exception would be raised
-    here.
-    """
-    cls = instance.__class__
-
-    return f"{cls.__module__}:{cls.__name__}:{method.__name__}"
-
-
 def _ModulesUsingPkgUtil() -> tuple[str, ...]:
     """
     Returns more results than using importlib.
@@ -91,15 +76,16 @@ def _ModulesUsingPkgUtil() -> tuple[str, ...]:
     )
 
 
-def _ModulesUsingImportlib() -> tuple[str, ...]:
-    """"""
-    return tuple(
-        sorted(
-            _elm
-            for _elm in mprt.packages_distributions()
-            if (_elm[0] != "_") and ("__" not in _elm) and ("/" not in _elm)
-        )
-    )
+# import importlib.metadata as mprt
+# def _ModulesUsingImportlib() -> tuple[str, ...]:
+#     """"""
+#     return tuple(
+#         sorted(
+#             _elm
+#             for _elm in mprt.packages_distributions()
+#             if (_elm[0] != "_") and ("__" not in _elm) and ("/" not in _elm)
+#         )
+#     )
 
 
 """

logger_36-2025.24/package/logger_36/extension/record.py

@@ -0,0 +1,66 @@
+"""
+Copyright CNRS (https://www.cnrs.fr/index.php/en)
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+import logging as l
+import sys as s
+from os import sep as FOLDER_SEPARATOR
+from pathlib import Path as path_t
+
+from logger_36.constant.path import USER_FOLDER
+from logger_36.constant.record import WHERE_ATTR
+
+
+def RecordLocation(record: l.LogRecord, should_also_store: bool, /) -> str:
+    """"""
+    module = path_t(record.pathname)
+    for path in s.path:
+        if module.is_relative_to(path):
+            module = module.relative_to(path).with_suffix("")
+            module = str(module).replace(FOLDER_SEPARATOR, ".")
+            break
+    else:
+        if module.is_relative_to(USER_FOLDER):
+            module = module.relative_to(USER_FOLDER)
+
+    output = f"{module}:{record.funcName}:{record.lineno}"
+
+    if should_also_store:
+        setattr(record, WHERE_ATTR, output)
+
+    return output
+
+
+"""
+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.
+"""

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/task/measure/chronos.py

@@ -7,9 +7,7 @@ SEE COPYRIGHT NOTICE BELOW
 import time
 from datetime import datetime as date_time_t
 
-# This module is imported early. Therefore, the current date and time should be close
-# enough to the real start time of the main script.
-_START_DATE_AND_TIME = date_time_t.now()
+from logger_36.constant.date_time import START_DATE_TIME
 
 
 def TimeStamp(*, precision: str = "microseconds") -> str:
@@ -25,7 +23,7 @@ def TimeStamp(*, precision: str = "microseconds") -> str:
 def ElapsedTime(*, should_return_now: bool = False) -> str | tuple[str, date_time_t]:
     """"""
     now = date_time_t.now()
-    elapsed_seconds = (now - _START_DATE_AND_TIME).total_seconds()
+    elapsed_seconds = (now - START_DATE_TIME).total_seconds()
     output = time.strftime("%H:%M:%S", time.gmtime(elapsed_seconds))
     while output.startswith("00:"):
         output = output.split(sep=":", maxsplit=1)[-1]

{logger_36-2025.22 → logger_36-2025.24}/package/logger_36/task/storage.py

@@ -5,30 +5,35 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 import logging as l
+import os as o
+import tempfile as tmps
 from io import IOBase as io_base_t
 from pathlib import Path as path_t
 
 from logger_36.constant.html import BODY_PLACEHOLDER, MINIMAL_HTML, TITLE_PLACEHOLDER
 from logger_36.instance.logger import L
+from logger_36.type.logger import logger_t
 
 
-def SaveLOGasHTML(path: str | path_t | io_base_t | None = None) -> None:
+def SaveLOGasHTML(
+    path: str | path_t | io_base_t | None = None, /, *, logger: logger_t = L
+) -> None:
     """
     From first console handler found.
     """
     cannot_save = "Cannot save logging record as HTML"
 
     if path is None:
-        for handler in L.handlers:
+        for handler in logger.handlers:
             if isinstance(handler, l.FileHandler):
                 path = path_t(handler.baseFilename).with_suffix(".htm")
                 break
         else:
-            L.warning(f"{cannot_save}: No file handler to build a filename from.")
+            logger.warning(f"{cannot_save}: No file handler to build a filename from.")
             return
 
         if path.exists():
-            L.warning(
+            logger.warning(
                 f'{cannot_save}: Automatically generated path "{path}" already exists.'
             )
             return
@@ -38,13 +43,45 @@ def SaveLOGasHTML(path: str | path_t | io_base_t | None = None) -> None:
     actual_file = isinstance(path, path_t)
 
     if actual_file and path.exists():
-        L.warning(f'{cannot_save}: File "{path}" already exists.')
+        existing = path
+
+        accessor, path = tmps.mkstemp(suffix=".htm")
+        o.close(accessor)
+        path = path_t(path)
+
+        logger.warning(
+            f'File "{existing}" already exists: Saving LOG as HTML in {path} instead.'
+        )
+
+    for handler in logger.handlers:
+        records = getattr(handler, "records", None)
+        if isinstance(records, list) and (
+            (records.__len__() == 0)
+            or all(
+                isinstance(_, tuple)
+                and isinstance(_[0], int)
+                and isinstance(_[1], dict | str | l.LogRecord)
+                and isinstance(_[2], bool)
+                for _ in records
+            )
+        ):
+            break
+    else:
+        logger.warning(f"{cannot_save}: No handlers with recording capability found.")
         return
 
-    body = "\n".join(map(_HighlightedEvent, L.recorded))
-    html = MINIMAL_HTML.replace(TITLE_PLACEHOLDER, L.name).replace(
+    if records.__len__() == 0:
+        return
+
+    if isinstance(records[0][1], str):
+        records = map(_HighlightedEvent, records)
+    else:
+        records = map(lambda _: str(_[1]), records)
+    body = "\n".join(records)
+    html = MINIMAL_HTML.replace(TITLE_PLACEHOLDER, logger.name).replace(
         BODY_PLACEHOLDER, body
     )
+
     if actual_file:
         with open(path, "w") as accessor:
             accessor.write(html)
@@ -52,21 +89,25 @@ def SaveLOGasHTML(path: str | path_t | io_base_t | None = None) -> None:
         path.write(html)
 
 
-def _HighlightedEvent(event: tuple[int, str], /) -> str:
+def _HighlightedEvent(event: tuple[int, str, bool], /) -> str:
     """"""
-    level, message = event
-    if level == l.DEBUG:
-        color = "BlueViolet"
-    elif level == l.INFO:
-        color = "black"
-    elif level == l.WARNING:
-        color = "gold"
-    elif level == l.ERROR:
-        color = "orange"
-    elif level == l.CRITICAL:
-        color = "red"
+    level, message, is_not_a_rule = event
+
+    if is_not_a_rule:
+        if level == l.DEBUG:
+            color = "BlueViolet"
+        elif level == l.INFO:
+            color = "black"
+        elif level == l.WARNING:
+            color = "gold"
+        elif level == l.ERROR:
+            color = "orange"
+        elif level == l.CRITICAL:
+            color = "red"
+        else:
+            color = "black"
     else:
-        color = "black"
+        color = "DarkTurquoise"
 
     return f'<span style="color:{color}">{message}</span>'