aury-boot 0.0.8__py3-none-any.whl → 0.0.10__py3-none-any.whl

aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.8'
-__version_tuple__ = version_tuple = (0, 0, 8)
+__version__ = version = '0.0.10'
+__version_tuple__ = version_tuple = (0, 0, 10)
 
 __commit_id__ = commit_id = None

aury/boot/application/app/base.py

@@ -203,6 +203,7 @@ class FoundationApp(FastAPI):
         title: str = "Aury Service",
         version: str = "1.0.0",
         description: str | None = None,
+        intercept_loggers: list[str] | None = None,
         **kwargs: Any,
     ) -> None:
         """初始化应用。
@@ -212,6 +213,9 @@ class FoundationApp(FastAPI):
             title: 应用标题
             version: 应用版本
             description: 应用描述
+            intercept_loggers: 额外需要拦截的标准 logging logger 名称列表，
+                会追加到框架默认列表 (uvicorn, sqlalchemy.engine 等)。
+                也可通过配置 LOG__INTERCEPT_LOGGERS 设置。
             **kwargs: 传递给 FastAPI 的其他参数
         """
         # 加载配置
@@ -223,6 +227,11 @@ class FoundationApp(FastAPI):
         frame = sys._getframe(1)
         self._caller_module = frame.f_globals.get("__name__", "__main__")
 
+        # 合并 intercept_loggers：参数 + 配置
+        merged_intercept = list(config.log.intercept_loggers)
+        if intercept_loggers:
+            merged_intercept.extend(intercept_loggers)
+
         # 初始化日志（必须在其他操作之前）
         setup_logging(
             log_level=config.log.level,
@@ -232,6 +241,7 @@ class FoundationApp(FastAPI):
             retention_days=config.log.retention_days,
             enable_file_rotation=config.log.enable_file_rotation,
             enable_console=config.log.enable_console,
+            intercept_loggers=merged_intercept,
         )
         
         # 注册 access 日志（HTTP 请求日志）

aury/boot/application/config/settings.py

@@ -372,6 +372,14 @@ class LogSettings(BaseModel):
         default=False,
         description="是否记录 WebSocket 消息内容（注意性能和敏感数据）"
     )
+    intercept_loggers: list[str] = Field(
+        default_factory=list,
+        description=(
+            "额外需要由 loguru 接管的标准 logging logger 名称列表。"
+            "框架默认已拦截 uvicorn、uvicorn.error、uvicorn.access、sqlalchemy.engine，"
+            "此处配置会追加到默认列表。"
+        ),
+    )
 
 
 class ServiceSettings(BaseModel):

aury/boot/commands/templates/project/env_templates/log.tpl

@@ -16,3 +16,5 @@
 # LOG__ENABLE_FILE_ROTATION=true
 # 是否输出日志到控制台
 # LOG__ENABLE_CONSOLE=true
+# 额外需要拦截的标准 logging logger (默认已拦截 uvicorn、sqlalchemy.engine)
+# LOG__INTERCEPT_LOGGERS=["my_package", "third_party_lib"]

aury/boot/commands/templates/project/env_templates/rpc.tpl

@@ -2,7 +2,7 @@
 # =============================================================================
 # RPC 客户端配置 (RPC_CLIENT__)
 # =============================================================================
-# 服务地址映射 {service_name: url}
+# 服务地址映射 {{service_name: url}}
 # RPC_CLIENT__SERVICES={{"user-service": "http://localhost:8001"}}
 # 默认超时时间（秒）
 # RPC_CLIENT__DEFAULT_TIMEOUT=30

aury/boot/commands/templates/project/main.py.tpl

@@ -25,11 +25,15 @@ config = AppConfig()
 #   - HEALTH_CHECK_PATH: 健康检查路径（默认 /api/health）
 #   - HEALTH_CHECK_ENABLED: 是否启用（默认 true）
 #
+# 日志拦截：
+#   框架默认拦截 uvicorn/sqlalchemy.engine，可通过 intercept_loggers 追加额外的 logger
+#
 app = FoundationApp(
     title="{project_name}",
     version="0.1.0",
     description="{project_name} - 基于 Aury Boot",
     config=config,
+    intercept_loggers=[],
 )
 
 # 注册 API 路由

aury/boot/common/logging/__init__.py

@@ -44,11 +44,14 @@ from aury.boot.common.logging.format import (
     log_exception,
 )
 from aury.boot.common.logging.setup import (
+    DEFAULT_INTERCEPT_LOGGERS,
     register_log_sink,
+    setup_intercept,
     setup_logging,
 )
 
 __all__ = [
+    "DEFAULT_INTERCEPT_LOGGERS",
     "ServiceContext",
     "format_exception_java_style",
     "get_class_logger",
@@ -63,6 +66,7 @@ __all__ = [
     "register_request_context",
     "set_service_context",
     "set_trace_id",
+    "setup_intercept",
     "setup_logging",
 ]
 

aury/boot/common/logging/setup.py

@@ -5,6 +5,7 @@
 
 from __future__ import annotations
 
+import logging
 import os
 from typing import Any
 
@@ -88,6 +89,70 @@ def register_log_sink(
     logger.debug(f"注册日志 sink: {name} (filter_key={filter_key})")
 
 
+# 默认拦截的标准 logging 日志记录器
+# - uvicorn: Uvicorn 服务器日志
+# - uvicorn.error: Uvicorn 错误日志
+# - sqlalchemy.engine: SQLAlchemy SQL 语句日志
+# 注意：uvicorn.access 不拦截，因为框架有自己的 RequestLoggingMiddleware
+DEFAULT_INTERCEPT_LOGGERS = [
+    "uvicorn",
+    "uvicorn.error",
+    "sqlalchemy.engine",
+]
+
+
+class _InterceptHandler(logging.Handler):
+    """将标准 logging 日志转发到 loguru 的处理器。"""
+
+    def emit(self, record: logging.LogRecord) -> None:
+        # 获取对应的 loguru 级别
+        try:
+            level = logger.level(record.levelname).name
+        except ValueError:
+            level = record.levelno
+
+        # 查找调用者的帧深度
+        frame, depth = logging.currentframe(), 2
+        while frame and frame.f_code.co_filename == logging.__file__:
+            frame = frame.f_back
+            depth += 1
+
+        logger.opt(depth=depth, exception=record.exc_info).log(
+            level, record.getMessage()
+        )
+
+
+def _setup_intercept(logger_names: list[str]) -> None:
+    """让 loguru 接管指定的标准 logging 日志记录器。"""
+    handler = _InterceptHandler()
+    for name in logger_names:
+        std_logger = logging.getLogger(name)
+        std_logger.handlers = [handler]
+        std_logger.setLevel(logging.DEBUG)
+        std_logger.propagate = False
+
+
+def setup_intercept(logger_names: list[str] | None = None) -> None:
+    """拦截标准 logging 日志记录器并转发到 loguru。
+
+    用于独立脚本/CLI 入口点（不使用 FoundationApp 时）。
+    FoundationApp 会自动调用此函数，无需手动调用。
+
+    Args:
+        logger_names: 额外需要拦截的 logger 名称列表，
+            会追加到默认列表 (uvicorn, sqlalchemy.engine 等)。
+
+    使用示例::
+
+        from aury.boot.common.logging import setup_logging, setup_intercept
+
+        setup_logging(log_level="DEBUG")
+        setup_intercept(["my_package", "third_party_lib"])
+    """
+    to_intercept = DEFAULT_INTERCEPT_LOGGERS + (logger_names or [])
+    _setup_intercept(to_intercept)
+
+
 def setup_logging(
     log_level: str = "INFO",
     log_dir: str | None = None,
@@ -97,6 +162,7 @@ def setup_logging(
     retention_days: int = 7,
     rotation_size: str = "50 MB",
     enable_console: bool = True,
+    intercept_loggers: list[str] | None = None,
 ) -> None:
     """设置日志配置。
 
@@ -119,6 +185,8 @@ def setup_logging(
         retention_days: 日志保留天数（默认：7 天）
         rotation_size: 单文件大小上限（默认：50 MB）
         enable_console: 是否输出到控制台
+        intercept_loggers: 额外需要拦截的标准 logging logger 名称列表，
+            会追加到默认列表 (uvicorn, sqlalchemy.engine 等)。
     """
     log_level = log_level.upper()
     log_dir = log_dir or "logs"
@@ -205,10 +273,16 @@ def setup_logging(
             filter=lambda record, c=ctx: record["extra"].get("service") == c,
         )
 
+    # 拦截标准 logging 日志并转发到 loguru
+    to_intercept = DEFAULT_INTERCEPT_LOGGERS + (intercept_loggers or [])
+    _setup_intercept(to_intercept)
+
     logger.info(f"日志系统初始化完成 | 服务: {service_type} | 级别: {log_level} | 目录: {log_dir}")
 
 
 __all__ = [
+    "DEFAULT_INTERCEPT_LOGGERS",
     "register_log_sink",
+    "setup_intercept",
     "setup_logging",
 ]

{aury_boot-0.0.8.dist-info → aury_boot-0.0.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.8
+Version: 0.0.10
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2

{aury_boot-0.0.8.dist-info → aury_boot-0.0.10.dist-info}/RECORD

@@ -1,5 +1,5 @@
 aury/boot/__init__.py,sha256=pCno-EInnpIBa1OtxNYF-JWf9j95Cd2h6vmu0xqa_-4,1791
-aury/boot/_version.py,sha256=j-ar4gJGiWIawqKXhvv9hGJWLfwu0tISl-0GV97B7a0,704
+aury/boot/_version.py,sha256=qWM7tuFjLDSZffhqImvB3QeSymOYGxPQLtsW7Q2jQD0,706
 aury/boot/application/__init__.py,sha256=0o_XmiwFCeAu06VHggS8I1e7_nSMoRq0Hcm0fYfCywU,3071
 aury/boot/application/adapter/__init__.py,sha256=e1bcSb1bxUMfofTwiCuHBZJk5-STkMCWPF2EJXHQ7UU,3976
 aury/boot/application/adapter/base.py,sha256=Ar_66fiHPDEmV-1DKnqXKwc53p3pozG31bgTJTEUriY,15763
@@ -8,13 +8,13 @@ aury/boot/application/adapter/decorators.py,sha256=yyGu_16bWWUiO36gxCeQWgG0DN19p
 aury/boot/application/adapter/exceptions.py,sha256=Kzm-ytRxdUnSMIcWCSOHPxo4Jh_A6YbyxlOVIUs-5F4,6183
 aury/boot/application/adapter/http.py,sha256=4TADsSzdSRU63307dmmo-2U_JpVP12mwTFy66B5Ps-w,10759
 aury/boot/application/app/__init__.py,sha256=I8FfCKDuDQsGzAK6BevyfdtAwieMUVYu6qgVQzBazpE,830
-aury/boot/application/app/base.py,sha256=5v7wtksCCyp_QYVpxddd9xSujoVp1zX9pP6CPy4vwUE,16711
+aury/boot/application/app/base.py,sha256=wBF7q_kZp5uWUeWy95oElBAsc43xJ4RZ1s6tMGIiCac,17253
 aury/boot/application/app/components.py,sha256=tt4a4ZVcRJZbvStj5W9AYf9omGqKVu0qFu5pn1q2VSU,20312
 aury/boot/application/app/middlewares.py,sha256=BXe2H14FHzJUVpQM6DZUm-zfZRXSXIi1QIZ4_3izfHw,3306
 aury/boot/application/app/startup.py,sha256=bkRT4cCzXPnTOBSNs-TLcKvFGwqBgwXeO8_gQq9Gc1s,7895
 aury/boot/application/config/__init__.py,sha256=Dd-myRSBCM18DXXsi863h0cJG5VFrI10xMRtjnvelGo,1894
 aury/boot/application/config/multi_instance.py,sha256=RXSp-xP8-bKMDEhq3SeL7T3lS8-vpRlvBEVBuZVjVK4,6475
-aury/boot/application/config/settings.py,sha256=n2VorLbdmiY2uKSIbZJYSrEKkUq043FpnGWaXIxhWSI,29195
+aury/boot/application/config/settings.py,sha256=CckslmXl0H1XN58DKK4IBK9WqKX72nhDSIpx0dxtFPA,29544
 aury/boot/application/constants/__init__.py,sha256=DCXs13_VVaQWHqO-qpJoZwRd7HIexiirtw_nu8msTXE,340
 aury/boot/application/constants/components.py,sha256=hDRs3YxpnfIFcGaUa1DYqBRwmV2_dceOlcCXabHE3fk,1006
 aury/boot/application/constants/scheduler.py,sha256=S77FBIvHlyruvlabRWZJ2J1YAs2xWXPQI2yuGdGUDNA,471
@@ -66,7 +66,7 @@ aury/boot/commands/templates/project/admin_console_init.py.tpl,sha256=K81L14thyE
 aury/boot/commands/templates/project/config.py.tpl,sha256=ZCZHHvTOv3dm0VcJqmqkvoIEzKoBBcfne_UYnqimc7s,869
 aury/boot/commands/templates/project/conftest.py.tpl,sha256=chbETK81Hy26cWz6YZ2cFgy7HbnABzYCqeyMzgpa3eI,726
 aury/boot/commands/templates/project/gitignore.tpl,sha256=OI0nt9u2E9EC-jAMoh3gpqamsWo18uDgyPybgee_snQ,3053
-aury/boot/commands/templates/project/main.py.tpl,sha256=qKKgO3btMPIpPfb-iyCD4AMEYMUunhq6GJyA2QplGZI,922
+aury/boot/commands/templates/project/main.py.tpl,sha256=Q61ve3o1VkNPv8wcQK7lUosne18JWYeItxoXVNNoYJM,1070
 aury/boot/commands/templates/project/aury_docs/00-overview.md.tpl,sha256=8Aept3yEAe9cVdRvkddr_oEF-lr2riPXYRzBuw_6DBA,2138
 aury/boot/commands/templates/project/aury_docs/01-model.md.tpl,sha256=1mQ3hGDxqEZjev4CD5-3dzYRFVonPNcAaStI1UBEUyM,6811
 aury/boot/commands/templates/project/aury_docs/02-repository.md.tpl,sha256=yfKPYZ7x74BEF7wFp9u3S7xKr4Ld9MqXOItGZo5NM9Q,6819
@@ -89,9 +89,9 @@ aury/boot/commands/templates/project/env_templates/_header.tpl,sha256=Pt0X_I25o1
 aury/boot/commands/templates/project/env_templates/admin.tpl,sha256=wWt3iybOpBHtuw6CkoUJ1bzEL0aNgOzKDEkMKhI2oag,2032
 aury/boot/commands/templates/project/env_templates/cache.tpl,sha256=_sK-p_FECj4mVvggNvgb4Wu0yGii0Ocz560syG7DU2c,498
 aury/boot/commands/templates/project/env_templates/database.tpl,sha256=2lWzTKt4X0SpeBBCkrDV90Di4EfoAuqYzhVsh74vTUI,907
-aury/boot/commands/templates/project/env_templates/log.tpl,sha256=Rw1yQ9xYvjoXHEqahDuCYzuaV2A2U9G98gmZ85k30RQ,604
+aury/boot/commands/templates/project/env_templates/log.tpl,sha256=x5rkrEFJISH0gaCcr-wTCbDYtyFnlLNJpY789fqjZgc,754
 aury/boot/commands/templates/project/env_templates/messaging.tpl,sha256=ICRLGw2FtJ0bNtkHnpy0CFyILqxOfFLbfejdFLJuuo8,1719
-aury/boot/commands/templates/project/env_templates/rpc.tpl,sha256=Eh3UeBl5SWmvclAPt9TgVVV0pvqwr2BsuTNrY1lbgi8,1161
+aury/boot/commands/templates/project/env_templates/rpc.tpl,sha256=FhweCFakawGLSs01a_BkmZo11UhWax2-VCBudHj68WA,1163
 aury/boot/commands/templates/project/env_templates/scheduler.tpl,sha256=c8Grcs1rgBB58RHlxqmDMPHQl8BnbcqNW473ctmsojU,752
 aury/boot/commands/templates/project/env_templates/service.tpl,sha256=b-a2GyRyoaunbDj_2kaSw3OFxcugscmPvUBG7w0XO8c,710
 aury/boot/commands/templates/project/env_templates/storage.tpl,sha256=x983u0Y2AFTTO2JqtPsYmYKBNGXtGCknA4iHv0k2wSA,1330
@@ -104,11 +104,11 @@ aury/boot/common/__init__.py,sha256=MhNP3c_nwx8CyDkDF6p1f4DcTZ1CZZScg66FWdbdaZI,
 aury/boot/common/exceptions/__init__.py,sha256=aS3rIXWc5qNNJbfMs_PNmBlFsyNdKUMErziNMd1yoB8,3176
 aury/boot/common/i18n/__init__.py,sha256=2cy4kteU-1YsAHkuMDTr2c5o4G33fvtYUGKtzEy1Q6c,394
 aury/boot/common/i18n/translator.py,sha256=_vEDL2SjEI1vwMNHbnJb0xErKUPLm7VmhyOuMBeCqRM,8412
-aury/boot/common/logging/__init__.py,sha256=lRbIZCeKavzO90Fx7FrGW1AAqAg8TX5VrDo0pWA4Af0,1661
+aury/boot/common/logging/__init__.py,sha256=s6kKuAADP_mE7esZjJS5yrJwqgV24Lzn39BDv9s_HOc,1769
 aury/boot/common/logging/context.py,sha256=WHPpfqHH0HIbaSPdpESjB5kV344ygDfrdrcOmDXz1JI,3842
 aury/boot/common/logging/decorators.py,sha256=UaGMhRJdARNJ2VgCuRwaNX0DD5wIc1gAl6NDj7u8K2c,3354
 aury/boot/common/logging/format.py,sha256=V1VoZCPFAaAXy20n3WehOsZGTHuboYMHnSFGa0GxhdU,9648
-aury/boot/common/logging/setup.py,sha256=XPeoyFeIrsX8GbAFhBMccm_t1Zlh7_RcDl4_CqRLZtk,6864
+aury/boot/common/logging/setup.py,sha256=ZPxOHJD8Fw4KxKPgsf8ZHQ2mWuXxKh4EJtXXvGY7Hgo,9422
 aury/boot/contrib/__init__.py,sha256=fyk_St9VufIx64hsobv9EsOYzb_T5FbJHxjqtPds4g8,198
 aury/boot/contrib/admin_console/__init__.py,sha256=HEesLFrtYtBFWTDrh5H3mR-4V4LRg5N4a2a1C4-Whgs,445
 aury/boot/contrib/admin_console/auth.py,sha256=_goyjZ8Clssvmy8g84svenGfBqCe9OC5pIvCjIzt42g,4706
@@ -191,7 +191,7 @@ aury/boot/testing/client.py,sha256=KOg1EemuIVsBG68G5y0DjSxZGcIQVdWQ4ASaHE3o1R0,4
 aury/boot/testing/factory.py,sha256=8GvwX9qIDu0L65gzJMlrWB0xbmJ-7zPHuwk3eECULcg,5185
 aury/boot/toolkit/__init__.py,sha256=AcyVb9fDf3CaEmJPNkWC4iGv32qCPyk4BuFKSuNiJRQ,334
 aury/boot/toolkit/http/__init__.py,sha256=zIPmpIZ9Qbqe25VmEr7jixoY2fkRbLm7NkCB9vKpg6I,11039
-aury_boot-0.0.8.dist-info/METADATA,sha256=aMQMBHNb0zE5c8eVaEHZSAYEdtCiCKd3Ea5VOuX5_lg,7980
-aury_boot-0.0.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-aury_boot-0.0.8.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
-aury_boot-0.0.8.dist-info/RECORD,,
+aury_boot-0.0.10.dist-info/METADATA,sha256=i5glHELenzosPJRyoJBQcn9ujPccCjMvo9BmnNAqX6E,7981
+aury_boot-0.0.10.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aury_boot-0.0.10.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
+aury_boot-0.0.10.dist-info/RECORD,,