zendev-log 0.2.0__py3-none-any.whl

zendev/log/__init__.py

@@ -0,0 +1,38 @@
+"""Loguru configuration for all projects."""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from loguru import logger
+
+_configured = False
+
+# TODO: Move this generic helper only after existing ``zendev.setup_log`` users have a documented migration path.
+
+
+def setup_log(*, verbose: bool = False, json: bool = False) -> int | None:
+    """Configure loguru for CLI usage. Safe to call multiple times.
+
+    Args:
+        verbose: If True, set log level to DEBUG. Defaults to False (INFO).
+        json: If True, use JSON serialization (CI-friendly). Defaults to False.
+
+    Returns:
+        The handler id on first call, ``None`` on subsequent calls.
+    """
+    global _configured
+    if _configured:
+        return None
+    _configured = True
+
+    logger.remove()
+
+    env_level = os.environ.get("ZENDEV_LOG_LEVEL")
+    level = env_level.upper() if env_level else ("DEBUG" if verbose else "INFO")
+
+    if json:
+        return logger.add(sys.stderr, level=level, serialize=True)
+    fmt = "<green>{time:HH:mm:ss.SSS}</green> | <level>{level: <7}</level> | <level>{message}</level>"
+    return logger.add(sys.stderr, format=fmt, level=level, colorize=True)

zendev_log-0.2.0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.5
+Name: zendev-log
+Version: 0.2.0
+Summary: Small Loguru configuration helper for command-line applications
+Project-URL: Homepage, https://github.com/zendev-lab/zendev
+Project-URL: Issues, https://github.com/zendev-lab/zendev/issues
+Project-URL: Repository, https://github.com/zendev-lab/zendev
+License-Expression: MIT
+Requires-Python: >=3.12
+Requires-Dist: loguru>=0.7
+Description-Content-Type: text/markdown
+
+# zendev-log
+
+`zendev-log` provides a small, idempotent Loguru setup helper for command-line
+applications.
+
+```console
+$ uv add zendev-log
+```
+
+```python
+from zendev.log import setup_log
+
+setup_log(verbose=True)
+```
+
+Version 0.2.0 removes the former `from zendev import setup_log` re-export.

zendev_log-0.2.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+zendev/log/__init__.py,sha256=j9cwbuTCW0m0-Gw-3fEHLSdbwQCkubwCW_VLJYIxTFE,1166
+zendev/log/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+zendev_log-0.2.0.dist-info/METADATA,sha256=jHxDK52BoIeJppOLstkHdWgZ7nYYrGrs94JcYO_nv-k,722
+zendev_log-0.2.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+zendev_log-0.2.0.dist-info/RECORD,,

zendev_log-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any