plonex 0.0.1a0__py3-none-any.whl

plonex/__init__.py

@@ -0,0 +1 @@
+from ._logger import logger  # noqa: F401

plonex/_logger.py

@@ -0,0 +1,49 @@
+from rich.console import Console
+from rich.logging import RichHandler
+
+import logging
+
+FORMAT: str = "%(message)s"
+logging.basicConfig(
+    level=logging.INFO,
+    format=FORMAT,
+    datefmt="[%X]",
+    handlers=[
+        RichHandler(
+            console=Console(stderr=True),
+            markup=True,
+            show_path=False,
+            show_time=False,
+        ),
+    ],
+)
+
+logger: logging.Logger = logging.getLogger("plonex")
+logger.setLevel(logging.INFO)
+
+_warning_once_keys: set[str] = set()
+
+
+def warning_once(
+    logger_instance: logging.Logger,
+    key: str,
+    message: str,
+    *args,
+) -> bool:
+    """Log a warning once for the provided key.
+
+    Returns True when the warning is emitted, False when skipped.
+    """
+    if key in _warning_once_keys:
+        return False
+    _warning_once_keys.add(key)
+    logger_instance.warning(message, *args)
+    return True
+
+
+def reset_warning_once() -> None:
+    """Clear all previously seen warning-once keys.
+
+    Intended for use in test teardown to prevent state leaking between tests.
+    """
+    _warning_once_keys.clear()