logger-36 2025.15__py3-none-any.whl → 2025.16__py3-none-any.whl

logger_36/type/logger.py

@@ -8,6 +8,7 @@ import dataclasses as d
 import logging as l
 import sys as s
 import textwrap as text
+import threading as thrd
 import traceback as tcbk
 import types as t
 import typing as h
@@ -43,7 +44,6 @@ from logger_36.constant.record import (
     SHOW_W_RULE_ATTR,
     STORE_MEMORY_ATTR,
 )
-from logger_36.extension.exception import OverrideExceptionFormat
 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
@@ -101,6 +101,7 @@ class logger_t(base_t):
     intercepted_log_handles: dict[str, logger_handle_h] = d.field(
         init=False, default_factory=dict
     )
+    intercepts_exceptions: bool = d.field(init=False, default=False)
     _on_hold: list[l.LogRecord] = d.field(init=False, default_factory=list)
     _should_hold_messages: bool = d.field(init=False, default=True)
     _should_activate_log_interceptions: bool = d.field(init=False, default=False)
@@ -109,6 +110,7 @@ class logger_t(base_t):
     level_: d.InitVar[int] = l.NOTSET
     activate_wrn_interceptions: d.InitVar[bool] = True
     activate_log_interceptions: d.InitVar[bool] = True
+    activate_exc_interceptions: d.InitVar[bool] = True
 
     @property
     def intercepts_warnings(self) -> bool:
@@ -154,6 +156,7 @@ class logger_t(base_t):
         level_: int,
         activate_wrn_interceptions: bool,
         activate_log_interceptions: bool,
+        activate_exc_interceptions: bool,
     ) -> None:
         """"""
         base_t.__init__(self, name_)
@@ -169,6 +172,8 @@ class logger_t(base_t):
             self.ToggleWarningInterceptions(True)
         if activate_log_interceptions:
             self._should_activate_log_interceptions = True
+        if activate_exc_interceptions:
+            self.ToggleExceptionInterceptions(True)
 
         if self.exit_on_error:
             self.exit_on_critical = True
@@ -296,7 +301,6 @@ class logger_t(base_t):
 
     def MakeMonochrome(self) -> None:
         """"""
-        OverrideExceptionFormat()
         self.AddHandler(console_handler_t)
 
     def MakeRich(self, *, alternating_logs: int = 0) -> None:
@@ -304,7 +308,6 @@ class logger_t(base_t):
         if MISSING_RICH_MESSAGE is not None:
             s.__stderr__.write(MISSING_RICH_MESSAGE + "\n")
 
-        OverrideExceptionFormat()
         if console_rich_handler_t is console_handler_t:
             handler_kwargs = {}
         else:
@@ -313,7 +316,6 @@ class logger_t(base_t):
 
     def MakePermanent(self, path: str | path_t, /) -> None:
         """"""
-        OverrideExceptionFormat()
         self.AddHandler(file_handler_t, path=path)
 
     def ResetEventCounts(self) -> None:
@@ -377,6 +379,37 @@ class logger_t(base_t):
             self.intercepted_log_handles.clear()
             self.info("Log Interception: OFF")
 
+    def ToggleExceptionInterceptions(self, state: bool, /) -> None:
+        """"""
+        if state:
+            if self.intercepts_exceptions:
+                return
+
+            s.excepthook = self.DealWithException
+            thrd.excepthook = self.DealWithExceptionInThread
+            self.intercepts_exceptions = True
+            self.info("Exception Interception: ON")
+        else:
+            if not self.intercepts_exceptions:
+                return
+
+            s.excepthook = s.__excepthook__
+            thrd.excepthook = thrd.__excepthook__
+            self.intercepts_exceptions = False
+            self.info("Exception Interception: OFF")
+
+    def DealWithException(self, _, exc_value, exc_traceback, /) -> None:
+        """"""
+        exception = exc_value.with_traceback(exc_traceback)
+        self.LogException(exception, level=l.CRITICAL)
+        s.exit(1)
+
+    def DealWithExceptionInThread(
+        self, exc_type, exc_value, exc_traceback, _, /
+    ) -> None:
+        """"""
+        self.DealWithException(exc_type, exc_value, exc_traceback)
+
     def AddHandler(
         self,
         handler_t: type[base_handler_t],
@@ -476,8 +509,8 @@ class logger_t(base_t):
             #     - Why it's not: "\n".join(lines)?
             #     - Why adding exception name here and not when removing caller?
             formatted = "".join(lines)
-            message = f"{type(exception).__name__}:\n{formatted}"
-        self.log(level, message)
+            message = f"Exception of type {type(exception).__name__}\n----\n{formatted}"
+        self.log(level, message, extra={HIDE_WHERE_ATTR: None})
 
     def LogAsIs(self, message: str, /, *, indented: bool = False) -> None:
         """"""

logger_36/type/loggers.py

@@ -5,8 +5,10 @@ SEE COPYRIGHT NOTICE BELOW
 """
 
 import dataclasses as d
+import logging as l
 import typing as h
 
+from logger_36.constant.logger import LOGGER_NAME
 from logger_36.type.logger import logger_t
 
 
@@ -14,9 +16,32 @@ from logger_36.type.logger import logger_t
 class loggers_t(dict[h.Hashable, logger_t]):
     active: logger_t | None = d.field(init=False, default=None)
 
-    def AddNew(self, uid: h.Hashable, /) -> None:
+    def AddNew(
+        self,
+        uid: h.Hashable,
+        /,
+        *,
+        name: str = LOGGER_NAME,
+        level: int = l.NOTSET,
+        should_record_messages: bool = False,
+        exit_on_error: bool = False,
+        exit_on_critical: bool = False,
+        activate_wrn_interceptions: bool = True,
+        activate_log_interceptions: bool = True,
+        activate_exc_interceptions: bool = True,
+    ) -> None:
         """"""
-        self.Add(uid, logger_t())
+        logger = logger_t(
+            should_record_messages=should_record_messages,
+            exit_on_error=exit_on_error,
+            exit_on_critical=exit_on_critical,
+            name_=name,
+            level_=level,
+            activate_wrn_interceptions=activate_wrn_interceptions,
+            activate_log_interceptions=activate_log_interceptions,
+            activate_exc_interceptions=activate_exc_interceptions,
+        )
+        self.Add(uid, logger)
 
     def Add(self, uid: h.Hashable, logger: logger_t, /) -> None:
         """"""

logger_36/version.py

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

{logger_36-2025.15.dist-info → logger_36-2025.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logger-36
-Version: 2025.15
+Version: 2025.16
 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.15.dist-info → logger_36-2025.16.dist-info}/RECORD

@@ -1,7 +1,6 @@
 logger_36/__init__.py,sha256=UhKxuQLS1Pfgt5H0K_7BaDAPejOUR8byD5BYRCnHQMQ,2655
-logger_36/version.py,sha256=oFhR-WWJSP1I096JdyMWykVW-yQE68ygNDxM43rM030,2206
+logger_36/version.py,sha256=vxBUi_PLey0-7pBB4KEVJ1RP-m_hqLO7B8S6ifB0twk,2206
 logger_36/api/content.py,sha256=clHYYUKa8n4qef6PVlUV4mFHRRf6fnm9wEd2fu9oagA,2381
-logger_36/api/exception.py,sha256=QKIkNJA0N6FvVHLTApiH3ymhVQoSYU08t2RkyufQPIw,2291
 logger_36/api/gpu.py,sha256=BOumedCAPWvCo7J-KJ3XE-jr5S0KSmgcFv_S4QKRPO8,2252
 logger_36/api/memory.py,sha256=szJVk4UTXsbYv3B-W9LFttf1F3j86GXHsKgEUOsXKl4,2743
 logger_36/api/storage.py,sha256=t83D7Ge0ka7FCHUM8xchLsO_TMu0Bcc2IcBzw_gjkSA,2300
@@ -33,7 +32,6 @@ logger_36/constant/message.py,sha256=Ys_CAyhENlT8Z3rr-AxO4hjdl1jLsKzVSPQ8wqLOCPQ
 logger_36/constant/path.py,sha256=fKJn2vGj012BU5DFRetDFus_tKMty2q_WL0J2KrXdCo,2731
 logger_36/constant/record.py,sha256=9Q28lVH_s0og4v74delgwIPAJ9G28I5rBM-brXcoY80,2308
 logger_36/constant/system.py,sha256=G2mzBTxRXoJMxb53TnmBaceMJC_q3WonoCG7y6nC_R8,2430
-logger_36/extension/exception.py,sha256=CPie_jbp_cPhYln0dECFplykmS7pUaHqiiuQ4M5lvho,5416
 logger_36/extension/html_.py,sha256=J9EX8-Rotq9i8bZ9U-dIpXv5gKLLnLmWqdDy4XayT1Q,3868
 logger_36/extension/line.py,sha256=3MJ3B5PXJn18RHxBUcWnNBLEYzb7VTcEAufn7ULdYfY,3143
 logger_36/instance/logger.py,sha256=oTw5svRzKRJKvGrrZUtutJIOjp5UISft3fl0Ze7DOBE,2241
@@ -47,10 +45,10 @@ logger_36/task/measure/chronos.py,sha256=1kVhu6jZlNAtNWQQh8ZVuRwZIAC9gGz3_ul1tn0
 logger_36/task/measure/memory.py,sha256=OjU5EYFH8SnzlCQKAoiXvauUlwQYOrH34jFXTVYF0jE,2517
 logger_36/type/handler.py,sha256=2Q3crkhIzMLyuT7pBtpmouXgKWbULdsYw8vxQZBCT2g,6637
 logger_36/type/issue.py,sha256=2rGsFqaQJCbeml9xN08mN_nK79L8qscaS_0ws36Y0bI,3214
-logger_36/type/logger.py,sha256=X2qax6gPcT6lPsfNKM2aL5yHb_RUtIGJPWJ_GBxKSTU,25021
-logger_36/type/loggers.py,sha256=znqxWBnfQxvkg3VUfbTUvt3S6Kq0DAzWWepxQDt9suI,2871
+logger_36/type/logger.py,sha256=86G05pa2_N9M1Vfck5NIBwn_LJhwf2W485Tc6sm5GSw,26256
+logger_36/type/loggers.py,sha256=KLPoZ8UtQNhUw6MVu2pBcbSsIMKzgTaoxCulS1z2zPU,3748
 logger_36/type/message.py,sha256=zKME5p87ynsXte_b5usXV3VHaj34Uezs9Gg_WVWfaeY,3063
-logger_36-2025.15.dist-info/METADATA,sha256=wKz-PcmHE1ZvHLy4gj6pLm-2CcY_F2t8wE14ZbYGxsw,6506
-logger_36-2025.15.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-logger_36-2025.15.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
-logger_36-2025.15.dist-info/RECORD,,
+logger_36-2025.16.dist-info/METADATA,sha256=S9Dh7TabMHK2y5K4psh0RvRiDHfcJiTjjYZKBGnvcCA,6506
+logger_36-2025.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+logger_36-2025.16.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
+logger_36-2025.16.dist-info/RECORD,,

logger_36/api/exception.py

@@ -1,56 +0,0 @@
-"""
-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/extension/exception.py

@@ -1,162 +0,0 @@
-"""
-Copyright CNRS/Inria/UniCA
-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 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:
-    """"""
-    s.excepthook = _HandleException
-
-
-def ResetExceptionFormat() -> None:
-    """"""
-    s.excepthook = _ORIGINAL_EXCEPTION_HANDLER
-
-
-def _HandleException(
-    stripe: type[Exception], exception: Exception, trace: t.TracebackType, /
-) -> None:
-    """"""
-    while trace.tb_next is not None:
-        trace = trace.tb_next
-    frame = trace.tb_frame
-    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 = (
-                2 * _INDENTATION + f"\n{2 * _INDENTATION}".join(variables) + "\n"
-            )
-        else:
-            variables = ""
-
-        line_content = f"{_INDENTATION}{line_content}\n"
-
-    # Format message.
-    message = str(exception).strip()
-    if message.__len__() > 0:
-        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)
-
-    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"{_INDENTATION}{REPORT_COLOR}Full report at: file://{document.name}"
-        f"{MONOCHROME}{OPTIONAL_NEWLINE}"
-    )
-
-    lines = tcbk.format_exception(exception)
-    message = "".join(lines)
-
-    document.write(message.encode())
-    document.close()
-
-
-"""
-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/
-"""