python第三方异步日志库loguru简介
一、引言
在编写调试Python代码过程中，我们经常需要记录日志，通常我们会采用python自带的内置标准库logging，但是使用该库，配置较为繁琐。为了提升编程效率，本文重点介绍最近发现的一个宝藏第三方日志库Loguru，该库名字来自于印度语，含义为日志大师。
我们先来做个直观的对比，来说明Loguru的优雅之处。使用python自带的logging，样例代码如下：
样例输出如下：
使用Loguru库，样例代码如下：
使用Loguru输出日志，终端执行后出现带颜色的日志，而且使用超级方便。
二、安装loguru
直接使用pip进行安装即可，命令如下：
pip install loguru
输出到终端使用方式：
from loguru import logger
logger.debug("msg msg msg!")输出到文件使用方式：
from loguru import logger
logger.add("file_name.log")
logger.debug("msg msg msg!")三、特性
参考官方github，里面给出了Loguru库丰富的特性，这里挑选几个重要的特性进行讲解
3.1 开箱即用
Loguru库设计的初衷就在于追求有且仅有一个logger，为了使用方便，提前预置输出样式。如果需要打印日志仅需采取如下方式：
from loguru import logger
logger.debug("That's it, beautiful and simple logging!")3.2 无需初始化，导入函数即可使用
在Loguru中，我们如何自定义输出样式？如何过滤输出信息？如何设置日志级别？
答案是调用 add() 函数
logger.add(sys.stderr, format="{time} {level} {message}", filter="my_module", level="INFO")示例如下：
from loguru import logger
logger.add("info.log", format="{time} {level} {message}", filter="", level="INFO")
logger.debug("This is a debug msg")
logger.info("This is a info msg")我们查看info.log，结果如下:
3.3 更容易的文件日志记录与转存/保留/压缩方式
我们可以通过简单的配置，来让日志保存更加人性化。比如我们想要删除老的日志，或者我们希望自动压缩保存好的日志，可以参考一下命令：
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_4.log", retention="10 days") # 一段时间后会清空
logger.add("file_5.log", compression="zip") # 保存zip格式3.4 更优雅的字符串格式化输出
Loguru库对字符串的处理功能更加强大，字符串格式化输出支持{} 来替换%，功能类似于str.format()
logger.info("If you're using Python {}, prefer {feature} of course!", 3.6, feature="f-strings")3.5 可以在线程或主线程中捕获异常
我们经常会遇到代码出现crash时，我们在log里看不到任何错误的信息。在Loguru库中，可以通过 @logger.catch 装饰器来确保发生异常时，将错误信息保存下来。
示例如下：
@logger.catch
def main(x, y, z):
return x * y / z
res = main(1,2,0)
print(res)
3.6 可以支持自定义颜色
Loguru 是支持自定义颜色的，如果你不喜欢它默认的颜色，可以这么改：
logger.add(sys.stdout, colorize=True, format="<green>{time}</green> <level>{message}</level>")3.7 支持异步，且线程和多进程安全
Loguru 默认情况下是线程安全的，但它不是多进程安全的。不过如果你需要多进程/异步记录日志，它也能支持，只需要添加一个 enqueue 参数：
logger.add("somefile.log", enqueue=True)3.8 支持异常完整性描述
对于日志而言，没有错误堆栈的日志是没有灵魂的。Loguru 允许显示整个堆栈信息来帮助你发现问题（包括变量）。
logger.add("out.log", backtrace=True, diagnose=True) # Caution, may leak sensitive data in prod
def func(a, b):
return a / b
def nested(c):
try:
func(5, c)
except ZeroDivisionError:
logger.exception("What?!")
nested(0)运行结果如下:
3.9 更好的日期时间处理
我们可以自定义日期输出样式，如下所示：
logger.add("file.log", format="{time:YYYY-MM-DD at HH:mm:ss} | {level} | {message}") #定义日期样式3.10 支持邮件通知
Loguru 可以和强大的邮件通知模块 notifiers 库结合使用，以在程序意外失败时接收电子邮件，或发送许多其他类型的通知。
import notifiers
params = {
"username": "you@gmail.com",
"password": "abc123",
"to": "dest@gmail.com"
}
# 初始化时发送一封邮件
notifier = notifiers.get_notifier("gmail")
notifier.notify(message="The application is running!", **params)
# 发生Error时，发邮件进行告警
from notifiers.logging import NotificationHandler
handler = NotificationHandler("gmail", defaults=params)
logger.add(handler, level="ERROR")这样配置之后，每次产生 Error 日志，程序都会自动向你的邮箱发送告知邮件，真的是足够人性化了。
四、总结
本文对Loguru库相关主要特性进行了简要概述，如果需要了解其更详细的特性说明，可参考官方github。
推荐大家在日常生活中多多使用Loguru库进行日志处理工作。
loguru官方网站: https://loguru.readthedocs.io/en/stable/index.html
api文档: https://loguru.readthedocs.io/en/stable/api.html
项目地址：https://github.com/Delgan/loguru
到此这篇关于python优秀第三方异步日志库loguru介绍的文章就介绍到这了,更多相关python异步日志库loguru内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
pyautogui模块，规范一点大写就是PyAutoGUI模块，是用来实现自动化脚本的一个十分得力的小助手。他可以操控键盘和鼠标，可以写许多工具。本文就来讲讲如何利用这个模块实现键盘鼠标的相关操作，需要的可以参考一下2023-01-01
这篇文章主要介绍了python变量赋值机制踩坑记录，我们都知道python有深拷贝和浅拷贝，但变量赋值又是什么机制呢？这是个容易被忽略却又极易踩坑的点，下面我们来一探究竟,需要的朋友可以参考一下2022-02-02
本文详细讲解了Python的面向对象编程，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-05-05
这篇文章主要介绍了Python散点图与折线图绘制过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2019-11-11
这里我们简单整理一下Python中的异常处理相关语句基础学习笔记,包括try...except与assert等基本语句的用法讲解:2016-07-07
这篇文章主要介绍了Python 使用 environs 库来更好地定义环境变量,本节我们以 Python 项目为例，说说环境变量的设置。通过实例代码给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下2020-02-02
python包pdfkit(wkhtmltopdf) 将HTML转换为PDF的操作方法
pdfkit，把HTML+CSS格式的文件转换成PDF格式文档的一种工具。它就是html转成pdf工具包wkhtmltopdf的Python封装。所以，必须手动安装wkhtmltopdf,这篇文章主要介绍了python包pdfkit(wkhtmltopdf)将HTML转换为PDF,需要的朋友可以参考下2022-04-04
这篇文章主要介绍了Jupyter notebook快速入门教程，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-05-05
python dataframe常见操作方法:实现取行、列、切片、统计特征值
今天小编就为大家分享一篇python dataframe常见操作方法:实现取行、列、切片、统计特征值，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-06-06
这篇文章主要为大家介绍了如何用Python制作一个迷宫游戏，文中的示例代码讲解详细，对大家更好的理解和学习python有一定帮助，感兴趣的朋友可以了解下2022-02-02
最新评论