Logging API

可插拔日志系统，支持多种日志库。

LoggerAdapter (抽象基类)

LoggerAdapter

Bases: ABC

日志适配器抽象基类。

用户可以实现此接口来适配自己喜欢的日志库。

debug(message, **kwargs) abstractmethod

记录调试信息。

info(message, **kwargs) abstractmethod

记录一般信息。

warning(message, **kwargs) abstractmethod

记录警告信息。

error(message, **kwargs) abstractmethod

记录错误信息。

exception(message, **kwargs) abstractmethod

记录异常信息(包含堆栈)。

StructlogAdapter

StructlogAdapter(logger_name='chronflow')

Bases: LoggerAdapter

Structlog 日志适配器(默认)。

初始化 structlog 适配器。

参数

logger_name: 日志记录器名称

debug(message, **kwargs)

记录调试信息。

info(message, **kwargs)

记录一般信息。

warning(message, **kwargs)

记录警告信息。

error(message, **kwargs)

记录错误信息。

exception(message, **kwargs)

记录异常信息。

LoguruAdapter

LoguruAdapter(logger)

Bases: LoggerAdapter

Loguru 日志适配器。

示例

from loguru import logger from chronflow.logging import LoguruAdapter

scheduler = Scheduler() scheduler.set_logger(LoguruAdapter(logger))

初始化 loguru 适配器。

参数

logger: loguru.logger 实例

debug(message, **kwargs)

记录调试信息。

info(message, **kwargs)

记录一般信息。

warning(message, **kwargs)

记录警告信息。

error(message, **kwargs)

记录错误信息。

exception(message, **kwargs)

记录异常信息。

StdlibAdapter

StdlibAdapter(logger)

Bases: LoggerAdapter

Python 标准库 logging 适配器。

示例

import logging from chronflow.logging import StdlibAdapter

logger = logging.getLogger("myapp") scheduler = Scheduler() scheduler.set_logger(StdlibAdapter(logger))

初始化标准库适配器。

参数

logger: logging.Logger 实例

debug(message, **kwargs)

记录调试信息。

info(message, **kwargs)

记录一般信息。

warning(message, **kwargs)

记录警告信息。

error(message, **kwargs)

记录错误信息。

exception(message, **kwargs)

记录异常信息。

NoOpAdapter

NoOpAdapter

Bases: LoggerAdapter

空操作日志适配器,不输出任何日志。

用于完全禁用日志输出。

debug(message, **kwargs)

不记录。

info(message, **kwargs)

不记录。

warning(message, **kwargs)

不记录。

error(message, **kwargs)

不记录。

exception(message, **kwargs)

不记录。