logger-36 2024.20__py3-none-any.whl → 2024.22__py3-none-any.whl

logger_36/catalog/handler/console.py

@@ -58,7 +58,10 @@ class console_handler_t(lggg.Handler):
         print(message)
 
     def ShowMessage(self, message: str, /) -> None:
-        """"""
+        """
+        See documentation of
+        logger_36.catalog.handler.generic.generic_handler_t.ShowMessage.
+        """
         print(message)
 
 

logger_36/catalog/handler/console_rich.py

@@ -155,7 +155,10 @@ class console_rich_handler_t(lggg.Handler):
         self.console.print(richer, crop=False, overflow="ignore")
 
     def ShowMessage(self, message: str, /) -> None:
-        """"""
+        """
+        See documentation of
+        logger_36.catalog.handler.generic.generic_handler_t.ShowMessage.
+        """
         self.console.print(message, crop=False, overflow="ignore")
 
 

logger_36/catalog/handler/file.py

@@ -68,7 +68,10 @@ class file_handler_t(lggg.FileHandler):
         self.stream.flush()
 
     def ShowMessage(self, message: str, /) -> None:
-        """"""
+        """
+        See documentation of
+        logger_36.catalog.handler.generic.generic_handler_t.ShowMessage.
+        """
         print(message, file=self.stream)
         self.stream.flush()
 

logger_36/catalog/handler/generic.py

@@ -23,31 +23,35 @@ from logger_36.task.format.rule import Rule, RuleAsText
 from logger_36.type.handler import handler_extension_t
 
 
-class can_show_message_p(h.Protocol):
-    def ShowMessage(self, message: str, /) -> None: ...
-
-
-interface_h = can_show_message_p | h.Callable[[str], None]
-
-
 @d.dataclass(slots=True, repr=False, eq=False)
 class generic_handler_t(lggg.Handler):
     """
     alternating_lines:
-    - Initial value:
-        - 1: enabled for dark background
-        - 2: enabled for light background
-        - anything else: disabled
-    - Runtime value: 0/1=do not/do highlight next time.
+        - Initial value:
+            - 1: enabled for dark background
+            - 2: enabled for light background
+            - anything else: disabled
+        - Runtime value: 0/1=do not/do highlight next time.
+
+    ShowMessage:
+        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
+        duplication, but it avoids a (maybe negligible) slowing down that would arise
+        from calling this method at the end of the emit methods.
+        Here, since, by definition, the generic handler does not know how to output
+        messages, it is a callable attribute that must be set at instantiation time, and
+        it is indeed called at the end of the emit method.
     """
 
-    extension: handler_extension_t = d.field(init=False)
+    ShowMessage: h.Callable[[str], None]
     console: console_t = None
     console_options: console_options_t = None
-    FormattedLines: h.Callable[..., tuple[str, str | None]] = d.field(init=False)
     alternating_lines: int = 0
     background_is_light: bool = True
-    ShowMessage: h.Callable[[str], None] = lambda _arg: None
+
+    extension: handler_extension_t = d.field(init=False)
+    FormattedLines: h.Callable[..., tuple[str, str | None]] = d.field(init=False)
 
     name: d.InitVar[str | None] = None
     level: d.InitVar[int] = lggg.NOTSET
@@ -59,7 +63,6 @@ class generic_handler_t(lggg.Handler):
     supports_html: d.InitVar[bool] = False
     should_record: d.InitVar[bool] = False
     rich_kwargs: d.InitVar[dict[str, h.Any] | None] = None
-    interface: d.InitVar[interface_h | None] = None  # Cannot be None actually.
 
     def __post_init__(
         self,
@@ -72,7 +75,6 @@ class generic_handler_t(lggg.Handler):
         supports_html: bool,
         should_record: bool,
         rich_kwargs: dict[str, h.Any] | None,
-        interface: interface_h | None,
     ) -> None:
         """"""
         lggg.Handler.__init__(self)
@@ -110,10 +112,6 @@ class generic_handler_t(lggg.Handler):
         else:
             self.alternating_lines = -1
 
-        self.ShowMessage = getattr(
-            interface, can_show_message_p.ShowMessage.__name__, interface
-        )
-
     def emit(self, record: lggg.LogRecord, /) -> None:
         """"""
         if self.console is None:

logger_36/constant/issue.py

@@ -9,6 +9,8 @@ import typing as h
 order_h = h.Literal["when", "context"]
 ORDER: tuple[str, ...] = h.get_args(order_h)
 
+ISSUE_LEVEL_SEPARATOR = "#"
+
 """
 COPYRIGHT NOTICE
 

logger_36/handler.py

@@ -6,11 +6,12 @@ SEE COPYRIGHT NOTICE BELOW
 
 import logging as lggg
 import sys as sstm
+import typing as h
 from pathlib import Path as path_t
 
 from logger_36.catalog.handler.console import console_handler_t
 from logger_36.catalog.handler.file import file_handler_t
-from logger_36.catalog.handler.generic import generic_handler_t, interface_h
+from logger_36.catalog.handler.generic import generic_handler_t
 from logger_36.constant.error import MISSING_RICH_ERROR
 from logger_36.instance.logger import LOGGER
 
@@ -27,7 +28,7 @@ except ModuleNotFoundError:
 
 
 def AddGenericHandler(
-    interface: interface_h,
+    ShowMessage: h.Callable[[str], None],
     /,
     *,
     logger: lggg.Logger | None = None,
@@ -58,7 +59,7 @@ def AddGenericHandler(
         alternating_lines=alternating_lines,
         should_record=should_record,
         rich_kwargs=kwargs,
-        interface=interface,
+        ShowMessage=ShowMessage,
     )
     logger.AddHandler(handler, should_hold_messages)
 

logger_36/type/issue.py

@@ -4,10 +4,12 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
+import logging as lggg
 import typing as h
 
 from logger_36.config.issue import ISSUE_BASE_CONTEXT
 from logger_36.constant.generic import NOT_PASSED
+from logger_36.constant.issue import ISSUE_LEVEL_SEPARATOR
 from logger_36.constant.message import expected_op_h
 from logger_36.task.format.message import FormattedMessage
 
@@ -20,6 +22,7 @@ def NewIssue(
     message: str,
     /,
     *,
+    level: int = lggg.ERROR,
     actual: h.Any = NOT_PASSED,
     expected: h.Any | None = None,
     expected_op: expected_op_h = "=",
@@ -36,7 +39,7 @@ def NewIssue(
         with_final_dot=with_final_dot,
     )
 
-    return f"{context}{separator}{message}"
+    return f"{level}{ISSUE_LEVEL_SEPARATOR}{context}{separator}{message}"
 
 
 """

logger_36/type/logger.py

@@ -17,7 +17,7 @@ from traceback import TracebackException as traceback_t
 from logger_36.config.issue import ISSUE_CONTEXT_END, ISSUE_CONTEXT_SEPARATOR
 from logger_36.config.message import DATE_FORMAT
 from logger_36.constant.generic import NOT_PASSED
-from logger_36.constant.issue import ORDER, order_h
+from logger_36.constant.issue import ISSUE_LEVEL_SEPARATOR, ORDER, order_h
 from logger_36.constant.logger import (
     HIDE_WHERE_KWARG,
     LOGGER_NAME,
@@ -221,11 +221,12 @@ class logger_t(lggg.Logger):
             # __post_init__ set self.exit_on_critical if self.exit_on_error.
             sstm.exit(1)
 
-    def error_for_exception(
+    def log_exception(
         self,
         exception: Exception,
         /,
         *,
+        level: int = lggg.ERROR,
         should_remove_caller: bool = False,
     ) -> None:
         """"""
@@ -233,9 +234,12 @@ class logger_t(lggg.Logger):
         if should_remove_caller:
             message = "\n".join(lines[:1] + lines[2:])
         else:
+            # TODO: Explain:
+            #     - Why it's not: "\n".join(lines)?
+            #     - Why adding excpetion name here and not when removing caller?
             formatted = "".join(lines)
             message = f"{type(exception).__name__}:\n{formatted}"
-        self.error(message)
+        self.log(level, message)
 
     def AddContextLevel(self, new_level: str, /) -> None:
         """"""
@@ -255,6 +259,7 @@ class logger_t(lggg.Logger):
         message: str,
         /,
         *,
+        level: int = lggg.ERROR,
         actual: h.Any = NOT_PASSED,
         expected: h.Any | None = None,
         expected_op: expected_op_h = "=",
@@ -266,6 +271,7 @@ class logger_t(lggg.Logger):
             context,
             ISSUE_CONTEXT_END,
             message,
+            level=level,
             actual=actual,
             expected=expected,
             expected_op=expected_op,
@@ -280,12 +286,15 @@ class logger_t(lggg.Logger):
 
     def CommitIssues(
         self,
-        level: int | type[Exception],
         /,
         *,
         order: order_h = "when",
+        unified: bool = False,
     ) -> None:
-        """"""
+        """
+        Note that issues after an issue with a level triggering process exit will not be
+        logged.
+        """
         if not self.has_staged_issues:
             return
 
@@ -302,26 +311,35 @@ class logger_t(lggg.Logger):
             issues = self.staged_issues
         else:  # order == "context"
             issues = sorted(self.staged_issues, key=lambda _elm: _elm.context)
-        issues = "\n".join(issues)
-
-        if isinstance(level, type) and issubclass(level, Exception):
-            try:
-                raise level("\n" + issues)
-            except Exception as exception:
-                lines = ["Traceback (most recent call last):"] + tcbk.format_stack()[
-                    :-1
-                ]
-                lines[-1] = lines[-1][:-1]
-                lines.extend(tcbk.format_exception_only(exception))
-                print("\n".join(lines), file=sstm.stderr)
-                sstm.exit(1)
-
-        level: int
-        self.log(level, issues, stacklevel=2)
+        """
+        Format issues as an exception:
+        try:
+            raise ValueError("\n" + "\n".join(issues))
+        except ValueError as exception:
+            lines = ["Traceback (most recent call last):"] + tcbk.format_stack()[:-1]
+            lines[-1] = lines[-1][:-1]
+            lines.extend(tcbk.format_exception_only(exception))
+            formatted = "\n".join(lines)
+        """
+
+        if unified:
+            level, _ = issues[0].split(ISSUE_LEVEL_SEPARATOR, maxsplit=1)
+            wo_level = []
+            for issue in issues:
+                _, issue = issue.split(ISSUE_LEVEL_SEPARATOR, maxsplit=1)
+                wo_level.append(issue)
+            self.log(int(level), "\n".join(wo_level), stacklevel=2)
+        else:
+            for issue in issues:
+                level, issue = issue.split(ISSUE_LEVEL_SEPARATOR, maxsplit=1)
+                self.log(int(level), issue, stacklevel=2)
         self.staged_issues.clear()
 
     def ShowMessage(self, message: str, /) -> None:
-        """"""
+        """
+        See documentation of
+        logger_36.catalog.handler.generic.generic_handler_t.ShowMessage.
+        """
         for handler in self.handlers:
             ShowMessage = getattr(handler, "ShowMessage", None)
             if ShowMessage is not None:

logger_36/version.py

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

{logger_36-2024.20.dist-info → logger_36-2024.22.dist-info}/METADATA

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

{logger_36-2024.20.dist-info → logger_36-2024.22.dist-info}/RECORD

@@ -1,16 +1,16 @@
 logger_36/__init__.py,sha256=jHidpp6dmfJVdoiHkwTXBn1_u1HRaZj3BHS8jq71ZOE,2312
 logger_36/format.py,sha256=mox36RRkNUWbeHo3XkGGlik2CoyswDvDehRDtZkrnD0,2558
-logger_36/handler.py,sha256=wHMj4OyQrUdhAxk_MCvPTBT1Ig3BYpfbqxHYfp91fOU,6697
+logger_36/handler.py,sha256=9KUu02RpKGKBR358gqS5G1Zut5C6MyBgGzRsQYFBAtY,6721
 logger_36/logger.py,sha256=7LJtdT7TmfFsn6r34iTr6OGvEjXlU6hKXEO2c5Lm2zY,2386
 logger_36/logger_gpu.py,sha256=YYFk6aYQrBDJfxQaDm-ar16T6SlOSL6jJWTOgvpF4EU,2244
 logger_36/measure.py,sha256=P507VNbVKAf4jYGnGX-3rlDrVbrYP0ZD3nxFmAFvhyI,2404
 logger_36/storage.py,sha256=O8pDmiL0B3LJpKrhi8a9IMBXs6MwW6r1bMUn_cSDAaY,2246
-logger_36/version.py,sha256=kB3U_JCF0IuEPCcFU8AehWEFC7kSh7E7ogHrmnWf-zY,2206
+logger_36/version.py,sha256=JPQbndmeGc-ytruoejhakNRfDt3ogZPJwu9ZkQINvwA,2206
 logger_36/catalog/config/console_rich.py,sha256=QDkgSs3I7ZULvkd1q4J1hdvgyB857JJcJWxM9fdL51Y,2883
-logger_36/catalog/handler/console.py,sha256=1WLtmxZCBj0AxLu5xey3VIVBKm02bp-Rc-eZOiFtXnU,3893
-logger_36/catalog/handler/console_rich.py,sha256=v57EFAvCaH5ABoZ24lFn1ObCe_EntHpqzW7RJLs6Lik,8681
-logger_36/catalog/handler/file.py,sha256=GS5nsfp0j0mzPak7vz8E7U4e5H95os_qfDjdM1Ywf0g,4345
-logger_36/catalog/handler/generic.py,sha256=93hiUjp0EsmH9M-kUHLKiFmvwSWTzb4JeYH-4T-6aT4,8123
+logger_36/catalog/handler/console.py,sha256=SF9S3CUoEPp5dh7RrqotywDJjMgRp0rD9sO3eLVXnkA,4004
+logger_36/catalog/handler/console_rich.py,sha256=Ti1k2E1ox4egzicghTb9Wv30xiWaBbWwe8ouopJsujY,8792
+logger_36/catalog/handler/file.py,sha256=z5ovaOxemh61pbWDCK2sMMlbd1TKwGjMiQhgoicilm4,4456
+logger_36/catalog/handler/generic.py,sha256=wG6Z1-lHj_9o6cPurEVpPctFlec3BFeqx2mZU_krJt8,8379
 logger_36/catalog/logger/chronos.py,sha256=eLqQw8N9vaGO23OCf5RrYDPbUeu7epUvDt9rH-dN7i0,2522
 logger_36/catalog/logger/gpu.py,sha256=vUFSP17e7U4nenMi5IMlDiP3cZvXe6nqEDpoqzTavdg,3490
 logger_36/catalog/logger/memory.py,sha256=Zel_UCnHqGAqf_YuKpvjt0OIOo9vwKYpFM9g_2bjir0,4790
@@ -23,7 +23,7 @@ logger_36/config/system.py,sha256=HD8ZuwsXhEAExeZrww8YoDkQGMs4T5RDqQMb1W4qVgc,24
 logger_36/constant/error.py,sha256=1gdnCwUu3d3ThL4AKxzjn7ijSTBWlr2g-8cAKbubl4A,2825
 logger_36/constant/generic.py,sha256=t6aRb66_NHwMhR1p7BZ4QXTU2jpLz-H5YAL4PuMtKx8,2244
 logger_36/constant/handler.py,sha256=HM8qCSEMGNMCzddjUUNBPGL-3d0qU-EmG5eW4ZQHW6A,2311
-logger_36/constant/issue.py,sha256=48c3QGNzgRcvQOenlp77_wAU4znZfLkQEdT2oE_CvMs,2286
+logger_36/constant/issue.py,sha256=01l8itRPWGS5F6gXtsXUJgGR-4lS1Eu3_YeKC-khKLw,2315
 logger_36/constant/logger.py,sha256=0GhemAQ_YBiRO5WQBuNTczuejyVu2IYCsgqPRIbL8es,2780
 logger_36/constant/memory.py,sha256=ZL1MwbdtNsrCrOwzEyfTsfOoOsRBTJtbbf3otHGnxXo,2343
 logger_36/constant/message.py,sha256=RKQL-YmEDds5q7HuHTeDebz7_h3zWDX0PNxu-RTwL2I,2714
@@ -39,10 +39,10 @@ logger_36/task/format/rule.py,sha256=YEe8wG_QLy9vRZqmT2bWlvKT-Dxp4pGaZVmEuwwODyE
 logger_36/task/measure/chronos.py,sha256=t-y0bVm1SmF-3wI9pR9Bp6-qzVlsE94fZTZr5a_hZUA,2884
 logger_36/task/measure/memory.py,sha256=eVw5WOYLyn8o4O4mMArdX2MzsVuhhNDovjYEkk-MIaU,2504
 logger_36/type/handler.py,sha256=BXpevZhLq5V_IdUfi_LZA4czzlH2SGLpgvbqUBe5X10,8311
-logger_36/type/issue.py,sha256=cB8pSSJg9aqFPQ6yJr4TC2kJbngKGK8Hyq4ATBm6jAc,2973
-logger_36/type/logger.py,sha256=qC2ThKusY4RKcmxxWaO2Pg3TTStUxpVe4AcSuQBdU04,15123
+logger_36/type/issue.py,sha256=5NCcDX8uTcp4Zd7HoRTYB2_f3RVjqHeDEavkssr6bg0,3114
+logger_36/type/logger.py,sha256=sH-eEEt3_kdYSTS4C3sLXA_pp-2MH-D_Bf6EDlJNY1E,15935
 logger_36/type/loggers.py,sha256=znqxWBnfQxvkg3VUfbTUvt3S6Kq0DAzWWepxQDt9suI,2871
-logger_36-2024.20.dist-info/METADATA,sha256=iyBqlOa3h_y5wyAOCzS8uLDNMgJo1DrFb88cOaPNm6Q,6276
-logger_36-2024.20.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-logger_36-2024.20.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
-logger_36-2024.20.dist-info/RECORD,,
+logger_36-2024.22.dist-info/METADATA,sha256=K5YZ0rA-ldUEqGnM3lMh09FzH9fmEY7gTZC7eWyTpcE,6276
+logger_36-2024.22.dist-info/WHEEL,sha256=cVxcB9AmuTcXqmwrtPhNK88dr7IR_b6qagTj0UvIEbY,91
+logger_36-2024.22.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
+logger_36-2024.22.dist-info/RECORD,,

{logger_36-2024.20.dist-info → logger_36-2024.22.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (74.1.2)
 Root-Is-Purelib: true
 Tag: py3-none-any