certflow.utils.logger module

日志配置工具模块

基于Loguru库提供统一的日志配置，支持控制台输出和文件轮转输出。 使用单例模式确保全局只有一个日志实例。

支持通过 config.yaml 的 logging.debug_modules 配置模块级 DEBUG 屏蔽（黑名单模式）。

certflow.utils.logger.setup_logger(log_path='logs/certflow.log', console_level='INFO', file_level='DEBUG', debug_modules=None)

配置日志系统(兼容旧接口)

提供简化的函数式接口，用于快速配置日志系统。

参数:

• log_path (str) -- 日志文件路径，默认为"logs/certflow.log"

• console_level (str) -- 控制台输出级别，默认为"INFO"

• file_level (str) -- 文件输出级别，默认为"DEBUG"

• debug_modules (list[str] | None) -- DEBUG 模块黑名单，["*"] 屏蔽全部，[] 全部输出

返回:

配置好的日志实例

返回类型:

loguru.Logger

示例

>>> from certflow.utils.logger import setup_logger
>>>
>>> # 使用默认配置
>>> logger = setup_logger()
>>>
>>> # 自定义配置
>>> logger = setup_logger(
...     log_path="logs/app.log",
...     console_level="DEBUG",
...     file_level="INFO"
... )
>>> logger.info("应用启动成功")

certflow.utils.logger.get_logger()

获取全局日志实例

获取已配置的全局日志实例，如果尚未配置则使用默认配置。

返回:

全局日志实例

返回类型:

loguru.Logger

示例

>>> from certflow.utils.logger import get_logger
>>>
>>> logger = get_logger()
>>> logger.info("这是一条信息日志")
>>> logger.error("这是一条错误日志")