kitty-logger 0.2.0.dev5__tar.gz → 0.2.0.dev6__tar.gz

{kitty_logger-0.2.0.dev5/src/kitty_logger.egg-info → kitty_logger-0.2.0.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kitty_logger
-Version: 0.2.0.dev5
+Version: 0.2.0.dev6
 Summary: Cross-process logging via a dedicated log server process and SocketHandler.
 Author: Kitty
 License: MIT

{kitty_logger-0.2.0.dev5 → kitty_logger-0.2.0.dev6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kitty_logger"
-version = "0.2.0.dev5"
+version = "0.2.0.dev6"
 description = "Cross-process logging via a dedicated log server process and SocketHandler."
 readme = "README.md"
 requires-python = ">=3.12"

{kitty_logger-0.2.0.dev5 → kitty_logger-0.2.0.dev6}/src/kitty_logger/__init__.py

@@ -42,4 +42,4 @@ __all__ = [
     "PRESETS",
     "get_preset",
 ]
-__version__ = "0.2.0.dev5"
+__version__ = "0.2.0.dev6"

{kitty_logger-0.2.0.dev5 → kitty_logger-0.2.0.dev6}/src/kitty_logger/_client.py

@@ -110,7 +110,11 @@ def _ensure_kitty_handler() -> logging.Logger:
     return kitty
 
 
-def getLogger(name: str | None = None) -> logging.Logger:
+def getLogger(
+    name: str | None = None,
+    *,
+    level: int | str | None = None,
+) -> logging.Logger:
     """返回挂在 ``kitty`` 命名空间下的 logger。
 
     可在 :func:`kitty_logger.setup_logging` 之前调用——例如在模块顶层
@@ -126,7 +130,14 @@ def getLogger(name: str | None = None) -> logging.Logger:
         会被转换为 ``logging.getLogger("kitty.foo")``——日志记录里
         ``%(name)s`` 字段会带 ``kitty.`` 前缀，这是有意保留的标记，方便
         和第三方库日志区分。
+    :param level: 可选；为该 logger 设置 level。等价于 ``getLogger(name)``
+        之后再调 ``.setLevel(level)``。``None`` 表示保持默认 ``NOTSET``，
+        向上沿用 ``kitty`` 根 logger 的级别。支持 ``logging.DEBUG`` 这样
+        的整数，也支持 ``"DEBUG"`` 这样的级别名（大小写不敏感）。
     """
     _ensure_kitty_handler()
     full = KITTY_NAMESPACE if not name else f"{KITTY_NAMESPACE}.{name}"
-    return logging.getLogger(full)
+    logger = logging.getLogger(full)
+    if level is not None:
+        logger.setLevel(level)
+    return logger

{kitty_logger-0.2.0.dev5 → kitty_logger-0.2.0.dev6/src/kitty_logger.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kitty_logger
-Version: 0.2.0.dev5
+Version: 0.2.0.dev6
 Summary: Cross-process logging via a dedicated log server process and SocketHandler.
 Author: Kitty
 License: MIT

{kitty_logger-0.2.0.dev5 → kitty_logger-0.2.0.dev6}/tests/test_kitty_logger.py

@@ -132,6 +132,19 @@ def test_get_logger_before_setup_works(tmp_path: Path):
     _wait_for_lines(log_path, lambda t: "late-binding-ok" in t)
 
 
+def test_get_logger_level_param():
+    """``level=`` 参数等价于 ``.setLevel(level)``，支持整数与级别名。"""
+    log_int = kitty_logger.getLogger("lvl.int", level=logging.DEBUG)
+    assert log_int.level == logging.DEBUG
+
+    log_str = kitty_logger.getLogger("lvl.str", level="WARNING")
+    assert log_str.level == logging.WARNING
+
+    # 不传 level：保持默认 NOTSET，沿用祖先级别。
+    log_default = kitty_logger.getLogger("lvl.default")
+    assert log_default.level == logging.NOTSET
+
+
 def test_non_loopback_raises(tmp_path: Path):
     # 非 loopback 必须直接拒绝；0.0.0.0 在大多数系统都能 bind，但我们要在
     # bind 之前就 ValueError 掉。