logger-36 2024.14__tar.gz → 2024.16__tar.gz

{logger_36-2024.14 → logger_36-2024.16}/MANIFEST.in

@@ -1,4 +1,3 @@
 include README-COPYRIGHT-utf8.txt
 include README-LICENCE-utf8.txt
-include requirements.txt
 include documentation/wiki/description.asciidoc

{logger_36-2024.14 → logger_36-2024.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: logger-36
-Version: 2024.14
+Version: 2024.16
 Summary: Simple logger with a catalog of handlers
 Home-page: https://src.koda.cnrs.fr/eric.debreuve/logger-36/
 Author: Eric Debreuve
@@ -19,35 +19,8 @@ Description-Content-Type: text/x-rst
 
 ..
    Copyright CNRS/Inria/UniCA
-   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.
+   Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+   SEE COPYRIGHT NOTICE BELOW
 
 .. |PROJECT_NAME|      replace:: logger-36
 .. |SHORT_DESCRIPTION| replace:: Simple logger with a catalog of handlers
@@ -123,3 +96,48 @@ The project is developed with `PyCharm Community <https://www.jetbrains.com/pych
 The code is formatted by `Black <https://github.com/psf/black/>`_, *The Uncompromising Code Formatter*.
 
 The imports are ordered by `isort <https://github.com/timothycrosley/isort/>`_... *your imports, so you don't have to*.
+
+..
+  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-2024.16/README-COPYRIGHT-utf8.txt

@@ -0,0 +1,44 @@
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+
+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: README-LICENCE-utf8.txt
+
+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-2024.14 → logger_36-2024.16}/README.rst

@@ -1,34 +1,7 @@
 ..
    Copyright CNRS/Inria/UniCA
-   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.
+   Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+   SEE COPYRIGHT NOTICE BELOW
 
 .. |PROJECT_NAME|      replace:: logger-36
 .. |SHORT_DESCRIPTION| replace:: Simple logger with a catalog of handlers
@@ -104,3 +77,48 @@ The project is developed with `PyCharm Community <https://www.jetbrains.com/pych
 The code is formatted by `Black <https://github.com/psf/black/>`_, *The Uncompromising Code Formatter*.
 
 The imports are ordered by `isort <https://github.com/timothycrosley/isort/>`_... *your imports, so you don't have to*.
+
+..
+  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-2024.14 → logger_36-2024.16}/documentation/wiki/description.asciidoc

@@ -1,33 +1,6 @@
 // Copyright CNRS/Inria/UniCA
-// 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.
+// Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+// SEE COPYRIGHT NOTICE BELOW
 
 :AUTHOR: Eric Debreuve
 :EMAIL: eric.debreuve@cnrs.fr
@@ -56,3 +29,47 @@
 :CONFIG_FOLDER: None
 
 :DEPENDENCIES_OPTIONAL: psutil, rich, tensorflow, tensorrt
+
+// 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-2024.16/logger_36/__init__.py

@@ -0,0 +1,62 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from logger_36.instance.logger import LOGGER
+from logger_36.main import (
+    AddConsoleHandler,
+    AddFileHandler,
+    AddGenericHandler,
+    AddRichConsoleHandler,
+)
+from logger_36.task.format.message import FormattedMessage
+from logger_36.type.logger import logger_t
+from logger_36.version import __version__
+
+"""
+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-2024.16/logger_36/catalog/config/console_rich.py

@@ -0,0 +1,73 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+import logging as lggg
+
+from rich.color import Color as color_t
+from rich.style import Style as style_t
+
+"""
+Colors: See https://rich.readthedocs.io/en/stable/appendix/colors.html.
+"""
+DATE_TIME_COLOR = "dodger_blue2"
+LEVEL_COLOR: dict[int, str | style_t] = {
+    lggg.DEBUG: "orchid",
+    lggg.INFO: "white",
+    lggg.WARNING: "yellow",
+    lggg.ERROR: "orange1",
+    lggg.CRITICAL: "red",
+}
+ACTUAL_COLOR = "indian_red"
+EXPECTED_COLOR = "green"
+ELAPSED_TIME_COLOR = "green"
+
+GRAY_STYLE = style_t(color=color_t.from_rgb(150, 150, 150))
+
+"""
+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-2024.16/logger_36/catalog/handler/console.py

@@ -0,0 +1,109 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2023
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+import dataclasses as d
+import logging as lggg
+import typing as h
+
+from logger_36.constant.record import SHOW_W_RULE_ATTR
+from logger_36.task.format.rule import RuleAsText
+from logger_36.type.handler import handler_extension_t
+
+
+@d.dataclass(slots=True, repr=False, eq=False)
+class console_handler_t(lggg.Handler):
+    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
+    show_where: d.InitVar[bool] = True
+    show_memory_usage: d.InitVar[bool] = False
+    message_width: d.InitVar[int] = -1
+    formatter: d.InitVar[lggg.Formatter | None] = None
+
+    def __post_init__(
+        self,
+        name: str | None,
+        level: int,
+        show_where: bool,
+        show_memory_usage: bool,
+        message_width: int,
+        formatter: lggg.Formatter | None,
+    ) -> None:
+        """"""
+        lggg.Handler.__init__(self)
+
+        self.extension = handler_extension_t(
+            name=name,
+            show_where=show_where,
+            show_memory_usage=show_memory_usage,
+            handler=self,
+            level=level,
+            message_width=message_width,
+            formatter=formatter,
+        )
+
+        self.FormattedLines = self.extension.FormattedLines
+
+    def emit(self, record: lggg.LogRecord, /) -> None:
+        """"""
+        if hasattr(record, SHOW_W_RULE_ATTR):
+            message = RuleAsText(record.msg)
+        else:
+            message, _ = self.FormattedLines(record, should_join_lines=True)
+        print(message)
+
+    def ShowMessage(self, message: str, /) -> None:
+        """"""
+        print(message)
+
+
+"""
+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/
+"""