首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Loguru:优雅的Python程序日志

Loguru:优雅的Python程序日志

作者头像
SeanCheney
发布于 2020-07-20 09:54:19
发布于 2020-07-20 09:54:19
3.5K0
举报
文章被收录于专栏:SeanCheney的专栏SeanCheney的专栏

习惯了使用Python自带的logging模块记录日志,但是总觉得不够优雅。 Loguru解决了这个问题。guru是印度语中大师的意思,直译就是“日志大师”。

使用pip安装

代码语言:javascript
复制
pip install loguru

开箱即用

不同的日志等级,输出效果也不一样(等级由低到高是DEBUG、INFO、WARNING、ERROR、CRITICAL)

代码语言:javascript
复制
logger.debug("That's it, beautiful and simple logging!")
logger.info("That's it, beautiful and simple logging!")
logger.warning("That's it, beautiful and simple logging!")
logger.error("That's it, beautiful and simple logging!")
logger.critical("That's it, beautiful and simple logging!")

统一的add()函数

add()函数用于注册“沉量”sink,用于管理日志消息。

代码语言:javascript
复制
logger.add(sink='log.txt', format="{time} {level} {message}", filter="my_module", level="INFO")

将上面两个功能合起来,就能实现最基本的日志功能了。

代码语言:javascript
复制
from loguru import logger

logger.add(sink='log.log', format="{time} - {level} - {message}", level="INFO")
logger.info("That's it, beautiful and simple logging!")

可以用rotation、retention、compression进行日志窗口、更新、压缩管理。

代码语言:javascript
复制
logger.add("file_1.log", rotation="500 MB")    # 日志文件的窗口大小是500M
logger.add("file_2.log", rotation="12:00")     # 每天中午12点创建新日志文件
logger.add("file_3.log", rotation="1 week")    # 自动更新旧文件
logger.add("file_X.log", retention="10 days")  # 清理旧文件
logger.add("file_Y.log", compression="zip")    # 压缩文件

loguru支持f-string:

代码语言:javascript
复制
logger.info("If you're using Python {}, prefer {feature} of course!", 3.6, feature="f-strings")

Loguru支持在主进程和线程中捕获异常,使用@logger.catch

代码语言:javascript
复制
from loguru import logger

logger.add(sink='log.log', format="{time} - {level} - {message}", level="INFO")

@logger.catch
def my_function(x, y, z):
    return 1 / (x + y + z)

res = my_function(0,0,0)
print(res)

修改日志文字的颜色

代码语言:javascript
复制
logger.add(sys.stdout, colorize=True, format="<green>{time}</green> <level>{message}</level>")

使用enqueue,可以保证多线程安全、多进程安全

代码语言:javascript
复制
logger.add("somefile.log", enqueue=True)

详细的异常回溯

使用backtrace、diagnose

代码语言:javascript
复制
from loguru import logger

logger.add("output.log", backtrace=True, diagnose=True)  # 设置为'False'可以保证生产中不泄露信息

def func(a, b):
    return a / b

def nested(c):
    try:
        func(5, c)
    except ZeroDivisionError:
        logger.exception("What?!")

nested(0)

参考: https://github.com/Delgan/loguru https://loguru.readthedocs.io/en/stable/overview.html

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除
目录
  • 使用pip安装
  • 开箱即用
  • 统一的add()函数
  • Loguru支持在主进程和线程中捕获异常,使用@logger.catch
  • 修改日志文字的颜色
  • 使用enqueue,可以保证多线程安全、多进程安全
  • 详细的异常回溯
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档