sdpy-kit 0.4.0__tar.gz → 0.4.1__tar.gz

{sdpy_kit-0.4.0 → sdpy_kit-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sdpy-kit
-Version: 0.4.0
+Version: 0.4.1
 Summary: SDPY Kit——统一数据库访问层（PG/MySQL/SQLite）与 AI/Redis/文件/文档/向量工具集
 Author-email: Clark <changhongyuan@126.com>
 License-Expression: MIT

{sdpy_kit-0.4.0 → sdpy_kit-0.4.1}/kit/__init__.py

@@ -23,7 +23,7 @@ Author: Clark Chang
 数据库访问通过 kit.db 子包提供（基于 SQLModel）。
 """
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"
 
 from kit.db import (
     MYSQL,

{sdpy_kit-0.4.0 → sdpy_kit-0.4.1}/kit/config/log_config.py

@@ -24,6 +24,7 @@ Author: Clark Chang
 import logging
 import os
 import sys
+import threading
 from logging.handlers import RotatingFileHandler
 
 from kit.config.kit_config import get_settings
@@ -49,6 +50,43 @@ def ensure_log_dir(log_dir: str) -> None:
     os.makedirs(log_dir, exist_ok=True)
 
 
+# 同一日志文件路径共享单例文件 handler：
+# 进程内该文件仅一个句柄，避免 Windows 下多句柄占用导致轮转必失败（WinError 32）。
+# 参数策略 first-wins：maxBytes / backupCount / formatter 以首个创建者为准。
+_file_handlers: dict[str, RotatingFileHandler] = {}
+_file_handlers_lock = threading.Lock()
+
+
+def _file_handler_cache_key(log_file_path: str) -> str:
+    """计算共享 handler 缓存 key（归一 Windows 大小写、分隔符与相对路径）"""
+    return os.path.normcase(os.path.abspath(log_file_path))
+
+
+def _get_shared_file_handler(
+    log_file_path: str, max_bytes: int, backup_count: int, formatter: logging.Formatter
+) -> RotatingFileHandler:
+    """获取指定日志文件路径的共享文件 handler（不存在则创建）"""
+    key = _file_handler_cache_key(log_file_path)
+    with _file_handlers_lock:
+        handler = _file_handlers.get(key)
+        if handler is None:
+            handler = RotatingFileHandler(
+                log_file_path,
+                maxBytes=max_bytes,
+                backupCount=backup_count,
+                encoding="utf-8",
+            )
+            handler.setFormatter(formatter)
+            _file_handlers[key] = handler
+        return handler
+
+
+def _reset_file_handlers() -> None:
+    """复位共享 handler 缓存（仅供测试隔离使用，不进 __all__）"""
+    with _file_handlers_lock:
+        _file_handlers.clear()
+
+
 def setup_logger(
     name: str | None = None,
     log_level: str | None = None,
@@ -77,13 +115,12 @@ def setup_logger(
     if settings.LOG_TO_FILE:
         ensure_log_dir(settings.LOG_DIR)
         log_file_path = log_file or os.path.join(settings.LOG_DIR, settings.LOG_FILE)
-        file_handler = RotatingFileHandler(
+        file_handler = _get_shared_file_handler(
             log_file_path,
-            maxBytes=max_bytes,
-            backupCount=backup_count,
-            encoding="utf-8",
+            max_bytes=max_bytes,
+            backup_count=backup_count,
+            formatter=formatter,
         )
-        file_handler.setFormatter(formatter)
         logger.addHandler(file_handler)
 
     return logger