这个项目能做什么
Loguru 是一个 Python 日志库,旨在消除传统日志设置的复杂性。它提供了一个可通过 `from loguru import logger` 访问的预配置 logger,无需配置 handler、formatter 或 filter 即可开始使用。可以使用 `logger.debug()` 或 `logger.info()` 等方法立即写入日志消息,默认输出到 stderr。
关键特性包括:便捷的文件日志记录,支持自动轮转(按大小、时间或时长)、保留策略和压缩;兼容 `str.format()` 的现代大括号风格字符串格式化;终端自动着色;通过 `enqueue=True` 支持异步、线程安全和多进程安全的日志记录;以及包含变量值的完整异常回溯显示。
它通过 JSON 序列化和上下文绑定(`bind()`、`contextualize()`、`patch()`)支持结构化日志。用户可以自定义级别,为高开销函数添加延迟计算,并通过兼容层与 Python 标准 logging 集成。环境变量允许个性化设置格式或颜色等默认值。Loguru 还包含一个基于正则的日志提取解析器,并集成 Apprise 等通知工具以实现错误警报。
该库专为脚本和库设计,允许按模块命名空间禁用/启用日志记录。虽然此前曾声称速度比内置 logging 快 10 倍,但该说法现已废弃。该库在不牺牲性能或灵活性的前提下,强调易用性、可配置性和调试能力。
评论
0 评分人数达到10人后显示
登录后参与讨论。