logger-36 2025.7__py3-none-any.whl → 2025.8__py3-none-any.whl

logger_36/api/storage.py

@@ -4,7 +4,7 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from logger_36.task.storage import html_reader_t  # noqa
+from logger_36.extension.html_ import html_content_t  # noqa
 
 """
 COPYRIGHT NOTICE

logger_36/catalog/handler/console_rich.py

@@ -74,6 +74,15 @@ class console_rich_handler_t(l.Handler):
 
     rich_kwargs: d.InitVar[dict[str, h.Any] | None] = None
 
+    @property
+    def past_logs_as_HTML(self) -> str | None:
+        """"""
+        console = self.console
+        if console.record:
+            return console.export_html()
+
+        return None
+
     def __post_init__(
         self,
         name: str | None,

logger_36/extension/html_.py

@@ -0,0 +1,107 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+import dataclasses as d
+import re as r
+from html.parser import HTMLParser as base_t
+
+_BODY_END_PATTERN = r"</[bB][oO][dD][yY]>(.|\n)*$"
+
+
+@d.dataclass(slots=True, repr=False, eq=False)
+class html_content_t(base_t):
+    source: str = ""
+    inside_body: bool = d.field(init=False, default=False)
+    body_position_start: tuple[int, int] = d.field(init=False, default=(-1, -1))
+    body_position_end: tuple[int, int] = d.field(init=False, default=(-1, -1))
+    pieces: list[str] = d.field(init=False, default_factory=list)
+
+    @property
+    def body(self) -> str:
+        """"""
+        output = self.source.splitlines()
+        output = "\n".join(
+            output[self.body_position_start[0] : (self.body_position_end[0] + 1)]
+        )
+        output = output[self.body_position_start[1] :]
+        output = r.sub(_BODY_END_PATTERN, "", output, count=1)
+
+        return output.strip()
+
+    @property
+    def body_as_text(self) -> str:
+        """"""
+        return "".join(self.pieces).strip()
+
+    def __post_init__(self) -> None:
+        """"""
+        base_t.__init__(self)
+        self.source = self.source.strip()
+        self.feed(self.source)
+
+    def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]], /) -> None:
+        """"""
+        if tag == "body":
+            self.body_position_start = self.getpos()
+            self.inside_body = True
+
+    def handle_endtag(self, tag: str, /) -> None:
+        """"""
+        if tag == "body":
+            self.body_position_end = self.getpos()
+            self.inside_body = False
+
+    def handle_data(self, data: str, /) -> None:
+        """"""
+        if self.inside_body:
+            self.pieces.append(data)
+
+
+"""
+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/task/storage.py

@@ -4,73 +4,12 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
 SEE COPYRIGHT NOTICE BELOW
 """
 
-import dataclasses as d
 import logging as l
-import re as r
-from html.parser import HTMLParser as html_parser_t
 from io import IOBase as io_base_t
 from pathlib import Path as path_t
 
-from logger_36.catalog.config.optional import RICH_IS_AVAILABLE
 from logger_36.instance.logger import L
 
-if RICH_IS_AVAILABLE:
-    from rich.console import Console as console_t  # noqa
-else:
-    console_t = None
-
-
-_BODY_END_PATTERN = r"</[bB][oO][dD][yY]>(.|\n)*$"
-
-
-@d.dataclass(slots=True, repr=False, eq=False)
-class html_reader_t(html_parser_t):
-    source: str = ""
-    inside_body: bool = d.field(init=False, default=False)
-    body_position_start: tuple[int, int] = d.field(init=False, default=(-1, -1))
-    body_position_end: tuple[int, int] = d.field(init=False, default=(-1, -1))
-    pieces: list[str] = d.field(init=False, default_factory=list)
-
-    def __post_init__(self) -> None:
-        """"""
-        html_parser_t.__init__(self)
-        self.source = self.source.strip()
-        self.feed(self.source)
-
-    def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]], /) -> None:
-        """"""
-        if tag == "body":
-            self.body_position_start = self.getpos()
-            self.inside_body = True
-
-    def handle_endtag(self, tag: str, /) -> None:
-        """"""
-        if tag == "body":
-            self.body_position_end = self.getpos()
-            self.inside_body = False
-
-    def handle_data(self, data: str, /) -> None:
-        """"""
-        if self.inside_body:
-            self.pieces.append(data)
-
-    @property
-    def body(self) -> str:
-        """"""
-        output = self.source.splitlines()
-        output = "\n".join(
-            output[self.body_position_start[0] : (self.body_position_end[0] + 1)]
-        )
-        output = output[self.body_position_start[1] :]
-        output = r.sub(_BODY_END_PATTERN, "", output, count=1)
-
-        return output.strip()
-
-    @property
-    def body_as_text(self) -> str:
-        """"""
-        return "".join(self.pieces).strip()
-
 
 def SaveLOGasHTML(path: str | path_t | io_base_t | None = None) -> None:
     """
@@ -78,18 +17,15 @@ def SaveLOGasHTML(path: str | path_t | io_base_t | None = None) -> None:
     """
     cannot_save = "Cannot save logging record as HTML"
 
-    if console_t is None:
-        L.warning(f"{cannot_save}: The Rich console cannot be imported.")
-        return
-
     if path is None:
         for handler in L.handlers:
             if isinstance(handler, l.FileHandler):
                 path = path_t(handler.baseFilename).with_suffix(".htm")
                 break
-        if path is None:
+        else:
             L.warning(f"{cannot_save}: No file handler to build a filename from.")
             return
+
         if path.exists():
             L.warning(
                 f'{cannot_save}: Automatically generated path "{path}" already exists.'
@@ -103,18 +39,15 @@ def SaveLOGasHTML(path: str | path_t | io_base_t | None = None) -> None:
         L.warning(f'{cannot_save}: File "{path}" already exists.')
         return
 
-    for handler in L.handlers:
-        console = getattr(handler, "console", None)
-        if isinstance(console, console_t) and console.record:
-            html = console.export_html()
-            if actual_file:
-                with open(path, "w") as accessor:
-                    accessor.write(html)
-            else:
-                path.write(html)
-            break
+    html = L.past_logs_as_HTML
+    if html is None:
+        L.warning(f"{cannot_save}: No handler could provide an HTML output.")
     else:
-        L.warning(f"{cannot_save}: No handler has a RICH console with recording ON.")
+        if actual_file:
+            with open(path, "w") as accessor:
+                accessor.write(html)
+        else:
+            path.write(html)
 
 
 """

logger_36/type/logger.py

@@ -102,6 +102,18 @@ class logger_t(base_t):
         """"""
         return self.staged_issues.__len__() > 0
 
+    @property
+    def past_logs_as_HTML(self) -> str | None:
+        """
+        From the first handler found with the given functionality, if any.
+        """
+        for handler in self.handlers:
+            past_logs_as_HTML = getattr(handler, "past_logs_as_HTML", None)
+            if past_logs_as_HTML is not None:
+                return past_logs_as_HTML
+
+        return None
+
     @property
     def max_memory_usage(self) -> int:
         """"""
@@ -338,6 +350,7 @@ class logger_t(base_t):
         if state:
             assert not self.intercepts_logs
 
+            # Note: Alternative to self.manager is logging.root.manager.
             all_loggers = [l.getLogger()] + [
                 l.getLogger(_nme)
                 for _nme in self.manager.loggerDict

logger_36/version.py

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

{logger_36-2025.7.dist-info → logger_36-2025.8.dist-info}/METADATA

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

@@ -7,13 +7,13 @@ 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=QWIy4Jr-I6cIfY2uS0OZkwf54A1Oh3Rxgb14HI6W6bE,2205
+logger_36/version.py,sha256=dIKiLoaPWfEeTZKKzEklIyLlE8cFbHUq2h72W5GmOiI,2205
 logger_36/api/logger.py,sha256=TE3ATbymeWX-wBKBFkVz2FxUyJnaqY7vzFwAONVsp2o,2233
-logger_36/api/storage.py,sha256=KT52AGR37nsMrhKTVfG8R-Dc7lmCXjWML18cOqqCXZY,2239
+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=s2DBcDK9To-wVS228RsDDPmOPxlIbVnQbZINfIK2TP0,4150
-logger_36/catalog/handler/console_rich.py,sha256=pI0OE0c5I19-ycvOJjdG5vdtDXTZadNNRbKCJD-2oL4,8347
+logger_36/catalog/handler/console_rich.py,sha256=uYCoxPBPypaioSibC68Vw9r1XoY8AB5pAq2-RV1a4wQ,8544
 logger_36/catalog/handler/file.py,sha256=2qbsI3UHxqEm9WiCMkAm20hA2qXth2wKnakazVbwrBs,4613
 logger_36/catalog/handler/generic.py,sha256=y-f6HY5xppoHYYnej0qOQT3BI0Gam_0W1_bIHCk5nn0,9212
 logger_36/catalog/logger/chronos.py,sha256=ocY13f98EfknU7wZCv0FS9Xb7pTNaWCPSusXFIEvEd4,2437
@@ -34,10 +34,11 @@ 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/html_.py,sha256=J9EX8-Rotq9i8bZ9U-dIpXv5gKLLnLmWqdDy4XayT1Q,3868
 logger_36/instance/logger.py,sha256=oTw5svRzKRJKvGrrZUtutJIOjp5UISft3fl0Ze7DOBE,2241
 logger_36/instance/loggers.py,sha256=RCWpC1NPAf6vXnFc9NqsSALv-x-FEzcH6k_OlxTxeQk,2251
 logger_36/task/inspection.py,sha256=KZzmQyREQ6VmBWCLyNIYIOOISW9C_fC9TWTSX90zGDk,5019
-logger_36/task/storage.py,sha256=2B4OU7RqpUe98-pY9fadfnW8aFwxtsLSRGKkBtGWn-k,5686
+logger_36/task/storage.py,sha256=T96JZT5Tmrt_-Kqf_WKweTvJYPX6lmPZZkJzCqyVPcI,3502
 logger_36/task/format/memory.py,sha256=jpQS8tAdxy7GM_FzqEIJUU3m-6O9iX-jiyO7gx5YwR8,4266
 logger_36/task/format/message.py,sha256=T2V2gUlUQqSojyRrz4I4uAHwNe6eBEsuAe6V-LTyx0k,3867
 logger_36/task/format/rule.py,sha256=vkf-HivFb4VqV2GeOPVqMAp99krtziI-kXhox3UVnzw,2873
@@ -45,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=-myl7uBMOzkwCs1u4ehuYlQa9F6909jmnL2v_eQN5ag,6819
 logger_36/type/issue.py,sha256=2rGsFqaQJCbeml9xN08mN_nK79L8qscaS_0ws36Y0bI,3214
-logger_36/type/logger.py,sha256=nGNWJ5xcyA79E45qcZ-gZ3ZuY7j1aDg5NXk7VwbQVFU,22287
+logger_36/type/logger.py,sha256=J6J87-RkH0RwiROeDQBnoTxLO5eXz32-GKjtxqyRXwk,22743
 logger_36/type/loggers.py,sha256=znqxWBnfQxvkg3VUfbTUvt3S6Kq0DAzWWepxQDt9suI,2871
-logger_36-2025.7.dist-info/METADATA,sha256=E708bS17nu3wkJZ7YTNfvezYSBUbfwXgUCwiiXwOkf0,6505
-logger_36-2025.7.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-logger_36-2025.7.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
-logger_36-2025.7.dist-info/RECORD,,
+logger_36-2025.8.dist-info/METADATA,sha256=R6yfIOmsKd4dJgf9EwdP7Mv1TtSlLD04g5liwcKXPOU,6505
+logger_36-2025.8.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+logger_36-2025.8.dist-info/top_level.txt,sha256=sM95BTMWmslEEgR_1pzwZsOeSp8C_QBiu8ImbFr0XLc,10
+logger_36-2025.8.dist-info/RECORD,,