springbootAI 1.8.6__tar.gz → 1.8.7__tar.gz

{springbootai-1.8.6/springbootAI.egg-info → springbootai-1.8.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 1.8.6
+Version: 1.8.7
 Summary: Python版Spring Boot框架，集成PyMyBatis ORM
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT

{springbootai-1.8.6 → springbootai-1.8.7}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 [project]
 # 发行名 springbootAI（PyPI 包名，pip install springbootAI）；导入包名仍为 spring
 name = "springbootAI"
-version = "1.8.6"
+version = "1.8.7"
 description = "Python版Spring Boot框架，集成PyMyBatis ORM"
 readme = "README.md"
 license = "MIT"

{springbootai-1.8.6 → springbootai-1.8.7}/spring/__init__.py

@@ -5,7 +5,7 @@ from .config import *
 from .utils import *
 from .main import create_app, run, SpringApplication, run_cli
 
-__version__ = "1.8.6"
+__version__ = "1.8.7"
 __author__ = "yuconggen"
 __license__ = "MIT"
 

{springbootai-1.8.6 → springbootai-1.8.7}/spring/logging/loguru_logger.py

@@ -81,11 +81,15 @@ class SpringLogger:
         self._use_loguru = _loguru_available
         self.log_format = log_format or self._default_format()
 
-        # 初始化日志配置（import 时用默认 'logs'，strict=False 允许降级保证不崩溃）
+        # import 时只设置控制台输出，不创建文件 handler（不创建 logs/ 目录）。
+        # 文件 handler 在 init_logging → reconfigure 读取用户配置后创建，
+        # 避免在 CWD 下提前生成 logs/ 目录与用户配置的 log_dir 产生双份日志。
         if self._use_loguru:
-            self._setup_loguru(strict=False)
+            loguru_logger.remove()
+            loguru_logger.add(
+                sys.stdout, format=self.log_format, level=self.level, colorize=True)
         else:
-            self._setup_std_logging(strict=False)
+            self._setup_std_logging(strict=False, enable_file=False)
 
     def reconfigure(self, level: Optional[str] = None, log_format: Optional[str] = None,
                     log_dir: Optional[str] = None, retention: Optional[str] = None,
@@ -125,12 +129,14 @@ class SpringLogger:
         if rotation is not None:
             self.rotation = rotation
         # 重建日志处理器：用户显式配置 log_dir 时 strict=True（路径错必须报错），
-        # 否则 strict=False（保留旧值/默认值时允许降级）
+        # 否则 strict=False（保留旧值/默认值时允许降级）。
+        # reconfigure 始终启用文件 handler（enable_file=True），
+        # 因为此时用户配置已读取，应该创建日志文件。
         strict_mode = log_dir_explicitly_set
         if self._use_loguru:
-            self._setup_loguru(strict=strict_mode)
+            self._setup_loguru(strict=strict_mode, enable_file=True)
         else:
-            self._setup_std_logging(strict=strict_mode)
+            self._setup_std_logging(strict=strict_mode, enable_file=True)
 
     def _validate_log_dir(self, strict: bool) -> bool:
         """校验日志目录可创建且可写入。
@@ -223,12 +229,14 @@ class SpringLogger:
             )
         return "%(asctime)s | %(levelname)-8s | %(name)s:%(funcName)s:%(lineno)d | %(message)s"
     
-    def _setup_loguru(self, strict: bool = False):
+    def _setup_loguru(self, strict: bool = False, enable_file: bool = True):
         """配置Loguru。
 
         Args:
             strict: True 时日志目录校验失败抛 ``LoggingConfigError``（用户配置路径）；
                     False 时降级为仅控制台日志（import 时默认配置，保证不崩溃）
+            enable_file: True 时添加文件 handler（创建日志目录+文件）；
+                         False 时仅控制台输出（import 时避免提前创建 logs/ 目录）
         """
         # 清除默认处理器
         loguru_logger.remove()
@@ -241,6 +249,10 @@ class SpringLogger:
             colorize=True,
         )
 
+        # enable_file=False 时只输出到控制台（import 时使用，不创建 logs/ 目录）
+        if not enable_file:
+            return
+
         # 校验日志目录：strict 模式下失败会抛异常（由 reconfigure 捕获并输出），
         # 非 strict 模式下返回 False 则仅使用控制台日志
         if not self._validate_log_dir(strict=strict):
@@ -267,12 +279,14 @@ class SpringLogger:
             encoding="utf-8",
         )
 
-    def _setup_std_logging(self, strict: bool = False):
+    def _setup_std_logging(self, strict: bool = False, enable_file: bool = True):
         """配置标准logging（fallback）。
 
         Args:
             strict: True 时日志目录校验失败抛 ``LoggingConfigError``；
                     False 时降级为仅控制台日志（import 时保证不崩溃）
+            enable_file: True 时添加文件 handler；False 时仅控制台输出
+                         （import 时避免提前创建 logs/ 目录）
         """
         self._logger = logging.getLogger("Spring")
         self._logger.setLevel(getattr(logging, self.level))
@@ -285,6 +299,10 @@ class SpringLogger:
         console_handler.setFormatter(logging.Formatter(self.log_format))
         self._logger.addHandler(console_handler)
 
+        # enable_file=False 时只输出到控制台
+        if not enable_file:
+            return
+
         # 校验日志目录
         if not self._validate_log_dir(strict=strict):
             return

{springbootai-1.8.6 → springbootai-1.8.7}/spring/utils/banner.py

@@ -11,7 +11,7 @@ class BannerPrinter:
     |_|                 |___/                                  
     """
 
-    def __init__(self, version: str = "1.8.6"):  # v1.8.6 配置严格校验 + 统一异常捕获
+    def __init__(self, version: str = "1.8.7"):  # v1.8.7 修复 import 时提前创建 logs/ 目录
         self.version = version
         self.logger = SpringLogger()
 

{springbootai-1.8.6 → springbootai-1.8.7/springbootAI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 1.8.6
+Version: 1.8.7
 Summary: Python版Spring Boot框架，集成PyMyBatis ORM
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT

{springbootai-1.8.6 → springbootai-1.8.7}/tests/test_logging_config.py

@@ -150,3 +150,37 @@ class TestLogDirStrictValidation:
         assert spring_logger.level == "DEBUG"
         # 恢复
         spring_logger.reconfigure(level="INFO")
+
+    def test_import_does_not_create_logs_directory(self, tmp_path):
+        """SpringLogger 构造时不应创建 logs/ 目录（文件 handler 延迟到 init_logging）。
+
+        回归场景：模块级 ``spring_logger = SpringLogger()`` 在 import 时执行，
+        旧代码会立即创建 ``logs/`` 目录和文件 handler，导致即使用户配置了
+        ``logging.log_dir``，CWD 下仍会多出一份 ``logs/``。
+        修复后 ``__init__`` 只添加控制台 handler，文件 handler 由
+        ``reconfigure`` (即 ``init_logging``) 创建。
+        """
+        import os
+        original_cwd = os.getcwd()
+        os.chdir(str(tmp_path))
+        try:
+            # 构造 SpringLogger（模拟 import 时的模块级构造）
+            SpringLogger._instance = None
+            import spring.logging.loguru_logger as ll
+            ll.spring_logger = SpringLogger()
+            # logs/ 目录不应被创建
+            assert not (tmp_path / 'logs').exists(), \
+                "SpringLogger() 构造时不应创建 logs/ 目录"
+        finally:
+            SpringLogger._instance = None
+            os.chdir(original_cwd)
+
+    def test_enable_file_false_does_not_create_directory(self, tmp_path):
+        """_setup_loguru(enable_file=False) 不应创建日志目录。"""
+        SpringLogger._instance = None
+        import spring.logging.loguru_logger as ll
+        logger = SpringLogger()
+        logger.log_dir = str(tmp_path / 'should_not_exist')
+        logger._setup_loguru(strict=False, enable_file=False)
+        assert not (tmp_path / 'should_not_exist').exists(), \
+            "enable_file=False 时不应创建日志目录"