Loguru — Python 記錄日志居然能這么強(qiáng)大而簡(jiǎn)單？

Loguru?一個(gè)能徹底解放你的日志記錄器。

它即插即用，具備多種方式滾動(dòng)日志、自動(dòng)壓縮日志文件、定時(shí)刪除等功能。

除此之外，多線程安全、高亮日志、日志告警等功能也不在話下。

下面就給大家介紹一下這個(gè)強(qiáng)大工具的基本使用方法。

Loguru 安裝方式很簡(jiǎn)單，打開終端輸入：

pip install?loguru

即可完成安裝。

在Loguru中，如果你需要輸出 debug 日志到終端，可以這么做：

from?loguru import?logger

logger.debug("That's it, beautiful and simple logging!")

其輸出自帶高亮：

如果你需要把日志輸出到文件，只需要這樣：

from?loguru import?logger
logger.add("file_{time}.log")
logger.debug("That's it, beautiful and simple logging!")

這樣就會(huì)在當(dāng)前運(yùn)行的文件夾下生成?file_當(dāng)前時(shí)間.log?的日志文件：

使用 Loguru 我們可輕易地實(shí)現(xiàn)滾動(dòng)日志。

按時(shí)間滾動(dòng)

比如按時(shí)間滾動(dòng)，我們只需要在 logger.add 參數(shù)中添加一個(gè) rotation 參數(shù)：

from?loguru import?logger
logger.add("file_2.log", rotation="12:00") # 每天12:00會(huì)創(chuàng)建一個(gè)新的文件
logger.debug("That's it, beautiful and simple logging!")

這樣，如果當(dāng)前時(shí)間過了這個(gè)設(shè)定的時(shí)間，它就會(huì)生成一個(gè)新的日志文件。如果沒有則使用原來的日志文件：

如圖所示，過了設(shè)定的時(shí)間，則將原來的 file_2.log 重命名，并添加一個(gè)新的 file_2.log 文件。

按大小滾動(dòng)

除了按時(shí)間滾動(dòng)日志外，Loguru 還可以按日志大小滾動(dòng)：

from?loguru import?logger
logger.add("file_1.log", rotation="1 MB") # 滾動(dòng)大日志文件
logger.debug("That's it, beautiful and simple logging!")

這樣，一旦日志文件大小超過 1 MB 就會(huì)產(chǎn)生新的日志文件。

壓縮日志

如果你不想刪除原有日志文件，Loguru 還支持將日志直接壓縮：

from?loguru import?logger
logger.add("file_Y.log", compression="zip") # 壓縮日志

自定義顏色

Loguru 是支持自定義顏色的，如果你不喜歡它默認(rèn)的顏色，可以這么改：

logger.add(sys.stdout, colorize=True, format="{time} {message}")

類似于HTML標(biāo)簽 標(biāo)簽中間的文字將會(huì)被標(biāo)記為綠色。

多進(jìn)程安全

Loguru 默認(rèn)情況下是線程安全的，但它不是多進(jìn)程安全的。不過如果你需要多進(jìn)程/異步記錄日志，它也能支持，只需要添加一個(gè) enqueue 參數(shù)：

logger.add("somefile.log", enqueue=True)

支持Backtrace

對(duì)于日志而言，沒有錯(cuò)誤堆棧的日志是沒有靈魂的。Loguru 允許顯示整個(gè)堆棧信息來幫助你發(fā)現(xiàn)問題（包括變量）。

比如下面這個(gè)例子：

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)

日志將會(huì)是這樣的：

非常清晰明了。

郵件告警

Loguru 可以和強(qiáng)大的郵件通知模塊?notifiers?庫結(jié)合使用，以在程序意外失敗時(shí)接收電子郵件，或發(fā)送許多其他類型的通知。

import?notifiers

params = {
????"username": "[email protected]",
????"password": "abc123",
????"to": "[email protected]"
}

# 初始化時(shí)發(fā)送一封郵件
notifier = notifiers.get_notifier("gmail")
notifier.notify(message="The application is running!", **params)

# 發(fā)生Error日志時(shí)，發(fā)郵件進(jìn)行警報(bào)
from?notifiers.logging import?NotificationHandler

handler = NotificationHandler("gmail", defaults=params)
logger.add(handler, level="ERROR")

這樣配置之后，每次產(chǎn)生 Error 日志，程序都會(huì)自動(dòng)向你的郵箱發(fā)送告警，真的極其方便。

除了這些特性外，Loguru 還支持與 Python 原生的 Logging 模塊兼容使用，你可以將原始的標(biāo)準(zhǔn)日志記錄器記錄的所有信息轉(zhuǎn)移到Loguru中。

你還可以基于 Loguru 定制新的日志 Level，定制自己喜歡的結(jié)構(gòu)化數(shù)據(jù)，詳情可見 Loguru 的官方文檔：https://github.com/Delgan/loguru