logger-36 2023.13__py3-none-any.whl → 2024.2__py3-none-any.whl

logger_36/catalog/logging/memory.py

@@ -0,0 +1,105 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+from logger_36.config.memory import LENGTH_100, MAX_N_SAMPLES
+from logger_36.constant.logger import HIDE_WHERE_KWARG
+from logger_36.constant.memory import storage_units_h
+from logger_36.instance import LOGGER
+from logger_36.task.format.memory import FormattedUsage, UsageBar
+from logger_36.task.format.message import FormattedMessage
+
+
+def LogMemoryUsages(
+    *,
+    unit: storage_units_h | None = "a",
+    decimals: int = None,
+    max_n_samples: int | None = MAX_N_SAMPLES,
+    length_100: int = LENGTH_100,
+) -> None:
+    """"""
+    if not LOGGER.any_handler_shows_memory:
+        return
+
+    where_s, usages = zip(*LOGGER.memory_usages)
+
+    where, max_usage = LOGGER.max_memory_usage_full
+    value, unit = FormattedUsage(max_usage, unit=unit, decimals=decimals)
+    title = f"Memory Usage: Max={value}{unit} near {where}\n"
+
+    if isinstance(max_n_samples, int):
+        if max_n_samples < 1:
+            raise ValueError(
+                FormattedMessage(
+                    "Invalid maximum number of samples",
+                    actual=max_n_samples,
+                    expected=1,
+                    expected_op=">=",
+                )
+            )
+
+        where_s = list(where_s)
+        usages = list(usages)
+        while usages.__len__() > max_n_samples:
+            index = usages.index(min(usages))
+            del where_s[index]
+            del usages[index]
+
+    usages = tuple(round(_elm, 1) for _elm in usages)
+    max_usage = max(usages)
+
+    plot = []
+    max_where_length = max(map(len, where_s))
+    usages_as_str = tuple(map(lambda _elm: f"{_elm:_}", usages))
+    max_usage_length = max(map(len, usages_as_str))
+    for where, usage, usage_as_str in zip(where_s, usages, usages_as_str):
+        bar = UsageBar(usage, max_usage, length_100=length_100)
+        plot.append(
+            f"{where:{max_where_length}} "
+            f"{bar:{length_100}} "
+            f"{usage_as_str: >{max_usage_length}}"
+        )
+    plot = "\n".join(plot)
+
+    LOGGER.info(title + plot, **HIDE_WHERE_KWARG)
+
+
+def LogMaximumMemoryUsage(
+    *, unit: storage_units_h | None = "a", decimals: int = None
+) -> None:
+    """
+    unit: b or None=bytes, k=kilo, m=mega, g=giga, a=auto
+    """
+    if LOGGER.any_handler_shows_memory:
+        where, max_usage = LOGGER.max_memory_usage_full
+        value, unit = FormattedUsage(max_usage, unit=unit, decimals=decimals)
+        LOGGER.info(
+            f"Max. Memory Usage: {value}{unit} near {where}", **HIDE_WHERE_KWARG
+        )

logger_36/catalog/logging/system.py

@@ -0,0 +1,62 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+from logger_36.constant.logger import HIDE_WHERE_KWARG
+from logger_36.constant.system import MAX_DETAIL_NAME_LENGTH, SYSTEM_DETAILS_AS_DICT
+from logger_36.instance import LOGGER
+from logger_36.task.inspection import Modules
+
+
+def LogSystemDetails(
+    *,
+    modules_with_version: bool = True,
+    modules_formatted: bool = True,
+    should_restrict_modules_to_loaded: bool = True,
+) -> None:
+    """"""
+    details = "\n".join(
+        f"    {_key:>{MAX_DETAIL_NAME_LENGTH}}: {_vle}"
+        for _key, _vle in SYSTEM_DETAILS_AS_DICT.items()
+    )
+    modules = Modules(
+        modules_with_version,
+        modules_formatted,
+        only_loaded=should_restrict_modules_to_loaded,
+        indent=4,
+    )
+
+    LOGGER.info(
+        f"SYSTEM DETAILS\n"
+        f"{details}\n"
+        f"    {'Python Modules':>{MAX_DETAIL_NAME_LENGTH}}:\n"
+        f"{modules}",
+        **HIDE_WHERE_KWARG,
+    )

logger_36/config/issue.py

@@ -0,0 +1,32 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+BASE_CONTEXT = "BASE"

logger_36/config/memory.py

@@ -0,0 +1,33 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+MAX_N_SAMPLES = 10
+LENGTH_100 = 20

logger_36/config/message.py

@@ -0,0 +1,48 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+LEVEL_OPENING = "("
+LEVEL_CLOSING = ")"
+MESSAGE_MARKER = "| "
+WHERE_SEPARATOR = "@"
+ELAPSED_TIME_SEPARATOR = "+"
+MEMORY_SEPARATOR = ":"
+
+INTERCEPTED_LOG_SEPARATOR = " >>> "
+
+DATE_FORMAT = "%Y-%m-%d"
+TIME_FORMAT = "%H:%M:%S"
+WHERE_FORMAT = f" {WHERE_SEPARATOR} {{module}}:{{funcName}}:{{lineno}}"
+ELAPSED_TIME_FORMAT = f" {ELAPSED_TIME_SEPARATOR}%(elapsed_time)s"
+MEMORY_FORMAT = f" {MEMORY_SEPARATOR}%(memory_usage)s"
+
+ACTUAL_PATTERNS: str = r" Actual="
+EXPECTED_PATTERNS: str = r" Expected([!<>]?=|: )"

logger_36/{config.py → config/system.py}

@@ -29,23 +29,6 @@
 # The fact that you are presently reading this means that you have had
 # knowledge of the CeCILL license and that you accept its terms.
 
-LOGGER_NAME = "logger-36"
-
-LEVEL_OPENING = "["
-LEVEL_CLOSING = "]"
-CONTEXT_SEPARATOR = "- "
-WHERE_SEPARATOR = "@"
-ELAPSED_TIME_SEPARATOR = "+"
-MESSAGE_FORMAT = (
-    f"%(asctime)s{LEVEL_OPENING}%(levelname)s{LEVEL_CLOSING}\t"
-    f"{CONTEXT_SEPARATOR}"
-    f"%(message)s "
-    f"{WHERE_SEPARATOR} %(module)s:%(funcName)s:%(lineno)d "
-    f"{ELAPSED_TIME_SEPARATOR}%(elapsed_time)s"
-    f"%(memory_usage)s"
-)
-DATE_TIME_FORMAT = "%Y-%m-%d@%H:%M:%S"
-
 SYSTEM_DETAILS = (
     "node",
     "machine",

logger_36/constant/generic.py

@@ -0,0 +1,37 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+
+class _not_passed_t:
+    pass
+
+
+NOT_PASSED = _not_passed_t()

logger_36/constant/handler.py

@@ -0,0 +1,35 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+import typing as h
+
+handler_codes_h = h.Literal["g", "c", "f", "a"]
+HANDLER_CODES: tuple[str, ...] = h.get_args(handler_codes_h)

logger_36/constant/issue.py

@@ -0,0 +1,35 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+import typing as h
+
+order_h = h.Literal["when", "context"]
+ORDER: tuple[str, ...] = h.get_args(order_h)

logger_36/{type/file.py → constant/logger.py}

@@ -30,23 +30,21 @@
 # knowledge of the CeCILL license and that you accept its terms.
 
 import logging as lggg
-from pathlib import Path as path_t
+import re as regx
+import typing as h
 
-from logger_36.type.extension import handler_extension_t
+from logger_36.constant.record import HIDE_WHERE_ATTR
 
+LOGGER_NAME = "logger-36"
 
-class file_handler_t(lggg.FileHandler, handler_extension_t):
-    def __init__(self, path: str | path_t, /, *args, **kwargs) -> None:
-        """"""
-        lggg.FileHandler.__init__(self, str(path), *args, **kwargs)
-        handler_extension_t.__init__(self)
+# https://docs.python.org/3/library/logging.html#logging.captureWarnings
+WARNING_LOGGER_NAME = "py.warnings"
+WARNING_TYPE_PATTERN = r"([^:]+):([0-9]+): ([^:]+): ([^\n]+)\n"
+WARNING_TYPE_COMPILED_PATTERN = regx.compile(WARNING_TYPE_PATTERN)
 
-        self.setFormatter(self.formatter)
+HIDE_WHERE_KWARG = {"extra": {HIDE_WHERE_ATTR: True}}
 
-    def emit(self, record: lggg.LogRecord, /) -> None:
-        """"""
-        message, _ = self.MessageLines(record, should_fully_format=True)
-        print(message, file=self.stream)
-        self.stream.flush()
-
-        self.ExitOrNotIfError(record)
+# Second version: with self as first parameter.
+logger_handle_h = (
+    h.Callable[[lggg.LogRecord], None] | h.Callable[[lggg.Logger, lggg.LogRecord], None]
+)

logger_36/constant/memory.py

@@ -0,0 +1,39 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+import typing as h
+
+storage_units_h = h.Literal["b", "k", "m", "g", "a"]
+STORAGE_UNITS: tuple[str, ...] = h.get_args(storage_units_h)
+
+MEMORY_MEASURE_ERROR = (
+    "Cannot show memory usage: " 'Package "psutil" not installed or importable.'
+)

logger_36/{constant.py → constant/message.py}

@@ -29,29 +29,20 @@
 # The fact that you are presently reading this means that you have had
 # knowledge of the CeCILL license and that you accept its terms.
 
-import platform as pltf
-from datetime import datetime as dttm
+import time
+import typing as h
 
-from logger_36.config import (
-    CONTEXT_SEPARATOR,
-    DATE_TIME_FORMAT,
+from logger_36.config.message import (
     LEVEL_CLOSING,
     LEVEL_OPENING,
-    SYSTEM_DETAILS,
+    MESSAGE_MARKER,
+    TIME_FORMAT,
 )
 
-# This module is certainly imported early. Therefore, the current time should be close
-# enough to the real start time.
-START_TIME = dttm.now()
+TIME_LENGTH = time.strftime(TIME_FORMAT, time.gmtime(0)).__len__()
+LOG_LEVEL_LENGTH = 1 + LEVEL_OPENING.__len__() + LEVEL_CLOSING.__len__()
+CONTEXT_LENGTH = TIME_LENGTH + LOG_LEVEL_LENGTH
+NEXT_LINE_PROLOGUE = "\n" + (CONTEXT_LENGTH + MESSAGE_MARKER.__len__() + 1) * " "
 
-DATE_TIME_LENGTH = START_TIME.strftime(DATE_TIME_FORMAT).__len__()
-LOG_LEVEL_LENGTH = (
-    max(map(len, ("DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL")))
-    + LEVEL_OPENING.__len__()
-    + LEVEL_CLOSING.__len__()
-)
-CONTEXT_LENGTH = DATE_TIME_LENGTH + LOG_LEVEL_LENGTH
-NEXT_LINE_PROLOGUE = "\n" + (CONTEXT_LENGTH + CONTEXT_SEPARATOR.__len__() + 1) * " "
-
-SYSTEM_DETAILS = {_dtl.capitalize(): getattr(pltf, _dtl)() for _dtl in SYSTEM_DETAILS}
-MAX_DETAIL_NAME_LENGTH = max(map(len, SYSTEM_DETAILS.keys()))
+expected_op_h = h.Literal[": ", "=", "!=", ">=", "<="]
+EXPECTED_OP: tuple[str, ...] = h.get_args(expected_op_h)

logger_36/constant/record.py

@@ -0,0 +1,35 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+SHOW_W_RULE_ATTR = "show_w_rule"
+SHOW_WHERE_ATTR = "where"
+HIDE_WHERE_ATTR = "hide_where"
+SHOW_MEMORY_ATTR = "show_memory_usage"

logger_36/constant/system.py

@@ -0,0 +1,39 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+import platform as pltf
+
+from logger_36.config.system import SYSTEM_DETAILS
+
+SYSTEM_DETAILS_AS_DICT = {
+    _dtl.capitalize(): getattr(pltf, _dtl)() for _dtl in SYSTEM_DETAILS
+}
+MAX_DETAIL_NAME_LENGTH = max(map(len, SYSTEM_DETAILS_AS_DICT.keys()))

logger_36/instance.py

@@ -0,0 +1,34 @@
+# Copyright CNRS/Inria/UCA
+# Contributor(s): Eric Debreuve (since 2023)
+#
+# eric.debreuve@cnrs.fr
+#
+# 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.
+
+from logger_36.type.logger import logger_t
+
+LOGGER = logger_t()