logger-36 2025.27__tar.gz → 2025.29__tar.gz

{logger_36-2025.27 → logger_36-2025.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logger-36
-Version: 2025.27
+Version: 2025.29
 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.27 → logger_36-2025.29}/package/logger_36/catalog/logger/chronos.py

@@ -6,20 +6,48 @@ SEE COPYRIGHT NOTICE BELOW
 
 from datetime import datetime as date_time_t
 
-from logger_36.constant.chronos import FORMATTED_START_DATE_TIME
-from logger_36.constant.record import SHOW_WHEN_ATTR
+from logger_36.constant.chronos import FORMATTED_START_DATE_TIME, START_DATE_TIME
+from logger_36.constant.record import SHOW_WHEN_ATTR, SHOW_WHERE_ATTR
 from logger_36.instance.logger import L
 from logger_36.task.measure.chronos import FormattedElapsedTime
 from logger_36.type.logger import logger_t
 
 
+_START_NAME = "START"
+_START_PLACEHOLDER = "..."  # Must not be longer than _START_NAME.
+_END_NAME = "END"
+
+
 def LogElapsedTime(*, logger: logger_t = L) -> None:
     """"""
-    logger.info(
-        f"Elapsed Time: {FormattedElapsedTime(date_time_t.now())[1:]} "
-        f"(since {FORMATTED_START_DATE_TIME})",
-        extra={SHOW_WHEN_ATTR: False},
+    now = date_time_t.now()
+
+    message = (
+        f"Elapsed Time: {FormattedElapsedTime(now, with_separator=False)} "
+        f"(since {FORMATTED_START_DATE_TIME})"
     )
+    if logger.intermediate_times.__len__() > 0:
+        intermediate_e_times = []
+        for (start_name, start_time), (end_name, end_time) in zip(
+            [(_START_NAME, START_DATE_TIME)] + logger.intermediate_times,
+            logger.intermediate_times + [(_END_NAME, now)],
+            strict=True,
+        ):
+            if start_name != _START_NAME:
+                start_name = _START_PLACEHOLDER
+            e_time = FormattedElapsedTime(
+                end_time, reference=start_time, with_separator=False
+            )
+            intermediate_e_times.append((start_name, end_name, e_time))
+        max_length_end = max(map(len, (_[1] for _ in intermediate_e_times)))
+        intermediate_e_times = "\n    ".join(
+            f"{_: <{_START_NAME.__len__()}} → {__: <{max_length_end}}   +{___}"
+            for _, __, ___ in intermediate_e_times
+        )
+        message += "\n    " + intermediate_e_times
+        logger.intermediate_times.clear()
+
+    logger.info(message, extra={SHOW_WHEN_ATTR: False, SHOW_WHERE_ATTR: False})
 
 
 """

{logger_36-2025.27 → logger_36-2025.29}/package/logger_36/task/measure/chronos.py

@@ -24,7 +24,11 @@ def TimeStamp(*, precision: str = "microseconds") -> str:
 
 
 def FormattedElapsedTime(
-    now: date_time_t, /, *, reference: date_time_t = START_DATE_TIME
+    now: date_time_t,
+    /,
+    *,
+    reference: date_time_t = START_DATE_TIME,
+    with_separator: bool = True,
 ) -> str:
     """"""
     output = str(now - reference)
@@ -36,7 +40,8 @@ def FormattedElapsedTime(
     if output[0] == "0":
         output = output[1:]
 
-    output = ELAPSED_TIME_SEPARATOR + output
+    if with_separator:
+        output = ELAPSED_TIME_SEPARATOR + output
 
     if output.__len__() > TIME_LENGTH:
         return output[:TIME_LENGTH]

{logger_36-2025.27 → logger_36-2025.29}/package/logger_36/type/logger.py

@@ -92,6 +92,9 @@ class logger_t(base_t):
 
     history: dict[date_time_t, str] = d.field(init=False, default_factory=dict)
     n_events: dict[int, int] = d.field(init=False, default_factory=dict)
+    intermediate_times: list[tuple[str, date_time_t]] = d.field(
+        init=False, default_factory=list
+    )
 
     last_message_now: date_time_t = d.field(init=False, default=DATE_TIME_ORIGIN)
     last_message_date: date_t = d.field(init=False, default=DATE_ORIGIN)
@@ -109,6 +112,7 @@ class logger_t(base_t):
     # Used only until the first handler is added (see AddHandler).
     _should_activate_log_interceptions: bool = d.field(init=False, default=False)
 
+    server_handlers: tuple[l.Handler,...]|None = d.field(init=False, default=None)
     log_server: log_server_t | None = d.field(init=False, default=None)
 
     name_: d.InitVar[str | None] = None
@@ -429,9 +433,12 @@ class logger_t(base_t):
         handler). If handlers are added passed this call, execution might freeze or
         crash.
         """
-        assert self.log_server is None
+        assert prll.current_process().name == MAIN_PROCESS_NAME
         assert self.hasHandlers()
 
+        if self.log_server is not None:
+            return
+
         handlers = tuple(self.handlers)  # Making a copy is necessary.
         for handler in handlers:
             self.removeHandler(handler)
@@ -440,9 +447,31 @@ class logger_t(base_t):
 
         self.addHandler(queue_handler_t(queue))
 
-        self.log_server = log_server_t(queue, *handlers)
+        self.server_handlers = handlers
+        self.log_server = log_server_t(queue, *handlers, respect_handler_level=True)
         self.log_server.start()
 
+    def RemoveMultiSafety(self) -> None:
+        """
+        Calling this method automatically as an atexit-registered function does not
+        flush the enqueued log records. It is probably too late then for this. Hence, if
+        MakeMultiSafe has been called, this method should also be called before the
+        execution ends.
+        """
+        assert prll.current_process().name == MAIN_PROCESS_NAME
+
+        if self.log_server is None:
+            return
+
+        self.log_server.stop()
+
+        for handler in self.handlers:  # There is only the QueueHandler, actually.
+            self.removeHandler(handler)
+        for handler in self.server_handlers:
+            self.addHandler(handler)
+
+        self.server_handlers = self.log_server = None
+
     def __call__(self, *args, **kwargs) -> None:
         """
         For a print-like calling for print-based debugging.
@@ -510,7 +539,7 @@ class logger_t(base_t):
             message = "\n".join(lines[:1] + lines[2:])
         else:
             # TODO: Explain:
-            #     - Why it's not: "\n".join(lines)?
+            #     - Why is it not: "\n".join(lines)?
             #     - Why adding exception name here and not when removing caller?
             formatted = "".join(lines)
             message = f"Exception of type {type(exception).__name__}\n----\n{formatted}"
@@ -541,11 +570,6 @@ class logger_t(base_t):
             }
         )
         base_t.handle(self, record)
-        # emit_rule_name = handler_extension_t.EmitRule.__name__
-        # for handler in self.handlers:
-        #     EmitRule = getattr(handler, emit_rule_name, None)
-        #     if EmitRule is not None:
-        #         EmitRule(text=message, color=color)
 
     def AddContextLevel(self, new_level: str, /) -> None:
         """"""
@@ -670,9 +694,13 @@ class logger_t(base_t):
                     del extra[HAS_ACTUAL_EXPECTED_ATTR]
         self.staged_issues.clear()
 
+    def SetInstantName(self, name: str, /) -> None:
+        """"""
+        self.intermediate_times.append((name, date_time_t.now()))
+
     def StoragePath(self, suffix: str, /) -> path_t:
         """
-        Use as staticmethod if needed.
+        Use as staticmethod if needed, passing a logger as self.
         """
         for handler in self.handlers:
             if (path := getattr(handler, "baseFilename", None)) is not None:
@@ -699,15 +727,6 @@ class logger_t(base_t):
         _ = self.context_levels.pop()
         return False
 
-    def __del__(self) -> None:
-        """"""
-        if (
-            (prll.current_process is not None)
-            and (prll.current_process().name == MAIN_PROCESS_NAME)
-            and (self.log_server is not None)
-        ):
-            self.log_server.stop()
-
 
 def _HandleForWarnings(interceptor: base_t, /) -> logger_handle_h:
     """"""

{logger_36-2025.27 → logger_36-2025.29}/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.27"
+__version__ = "2025.29"
 
 """
 COPYRIGHT NOTICE

{logger_36-2025.27 → logger_36-2025.29}/package/logger_36.egg-info/PKG-INFO

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