logger-36 2025.10__tar.gz → 2025.12__tar.gz

{logger_36-2025.10 → logger_36-2025.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: logger-36
-Version: 2025.10
+Version: 2025.12
 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.10 → logger_36-2025.12}/package/logger_36/__init__.py

@@ -12,9 +12,12 @@ 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:
+    paths = site.getsitepackages() + [site.getusersitepackages()]
+    for path in paths:
+        if folder.is_relative_to(path):
+            break
+    else:
         beartype_this_package()
 
 from logger_36.instance.logger import L

logger_36-2025.12/package/logger_36/api/exception.py

@@ -0,0 +1,56 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from logger_36.extension.exception import (  # noqa
+    OverrideExceptionFormat,
+    ResetExceptionFormat,
+)
+
+"""
+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.12/package/logger_36/api/handler.py

@@ -0,0 +1,58 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from logger_36.task.handling import (  # noqa
+    AddConsoleHandler,
+    AddFileHandler,
+    AddGenericHandler,
+    AddRichConsoleHandler,
+)
+
+"""
+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.10 → logger_36-2025.12}/package/logger_36/api/storage.py

@@ -5,6 +5,7 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 from logger_36.extension.html_ import html_content_t  # noqa
+from logger_36.task.storage import SaveLOGasHTML  # noqa
 
 """
 COPYRIGHT NOTICE

logger_36-2025.10/package/logger_36/api/logger.py → logger_36-2025.12/package/logger_36/api/type.py

@@ -5,6 +5,7 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 from logger_36.type.logger import logger_t  # noqa
+from logger_36.type.loggers import loggers_t  # noqa
 
 """
 COPYRIGHT NOTICE

{logger_36-2025.10/package/logger_36 → logger_36-2025.12/package/logger_36/extension}/exception.py

@@ -7,13 +7,29 @@ SEE COPYRIGHT NOTICE BELOW
 import re as r
 import sys as s
 import tempfile as tmpf
+import textwrap as text
 import traceback as tcbk
 import types as t
 from pathlib import Path as path_t
 
+from logger_36.catalog.config.optional import RICH_IS_AVAILABLE
 from logger_36.constant.path import USER_FOLDER
 
 _ORIGINAL_EXCEPTION_HANDLER = s.excepthook
+_INDENTATION = "    "
+
+if RICH_IS_AVAILABLE:
+    from rich import print as ShowErrorMessage  # noqa
+
+    TITLE_COLOR = "[red]"
+    FUNCTION_COLOR = "[cyan]"
+    REPORT_COLOR = "[red]"
+    MONOCHROME = "[/]"
+    OPTIONAL_NEWLINE = ""
+else:
+    ShowErrorMessage = s.__stderr__.write
+    TITLE_COLOR = WHERE_COLOR = REPORT_COLOR = MONOCHROME = ""
+    OPTIONAL_NEWLINE = "\n"
 
 
 def OverrideExceptionFormat() -> None:
@@ -63,26 +79,31 @@ def _HandleException(
             variables = map(
                 lambda _: f"{_:{longest}} = {all_variables[_]}", sorted(found_names)
             )
-            variables = "        " + "\n        ".join(variables) + "\n"
+            variables = 2 * _INDENTATION + f"\n{2*_INDENTATION}".join(variables) + "\n"
         else:
             variables = ""
 
-        line_content = f"    {line_content}\n"
+        line_content = f"{_INDENTATION}{line_content}\n"
 
     # Format message.
     message = str(exception).strip()
     if message.__len__() > 0:
-        message = f"    {message[0].title()}{message[1:]}\n"
+        if "\n" in message:
+            message = text.indent(message, 2 * _INDENTATION)[
+                (2 * _INDENTATION.__len__()) :
+            ]
+        message = f"{_INDENTATION}{message[0].title()}{message[1:]}\n"
 
     document = tmpf.NamedTemporaryFile(delete=False)
 
-    s.__stderr__.write(
-        f"{stripe.__name__}\n"
-        f"    {module}:{function}@{line_number}\n"
+    ShowErrorMessage(
+        f"{TITLE_COLOR}{stripe.__name__}{MONOCHROME}\n"
+        f"{_INDENTATION}{module}:{FUNCTION_COLOR}{function}{MONOCHROME}@{line_number}\n"
         f"{line_content}"
         f"{variables}"
         f"{message}"
-        f"    Full report at: {document.name}\n",
+        f"{_INDENTATION}{REPORT_COLOR}Full report at: file://{document.name}"
+        f"{MONOCHROME}{OPTIONAL_NEWLINE}",
     )
 
     lines = tcbk.format_exception(exception)

{logger_36-2025.10 → logger_36-2025.12}/package/logger_36/task/format/message.py

@@ -39,7 +39,12 @@ def MessageWithActualExpected(
     else:
         dot = ""
 
-    return f"{message}: Actual={actual}:{type(actual).__name__}; {expected}{dot}"
+    if isinstance(actual, type):
+        actual = actual.__name__
+    else:
+        actual = f"{actual}:{type(actual).__name__}"
+
+    return f"{message}: Actual={actual}; {expected}{dot}"
 
 
 def _FormattedExpected(
@@ -54,14 +59,17 @@ def _FormattedExpected(
         else:
             expected = ", ".join(map(str, expected))
             return f"Valid values: {expected}"
+
+    if isinstance(expected, type):
+        return f"Expected{operator}{expected.__name__}"
+
+    if operator == "=":
+        stripe = f":{type(expected).__name__}"
     else:
-        if operator == "=":
-            stripe = f":{type(expected).__name__}"
-        else:
-            stripe = ""
-            if operator == ":":
-                operator = ": "
-        return f"Expected{operator}{expected}{stripe}"
+        stripe = ""
+        if operator == ":":
+            operator = ": "
+    return f"Expected{operator}{expected}{stripe}"
 
 
 """

{logger_36-2025.10 → logger_36-2025.12}/package/logger_36/type/logger.py

@@ -40,10 +40,14 @@ from logger_36.constant.record import (
     SHOW_W_RULE_ATTR,
     STORE_MEMORY_ATTR,
 )
-from logger_36.exception import OverrideExceptionFormat
-from logger_36.handler import AddConsoleHandler, AddFileHandler, AddRichConsoleHandler
+from logger_36.extension.exception import OverrideExceptionFormat
 from logger_36.task.format.message import MessageWithActualExpected
 from logger_36.task.format.rule import RuleAsText
+from logger_36.task.handling import (
+    AddConsoleHandler,
+    AddFileHandler,
+    AddRichConsoleHandler,
+)
 from logger_36.task.measure.chronos import ElapsedTime
 from logger_36.task.measure.memory import CurrentUsage as CurrentMemoryUsage
 from logger_36.type.issue import NewIssue, issue_t
@@ -111,6 +115,11 @@ class logger_t(base_t):
         """"""
         return self.staged_issues.__len__() > 0
 
+    @property
+    def n_staged_issues(self) -> int:
+        """"""
+        return self.staged_issues.__len__()
+
     @property
     def past_logs_as_HTML(self) -> str | None:
         """
@@ -497,6 +506,27 @@ class logger_t(base_t):
         )
         self.staged_issues.append(issue)
 
+    def PopIssues(self, /, *, should_remove_context: bool = False) -> list[str]:
+        """"""
+        if not self.has_staged_issues:
+            return []
+
+        output = []
+
+        if should_remove_context:
+            separator = ISSUE_CONTEXT_END
+        else:
+            separator = ISSUE_LEVEL_SEPARATOR
+        separator_length = separator.__len__()
+        for issue in self.staged_issues:
+            start_idx = issue.find(separator)
+            issue = issue[(start_idx + separator_length) :]
+            output.append(issue)
+
+        self.staged_issues.clear()
+
+        return output
+
     def CommitIssues(
         self,
         /,

{logger_36-2025.10 → logger_36-2025.12}/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.10"
+__version__ = "2025.12"
 
 """
 COPYRIGHT NOTICE

{logger_36-2025.10 → logger_36-2025.12}/package/logger_36.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: logger-36
-Version: 2025.10
+Version: 2025.12
 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.10 → logger_36-2025.12}/package/logger_36.egg-info/SOURCES.txt

@@ -6,21 +6,20 @@ pyproject.toml
 setup.py
 documentation/wiki/description.asciidoc
 package/logger_36/__init__.py
-package/logger_36/content.py
-package/logger_36/exception.py
-package/logger_36/gpu.py
-package/logger_36/handler.py
-package/logger_36/memory.py
-package/logger_36/storage.py
-package/logger_36/system.py
-package/logger_36/time.py
 package/logger_36/version.py
 package/logger_36.egg-info/PKG-INFO
 package/logger_36.egg-info/SOURCES.txt
 package/logger_36.egg-info/dependency_links.txt
 package/logger_36.egg-info/top_level.txt
-package/logger_36/api/logger.py
+package/logger_36/api/content.py
+package/logger_36/api/exception.py
+package/logger_36/api/gpu.py
+package/logger_36/api/handler.py
+package/logger_36/api/memory.py
 package/logger_36/api/storage.py
+package/logger_36/api/system.py
+package/logger_36/api/time.py
+package/logger_36/api/type.py
 package/logger_36/catalog/config/console_rich.py
 package/logger_36/catalog/config/optional.py
 package/logger_36/catalog/handler/console.py
@@ -45,9 +44,11 @@ package/logger_36/constant/message.py
 package/logger_36/constant/path.py
 package/logger_36/constant/record.py
 package/logger_36/constant/system.py
+package/logger_36/extension/exception.py
 package/logger_36/extension/html_.py
 package/logger_36/instance/logger.py
 package/logger_36/instance/loggers.py
+package/logger_36/task/handling.py
 package/logger_36/task/inspection.py
 package/logger_36/task/storage.py
 package/logger_36/task/format/memory.py

logger_36-2025.10/package/logger_36/storage.py

@@ -1,53 +0,0 @@
-"""
-Copyright CNRS/Inria/UniCA
-Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
-SEE COPYRIGHT NOTICE BELOW
-"""
-
-from logger_36.task.storage import SaveLOGasHTML  # 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.
-
-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/
-"""