logger-36 2025.16__tar.gz → 2025.17__tar.gz

{logger_36-2025.16 → logger_36-2025.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logger-36
-Version: 2025.16
+Version: 2025.17
 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.16 → logger_36-2025.17}/package/logger_36/catalog/handler/console.py

@@ -21,14 +21,13 @@ class console_handler_t(base_t):
         /,
         *,
         name: str | None = None,
-        should_store_memory_usage: bool = False,
         message_width: int = -1,
         level: int = l.NOTSET,
         formatter: l.Formatter | None = None,
         **_,
     ) -> h.Self:
         """"""
-        return cls(name, should_store_memory_usage, message_width, level, formatter)
+        return cls(name, message_width, level, formatter)
 
     def emit(self, record: l.LogRecord, /) -> None:
         """"""

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/catalog/handler/console_rich.py

@@ -55,7 +55,6 @@ class console_rich_handler_t(base_t):
     def __init__(
         self,
         name: str | None,
-        should_store_memory_usage: bool,
         message_width: int,
         level: int,
         formatter: l.Formatter | None,
@@ -67,15 +66,7 @@ class console_rich_handler_t(base_t):
 
         assert alternating_logs in (0, 1, 2)
 
-        base_t.__init__(
-            self,
-            name,
-            should_store_memory_usage,
-            message_width,
-            level,
-            formatter,
-            kwargs,
-        )
+        base_t.__init__(self, name, message_width, level, formatter, kwargs)
 
         self.console = None  # console_t | None.
         self.alternating_logs = alternating_logs
@@ -105,16 +96,13 @@ class console_rich_handler_t(base_t):
         /,
         *,
         name: str | None = None,
-        should_store_memory_usage: bool = False,
         message_width: int = -1,
         level: int = l.NOTSET,
         formatter: l.Formatter | None = None,
         **kwargs,
     ) -> h.Self:
         """"""
-        return cls(
-            name, should_store_memory_usage, message_width, level, formatter, kwargs
-        )
+        return cls(name, message_width, level, formatter, kwargs)
 
     def emit(self, record: l.LogRecord, /) -> None:
         """"""

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/catalog/handler/file.py

@@ -21,7 +21,6 @@ class file_handler_t(base_t):
         /,
         *,
         name: str | None = None,
-        should_store_memory_usage: bool = False,
         message_width: int = -1,
         level: int = l.NOTSET,
         formatter: l.Formatter | None = None,
@@ -29,9 +28,7 @@ class file_handler_t(base_t):
         **_,
     ) -> h.Self:
         """"""
-        return cls(
-            name, should_store_memory_usage, message_width, level, formatter, path
-        )
+        return cls(name, message_width, level, formatter, path)
 
     def emit(self, record: l.LogRecord, /) -> None:
         """"""

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/catalog/handler/generic.py

@@ -56,7 +56,6 @@ class generic_handler_t(base_t):
     def __init__(
         self,
         name: str | None,
-        should_store_memory_usage: bool,
         message_width: int,
         level: int,
         formatter: l.Formatter | None,
@@ -69,15 +68,7 @@ class generic_handler_t(base_t):
 
         assert alternating_logs in (0, 1, 2)
 
-        base_t.__init__(
-            self,
-            name,
-            should_store_memory_usage,
-            message_width,
-            level,
-            formatter,
-            kwargs,
-        )
+        base_t.__init__(self, name, message_width, level, formatter, kwargs)
 
         self.LogAsIs = LogAsIs
         self.DisplayRule = None  # DisplayRule_p | None.
@@ -105,16 +96,13 @@ class generic_handler_t(base_t):
         /,
         *,
         name: str | None = None,
-        should_store_memory_usage: bool = False,
         message_width: int = -1,
         level: int = l.NOTSET,
         formatter: l.Formatter | None = None,
         **kwargs,
     ) -> h.Self:
         """"""
-        return cls(
-            name, should_store_memory_usage, message_width, level, formatter, kwargs
-        )
+        return cls(name, message_width, level, formatter, kwargs)
 
     def emit(self, record: l.LogRecord, /) -> None:
         """"""

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/catalog/logger/memory.py

@@ -21,7 +21,7 @@ def LogMemoryUsages(
     logger: logger_t = L,
 ) -> None:
     """"""
-    if not logger.any_handler_stores_memory:
+    if (not hasattr(logger, "memory_usages")) or (logger.memory_usages.__len__() == 0):
         return
 
     where_s, usages = zip(*logger.memory_usages)
@@ -76,10 +76,12 @@ def LogMaximumMemoryUsage(
     """
     unit: b or None=bytes, k=kilo, m=mega, g=giga, a=auto
     """
-    if logger.any_handler_stores_memory:
-        where, max_usage = logger.max_memory_usage_full
-        value, unit = FormattedUsage(max_usage, unit=unit, decimals=decimals)
-        logger.info(f"Max. Memory Usage: {value}{unit} near {where}")
+    if (not hasattr(logger, "memory_usages")) or (logger.memory_usages.__len__() == 0):
+        return
+
+    where, max_usage = logger.max_memory_usage_full
+    value, unit = FormattedUsage(max_usage, unit=unit, decimals=decimals)
+    logger.info(f"Max. Memory Usage: {value}{unit} near {where}")
 
 
 """

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/constant/handler.py

@@ -9,8 +9,6 @@ import typing as 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>"
-
 """
 COPYRIGHT NOTICE
 

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/constant/path.py

@@ -4,13 +4,13 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import inspect as nspt
+import inspect as e
 import tempfile as tmps
 from pathlib import Path as path_t
 
 USER_FOLDER = path_t.home()
 
-frame = nspt.stack()[-1]
+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):

logger_36-2025.17/package/logger_36/constant/record.py

@@ -0,0 +1,54 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+SHOW_W_RULE_ATTR = "should_show_w_rule"
+SHOW_WHERE_ATTR = "should_show_where"
+
+"""
+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-2025.16 → logger_36-2025.17}/package/logger_36/type/handler.py

@@ -10,26 +10,22 @@ import typing as h
 from pathlib import Path as path_t
 
 from logger_36.config.message import FALLBACK_MESSAGE_WIDTH
-from logger_36.constant.error import MEMORY_MEASURE_ERROR
 from logger_36.constant.handler import HANDLER_KINDS
 from logger_36.task.format.message import MessageFromRecord, MessageWithActualExpected
 from logger_36.task.format.rule import RuleAsText
 from logger_36.task.measure.chronos import TimeStamp
-from logger_36.task.measure.memory import CanCheckUsage as CanCheckMemoryUsage
 from logger_36.type.message import MessageFromRecord_h, RuleWithText_h
 
-_MEMORY_MEASURE_ERROR = MEMORY_MEASURE_ERROR
-
 
 class _base_t:
     kind: h.ClassVar[str] = ""  # See logger_36.constant.handler.handler_codes_h.
 
-    def __init__(
-        self, name: str | None, should_store_memory_usage: bool, message_width: int
-    ) -> None:
+    def __init__(self, name: str | None, message_width: int) -> None:
         """"""
+        if name is None:
+            name = f"{type(self).__name__}:{id(self)}"
+
         self.name = name
-        self.should_store_memory_usage = should_store_memory_usage
         self.message_width = message_width
         #
         self.MessageFromRecord: MessageFromRecord_h | None = None
@@ -38,8 +34,6 @@ class _base_t:
 
     def __post_init__(self) -> None:
         """"""
-        global _MEMORY_MEASURE_ERROR
-
         if self.name in HANDLER_KINDS:
             raise ValueError(
                 MessageWithActualExpected(
@@ -52,12 +46,6 @@ class _base_t:
         if self.name is None:
             self.name = TimeStamp()
 
-        if self.should_store_memory_usage and not CanCheckMemoryUsage():
-            self.should_store_memory_usage = False
-            if _MEMORY_MEASURE_ERROR is not None:
-                s.__stderr__.write(_MEMORY_MEASURE_ERROR + "\n")
-                _MEMORY_MEASURE_ERROR = None
-
         if 0 < self.message_width < FALLBACK_MESSAGE_WIDTH:
             self.message_width = FALLBACK_MESSAGE_WIDTH
 
@@ -84,7 +72,6 @@ class handler_t(l.Handler, _base_t):
     def __init__(
         self,
         name: str | None,
-        should_store_memory_usage: bool,
         message_width: int,
         level: int,
         formatter: l.Formatter | None,
@@ -92,7 +79,7 @@ class handler_t(l.Handler, _base_t):
     ) -> None:
         """"""
         l.Handler.__init__(self)
-        _base_t.__init__(self, name, should_store_memory_usage, message_width)
+        _base_t.__init__(self, name, message_width)
         __post_init__(self, level, formatter)
 
 
@@ -100,7 +87,6 @@ class file_handler_t(l.FileHandler, _base_t):
     def __init__(
         self,
         name: str | None,
-        should_store_memory_usage: bool,
         message_width: int,
         level: int,
         formatter: l.Formatter | None,
@@ -116,7 +102,7 @@ class file_handler_t(l.FileHandler, _base_t):
             raise ValueError(f"File or folder already exists: {path}.")
 
         l.FileHandler.__init__(self, path)
-        _base_t.__init__(self, name, should_store_memory_usage, message_width)
+        _base_t.__init__(self, name, message_width)
         __post_init__(self, level, formatter)
 
 

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/type/logger.py

@@ -5,6 +5,7 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 import dataclasses as d
+import inspect as e
 import logging as l
 import sys as s
 import textwrap as text
@@ -28,8 +29,9 @@ from logger_36.config.message import (
     LONG_ENOUGH,
     TIME_FORMAT,
 )
+from logger_36.constant.error import MEMORY_MEASURE_ERROR
 from logger_36.constant.generic import NOT_PASSED
-from logger_36.constant.handler import ANONYMOUS, HANDLER_KINDS, handler_codes_h
+from logger_36.constant.handler import HANDLER_KINDS, handler_codes_h
 from logger_36.constant.issue import ISSUE_LEVEL_SEPARATOR, ORDER, order_h
 from logger_36.constant.logger import (
     LOGGER_NAME,
@@ -39,14 +41,11 @@ from logger_36.constant.logger import (
 from logger_36.constant.memory import UNKNOWN_MEMORY_USAGE
 from logger_36.constant.message import LINE_INDENT, TIME_LENGTH_m_1, expected_op_h
 from logger_36.constant.path import PROJECT_FILE_RELATIVE
-from logger_36.constant.record import (
-    HIDE_WHERE_ATTR,
-    SHOW_W_RULE_ATTR,
-    STORE_MEMORY_ATTR,
-)
+from logger_36.constant.record import SHOW_W_RULE_ATTR, SHOW_WHERE_ATTR
 from logger_36.task.format.message import MessageFromRecord, MessageWithActualExpected
 from logger_36.task.format.rule import RuleAsText
 from logger_36.task.measure.chronos import ElapsedTime
+from logger_36.task.measure.memory import CanCheckUsage as CanCheckMemoryUsage
 from logger_36.task.measure.memory import CurrentUsage as CurrentMemoryUsage
 from logger_36.type.handler import any_handler_t as base_handler_t
 from logger_36.type.issue import NewIssue, issue_t
@@ -66,6 +65,7 @@ logger_handle_h = logger_handle_raw_h | logger_handle_with_self_h
 
 _DATE_TIME_ORIGIN = date_time_t.fromtimestamp(1970, None)
 _DATE_ORIGIN = _DATE_TIME_ORIGIN.date()
+_MEMORY_MEASURE_ERROR = MEMORY_MEASURE_ERROR
 
 
 @d.dataclass(slots=True, repr=False, eq=False)
@@ -85,6 +85,7 @@ class logger_t(base_t):
     """
 
     should_record_messages: bool = False
+    should_watch_memory_usage: bool = False
     exit_on_error: bool = False  # Implies exit_on_critical.
     exit_on_critical: bool = False
 
@@ -93,7 +94,6 @@ class logger_t(base_t):
 
     last_message_now: date_time_t = d.field(init=False, default=_DATE_TIME_ORIGIN)
     last_message_date: date_t = d.field(init=False, default=_DATE_ORIGIN)
-    any_handler_stores_memory: bool = d.field(init=False, default=False)
     memory_usages: list[tuple[str, int]] = d.field(init=False, default_factory=list)
     context_levels: list[str] = d.field(init=False, default_factory=list)
     staged_issues: list[issue_t] = d.field(init=False, default_factory=list)
@@ -159,6 +159,8 @@ class logger_t(base_t):
         activate_exc_interceptions: bool,
     ) -> None:
         """"""
+        global _MEMORY_MEASURE_ERROR
+
         base_t.__init__(self, name_)
         self.setLevel(level_)
         self.propagate = False  # Part of base_t.
@@ -178,6 +180,12 @@ class logger_t(base_t):
         if self.exit_on_error:
             self.exit_on_critical = True
 
+        if self.should_watch_memory_usage and not CanCheckMemoryUsage():
+            self.should_watch_memory_usage = False
+            if _MEMORY_MEASURE_ERROR is not None:
+                s.__stderr__.write(_MEMORY_MEASURE_ERROR + "\n")
+                _MEMORY_MEASURE_ERROR = None
+
     def handle(self, record: l.LogRecord, /) -> None:
         """"""
         elapsed_time, now = ElapsedTime(should_return_now=True)
@@ -224,12 +232,8 @@ class logger_t(base_t):
         self.last_message_now = now
 
         # Where.
-        # Memory usage is also stored if there are no handlers yet, just in case.
-        should_store_where = self.any_handler_stores_memory or not self.hasHandlers()
-        should_show_where = (record.levelno != l.INFO) and not hasattr(
-            record, HIDE_WHERE_ATTR
-        )
-        if should_store_where or should_show_where:
+        should_show_where = getattr(record, SHOW_WHERE_ATTR, record.levelno != l.INFO)
+        if should_show_where or self.should_watch_memory_usage:
             module = path_t(record.pathname)
             for path in s.path:
                 if module.is_relative_to(path):
@@ -269,7 +273,7 @@ class logger_t(base_t):
 
         self.events[record.levelno] += 1
 
-        if should_store_where:
+        if self.should_watch_memory_usage:
             self.memory_usages.append((where, CurrentMemoryUsage()))
 
     def SetLevel(self, level: int, /, *, which: handler_codes_h | str = "a") -> None:
@@ -417,7 +421,6 @@ class logger_t(base_t):
         *,
         name: str | None = None,
         level: int = l.INFO,
-        should_store_memory_usage: bool = False,
         message_width: int = -1,
         formatter: l.Formatter | None = None,
         should_still_hold_messages: bool = False,
@@ -429,9 +432,9 @@ class logger_t(base_t):
             self._should_activate_log_interceptions = False
 
         self._should_hold_messages = should_still_hold_messages
+
         handler = handler_t.New(
             name=name,
-            should_store_memory_usage=should_store_memory_usage,
             message_width=message_width,
             level=level,
             formatter=formatter,
@@ -439,31 +442,26 @@ class logger_t(base_t):
         )
         base_t.addHandler(self, handler)
 
-        extension = getattr(handler, "extension", None)
-        if extension is None:
-            name = handler.name
-            if (name is None) or (name.__len__() == 0):
-                name = ANONYMOUS
-        else:
-            name = getattr(extension, "name", ANONYMOUS)
-            if getattr(extension, STORE_MEMORY_ATTR, False):
-                self.any_handler_stores_memory = True
-
         path = getattr(handler, "baseFilename", "")
         if isinstance(path, path_t) or (path.__len__() > 0):
             path = f"\nPath: {path}"
-
         self.info(
-            f'New handler "{name}" of type "{type(handler).__name__}" and '
+            f'New handler "{handler.name}" of type "{type(handler).__name__}" and '
             f"level {handler.level}={l.getLevelName(handler.level)}{path}"
         )
 
     def __call__(self, *args, **kwargs) -> None:
         """
-        For a print-like calling.
+        For a print-like calling for print-based debugging.
         """
+        frame = e.stack(context=0)[1][0]  # 1=caller.
+        details = e.getframeinfo(frame, context=0)
+        path = path_t(details.filename).relative_to(path_t.home())
+        where = f"{str(path)[:-3]}.{details.function}.{details.lineno}"
+
         separator = kwargs.get("separator", " ")
-        self.info(separator.join(map(str, args)))
+
+        self.info(where + "\n" + separator.join(map(str, args)))
 
     def Log(
         self,
@@ -510,7 +508,7 @@ class logger_t(base_t):
             #     - Why adding exception name here and not when removing caller?
             formatted = "".join(lines)
             message = f"Exception of type {type(exception).__name__}\n----\n{formatted}"
-        self.log(level, message, extra={HIDE_WHERE_ATTR: None})
+        self.log(level, message, extra={SHOW_WHERE_ATTR: False})
 
     def LogAsIs(self, message: str, /, *, indented: bool = False) -> None:
         """"""
@@ -624,7 +622,7 @@ class logger_t(base_t):
             formatted = "\n".join(lines)
         """
 
-        hide_where = {HIDE_WHERE_ATTR: None}
+        hide_where = {SHOW_WHERE_ATTR: False}
         if unified:
             level, _ = issues[0].split(ISSUE_LEVEL_SEPARATOR, maxsplit=1)
             wo_level = []

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36/version.py

@@ -4,7 +4,7 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-__version__ = "2025.16"
+__version__ = "2025.17"
 
 """
 COPYRIGHT NOTICE

{logger_36-2025.16 → logger_36-2025.17}/package/logger_36.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logger-36
-Version: 2025.16
+Version: 2025.17
 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.16/package/logger_36/constant/record.py

@@ -1,55 +0,0 @@
-"""
-Copyright CNRS/Inria/UniCA
-Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
-SEE COPYRIGHT NOTICE BELOW
-"""
-
-SHOW_W_RULE_ATTR = "should_show_w_rule"
-STORE_MEMORY_ATTR = "should_store_memory_usage"
-HIDE_WHERE_ATTR = "should_hide_where"
-
-"""
-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/
-"""