Python Logoru介绍

loguru 是一个非常方便且功能强大的 Python 日志库，能让日志记录变得简单和直观。

主要特点

1. 简单易用：相比于内置的 logging 模块，loguru 的 API 更加简洁，易于使用。
2. 自动化：自动处理日志格式、文件管理、异常捕获等。
3. 灵活配置：支持多种输出格式、文件轮转、过滤器等高级功能。
4. 多线程安全：支持多线程和异步应用程序的日志记录。
5. 丰富的功能：支持丰富的日志级别、异常信息、上下文信息等。

基本用法

安装

可以通过 pip 安装 loguru：

pip install loguru

引入

from loguru import logger

基本配置

logger.add("file.log", rotation="1 MB")  # 自动按文件大小轮转

日志级别

loguru 提供了多个日志级别，默认包含以下几种：

• TRACE（0）
• DEBUG（10）
• INFO（20）
• SUCCESS（25）
• WARNING（30）
• ERROR（40）
• CRITICAL（50）

示例：

logger.debug("This is a debug message")
logger.info("This is an info message")
logger.warning("This is a warning message")
logger.error("This is an error message")
logger.critical("This is a critical message")

捕获异常

使用 logger 捕获异常时，可以输出详细的 traceback：

try:
    1 / 0  # 故意造成除以零错误
except ZeroDivisionError:
    logger.error("An error occurred:\n{}", traceback.format_exc())

日志文件管理

loguru 支持日志文件的轮转和压缩：

logger.add("file_{time}.log", rotation="1 day", retention="7 days", compression="zip")

这将每天创建一个新日志文件，保留 7 天，并将旧日志文件压缩为 ZIP 格式。

添加上下文信息

可以使用 logger.contextualize() 添加上下文信息：

with logger.contextualize(user="user1"):
    logger.info("User logged in")

这将使得日志信息中包含用户上下文。

高级功能

1. 过滤器：可以根据日志级别或其他条件过滤日志输出。

logger.add("filtered.log", filter=lambda record: record["level"].name == "ERROR")

2. 格式化：可以自定义日志的输出格式。

logger.add("formatted.log", format="{time} {level} {message}")

3. 异步支持：在异步程序中使用 loguru 也非常简单。

总结

loguru 是一个功能强大且易于使用的日志库，适合各种规模的项目。无论是简单的脚本还是复杂的应用程序，它都能提供方便的日志记录功能。通过灵活的配置和强大的功能，loguru 可以帮助开发者轻松地处理日志记录任务。