logger-36 2025.9__py3-none-any.whl → 2025.10__py3-none-any.whl

logger_36/catalog/handler/console_rich.py

@@ -48,21 +48,15 @@ class console_rich_handler_t(l.Handler):
     """
     kind: See logger_36.constant.handler.handler_codes_h.
 
-    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.
+    alternating_logs:
+    - 0: disabled
+    - 1: enabled for dark background
+    - 2: enabled for light background
     """
 
     kind: h.ClassVar[str] = "c"
 
-    extension: handler_extension_t = d.field(init=False)
-    console: console_t = d.field(init=False)
-    MessageFromRecord: MessageFromRecordPreprocessed_p = d.field(init=False)
-    alternating_lines: int = 0
-    background_is_light: bool = True
+    alternating_logs: int = 0
 
     name: d.InitVar[str | None] = None
     level: d.InitVar[int] = l.NOTSET
@@ -74,6 +68,11 @@ class console_rich_handler_t(l.Handler):
     should_record: d.InitVar[bool] = False
     rich_kwargs: d.InitVar[dict[str, h.Any] | None] = None
 
+    extension: handler_extension_t = d.field(init=False)
+    console: console_t = d.field(init=False)
+    MessageFromRecord: MessageFromRecordPreprocessed_p = d.field(init=False)
+    log_parity: bool = d.field(init=False, default=False)
+
     @property
     def past_logs_as_HTML(self) -> str | None:
         """"""
@@ -130,14 +129,7 @@ class console_rich_handler_t(l.Handler):
             InstallTracebackHandler(**rich_traceback_kwargs)
 
         self.MessageFromRecord = self.extension.MessageFromRecord
-        if self.alternating_lines == 1:
-            self.alternating_lines = 0
-            self.background_is_light = False
-        elif self.alternating_lines == 2:
-            self.alternating_lines = 0
-            self.background_is_light = True
-        else:
-            self.alternating_lines = -1
+        assert self.alternating_logs in (0, 1, 2)
 
     def emit(self, record: l.LogRecord, /) -> None:
         """"""
@@ -145,17 +137,15 @@ class console_rich_handler_t(l.Handler):
             richer = Rule(record.msg, DATE_TIME_COLOR)
         else:
             message = self.MessageFromRecord(record, PreProcessed=EscapedVersion)
-            should_highlight_back = self.alternating_lines == 1
-            if self.alternating_lines >= 0:
-                self.alternating_lines = (self.alternating_lines + 1) % 2
             richer = HighlightedVersion(
                 self.console,
                 message,
                 record.levelno,
-                should_highlight_back=should_highlight_back,
-                background_is_light=self.background_is_light,
+                self.alternating_logs,
+                self.log_parity,
             )
         self.console.print(richer, crop=False, overflow="ignore")
+        self.log_parity = not self.log_parity
 
     def LogAsIs(self, message: str | renderable_t, /) -> None:
         """
@@ -173,10 +163,9 @@ def HighlightedVersion(
     _: console_t,
     message: str,
     log_level: int,
+    alternating_logs: int,
+    should_tint_background: bool,
     /,
-    *,
-    should_highlight_back: bool = False,
-    background_is_light: bool = True,
 ) -> renderable_t:
     """"""
     output = text_t(message, WHITE_COLOR)
@@ -188,11 +177,11 @@ def HighlightedVersion(
     _ = output.highlight_words(ACTUAL_PATTERNS, style=ACTUAL_COLOR)
     _ = output.highlight_regex(EXPECTED_PATTERNS, style=EXPECTED_COLOR)
 
-    if should_highlight_back:
-        if background_is_light:
-            style = ALTERNATIVE_BACKGROUND_FOR_LIGHT
-        else:
+    if should_tint_background and (alternating_logs > 0):
+        if alternating_logs == 1:
             style = ALTERNATIVE_BACKGROUND_FOR_DARK
+        else:
+            style = ALTERNATIVE_BACKGROUND_FOR_LIGHT
         output.stylize(style)
 
     return output

logger_36/catalog/handler/generic.py

@@ -39,12 +39,10 @@ class generic_handler_t(l.Handler):
     """
     kind: See logger_36.constant.handler.handler_codes_h.
 
-    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.
+    alternating_logs:
+    - 0: disabled
+    - 1: enabled for dark background
+    - 2: enabled for light background
 
     LogAsIs:
         Log a message as is, i.e. without formatting. If this is a method, it should
@@ -63,12 +61,12 @@ class generic_handler_t(l.Handler):
     # "None -> h.Any" (twice below) since None | None is invalid.
     console: console_t | h.Any = None
     console_options: console_options_t | h.Any = None
-    alternating_lines: int = 0
-    background_is_light: bool = True
+    alternating_logs: int = 0
 
     DisplayRule: DisplayRule_p = d.field(init=False)
     extension: handler_extension_t = d.field(init=False)
     MessageFromRecord: MessageFromRecord_h = d.field(init=False)
+    log_parity: bool = d.field(init=False, default=False)
 
     name: d.InitVar[str | None] = None
     level: d.InitVar[int] = l.NOTSET
@@ -120,14 +118,7 @@ class generic_handler_t(l.Handler):
             self.DisplayRule = self._DisplayRuleAsText
 
         self.MessageFromRecord = self.extension.MessageFromRecord
-        if self.alternating_lines == 1:
-            self.alternating_lines = 0
-            self.background_is_light = False
-        elif self.alternating_lines == 2:
-            self.alternating_lines = 0
-            self.background_is_light = True
-        else:
-            self.alternating_lines = -1
+        assert self.alternating_logs in (0, 1, 2)
 
     def emit(self, record: l.LogRecord, /) -> None:
         """"""
@@ -141,15 +132,12 @@ class generic_handler_t(l.Handler):
                 richer = Rule(record.msg, DATE_TIME_COLOR)
             else:
                 message = self.MessageFromRecord(record, PreProcessed=EscapedForRich)
-                should_highlight_back = self.alternating_lines == 1
-                if self.alternating_lines >= 0:
-                    self.alternating_lines = (self.alternating_lines + 1) % 2
                 richer = HighlightedVersion(
                     self.console,
                     message,
                     record.levelno,
-                    should_highlight_back=should_highlight_back,
-                    background_is_light=self.background_is_light,
+                    self.alternating_logs,
+                    self.log_parity,
                 )
             segments = self.console.render(richer, options=self.console_options)
 
@@ -176,6 +164,7 @@ class generic_handler_t(l.Handler):
             )
 
         self.LogAsIs(message)
+        self.log_parity = not self.log_parity
 
     def _DisplayRuleAsText(
         self, /, *, text: str | None = None, color: str = "white"

logger_36/handler.py

@@ -33,7 +33,7 @@ def AddGenericHandler(
     message_width: int = -1,
     formatter: l.Formatter | None = None,
     supports_html: bool = False,
-    alternating_lines: int = 2,
+    alternating_logs: int = 0,
     should_record: bool = False,
     should_hold_messages: bool = False,
     **kwargs,
@@ -46,7 +46,7 @@ def AddGenericHandler(
         message_width=message_width,
         formatter=formatter,
         supports_html=supports_html,
-        alternating_lines=alternating_lines,
+        alternating_logs=alternating_logs,
         should_record=should_record,
         rich_kwargs=kwargs,
         LogAsIs=LogAsIs,
@@ -85,7 +85,7 @@ def AddRichConsoleHandler(
     should_store_memory_usage: bool = False,
     message_width: int = -1,
     formatter: l.Formatter | None = None,
-    alternating_lines: int = 2,
+    alternating_logs: int = 0,
     should_hold_messages: bool = False,
     should_install_traceback: bool = False,
     should_record: bool = False,
@@ -101,7 +101,7 @@ def AddRichConsoleHandler(
         additional_s = {}
     else:
         additional_s = {
-            "alternating_lines": alternating_lines,
+            "alternating_logs": alternating_logs,
             "should_install_traceback": should_install_traceback,
             "should_record": should_record,
             "rich_kwargs": kwargs,

logger_36/type/logger.py

@@ -283,10 +283,10 @@ class logger_t(base_t):
         OverrideExceptionFormat()
         AddConsoleHandler(self)
 
-    def MakeRich(self, *, alternating_lines: int = 2) -> None:
+    def MakeRich(self, *, alternating_logs: int = 0) -> None:
         """"""
         OverrideExceptionFormat()
-        AddRichConsoleHandler(self, alternating_lines=alternating_lines)
+        AddRichConsoleHandler(self, alternating_logs=alternating_logs)
 
     def MakePermanent(self, path: str | path_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.9"
+__version__ = "2025.10"
 
 """
 COPYRIGHT NOTICE

{logger_36-2025.9.dist-info → logger_36-2025.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: logger-36
-Version: 2025.9
+Version: 2025.10
 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.9.dist-info → logger_36-2025.10.dist-info}/RECORD

@@ -2,20 +2,20 @@ logger_36/__init__.py,sha256=3BtAgxFb14e9zzC5fXwqSQxstsd3BO0b_KVu3_wbLwg,2592
 logger_36/content.py,sha256=clHYYUKa8n4qef6PVlUV4mFHRRf6fnm9wEd2fu9oagA,2381
 logger_36/exception.py,sha256=9YWnS2LN_Mc0qYkohtbgEkzKe9ja2h_dBEd39ytGbRU,4605
 logger_36/gpu.py,sha256=BOumedCAPWvCo7J-KJ3XE-jr5S0KSmgcFv_S4QKRPO8,2252
-logger_36/handler.py,sha256=YOSkwLOO02Y69z-Hd7gtjng7s3VtgvlqnLMgv8jovI4,6309
+logger_36/handler.py,sha256=fYc9L0RkMnlwKH_dSwOEeOV61D-L3zd-hxbPkzEvKbY,6303
 logger_36/memory.py,sha256=szJVk4UTXsbYv3B-W9LFttf1F3j86GXHsKgEUOsXKl4,2743
 logger_36/storage.py,sha256=sCxkHQH4xMaseweK1p2M1j0j2PxNPpy9MytPdg1sKiQ,2239
 logger_36/system.py,sha256=cgOMF_OneYeIJDMbIbIDx96EZss2uAdkk8QofOC7O1U,2251
 logger_36/time.py,sha256=Uw1jQtY1njsRuIPRAXX44v4nPOo84MSBu_WK_YCRzQs,2324
-logger_36/version.py,sha256=GMhKYpDckX_jLa0A1mt1reiX5XWPRZxrdkZSXbm_Km4,2205
+logger_36/version.py,sha256=iy6wT5BEzB1vF_6nT0az2cXgwzIOb0RrSrqWYu1gq5g,2206
 logger_36/api/logger.py,sha256=TE3ATbymeWX-wBKBFkVz2FxUyJnaqY7vzFwAONVsp2o,2233
 logger_36/api/storage.py,sha256=v1iywLEItJCz18F_nJ20OnlpCpLdA-7EhlvqdLu42js,2243
 logger_36/catalog/config/console_rich.py,sha256=lAa5Ev5BhXvmQzfIt1FNihMNUQJFlXaIzNanAMdgtd0,2861
 logger_36/catalog/config/optional.py,sha256=HaN6mbx7gHBBppNvUw1ckhYTOrlYqb-b_r0mzPcHPjM,2398
 logger_36/catalog/handler/console.py,sha256=13ygxLmsywdGlr9hV9guw7FuRD-dxlZX20d1Mn-pWKs,4206
-logger_36/catalog/handler/console_rich.py,sha256=E9ysE_aREozf9qz-ooxzVMwT3aj13U6Mb8qtmomYwSI,8549
+logger_36/catalog/handler/console_rich.py,sha256=RrNp8Uqf_MVw6o3Qcf7-4AfsZM_TjaTR2L_FKqD6LjI,8033
 logger_36/catalog/handler/file.py,sha256=ZbYLic0XcX3vw-col8hiuO-SQOSZh06tPYu5z3FdGDo,4620
-logger_36/catalog/handler/generic.py,sha256=sJwqUFKEcziVAtHrPLDemEdeB1VU-F2gXkbbLtsYJ-g,9217
+logger_36/catalog/handler/generic.py,sha256=YYVdfG5nJHLIC-W9p8YhRREyFFSjJGHfSKJFd9EtLp0,8663
 logger_36/catalog/logger/chronos.py,sha256=ocY13f98EfknU7wZCv0FS9Xb7pTNaWCPSusXFIEvEd4,2437
 logger_36/catalog/logger/gpu.py,sha256=n_kbAQdRNk3Jdket6031_r2unOcz3dWplhCR-WFPjE0,3417
 logger_36/catalog/logger/memory.py,sha256=CWhr2J4BqArJxzH6tS-ZThr-rYPAQGtuLn0pP7Iryfg,4685
@@ -46,9 +46,9 @@ logger_36/task/measure/chronos.py,sha256=1kVhu6jZlNAtNWQQh8ZVuRwZIAC9gGz3_ul1tn0
 logger_36/task/measure/memory.py,sha256=OjU5EYFH8SnzlCQKAoiXvauUlwQYOrH34jFXTVYF0jE,2517
 logger_36/type/handler.py,sha256=5g5KdmKk6cdsUSV0JoFfjpAXdQIzSRcW81STyLqqWq8,6824
 logger_36/type/issue.py,sha256=2rGsFqaQJCbeml9xN08mN_nK79L8qscaS_0ws36Y0bI,3214
-logger_36/type/logger.py,sha256=4KkM_bIVRsjGO0ORloSibEb0MPtg88wSj5_wweRKjJU,22805
+logger_36/type/logger.py,sha256=uqv5948_V8cUi_PBwtLGGNDcYe8NfaePQcZXvviCs9w,22802
 logger_36/type/loggers.py,sha256=znqxWBnfQxvkg3VUfbTUvt3S6Kq0DAzWWepxQDt9suI,2871
-logger_36-2025.9.dist-info/METADATA,sha256=AMDXKjSSMDRqWDLT0FeNYlV9bWGc2s1LXSDTD_h93sg,6505
-logger_36-2025.9.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-logger_36-2025.9.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
-logger_36-2025.9.dist-info/RECORD,,
+logger_36-2025.10.dist-info/METADATA,sha256=SD9qdZj7hf8PpN1Aezr9JYsUWaM7N2Grv-cBfT5BlHw,6506
+logger_36-2025.10.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+logger_36-2025.10.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
+logger_36-2025.10.dist-info/RECORD,,