今天給大家推薦一個非常精美的終端工具 - RichRich 是一個 Python 庫,可以為你在終端中提供富文本和漂亮、精美的格式。
使用 Rich API 可以很容易的在終端輸出添加各種顏色和不同風格。它可以繪制漂亮的表格,進度條,Markdown,突出顯示語法的源代碼及回溯等等,優(yōu)秀的功能不勝枚舉。
1.Rich 兼容性
Rich 適用于 Linux,OSX 和 Windows??膳c新的 Windows 終端一起使用,Windows 的經(jīng)典終端僅限 8 種顏色。
Rich 還可以與 Jupyter NoteBook 一起使用,而無需其他配置。
2.Rich 安裝說明
請選擇以下任一種方式輸入命令安裝依賴:
1.Windows 環(huán)境 打開 Cmd (開始-運行-CMD)。
2.MacOS 環(huán)境 打開 Terminal (command+空格輸入Terminal)。
3.如果你用的是 VSCode編輯器 或 Pycharm,可以直接使用界面下方的Terminal.
pip install rich
3.Rich 的 Print 功能
想毫不費力地將 Rich 的輸出功能添加到你的Python腳本程序中,你只需導入 Rich Print 方法,該方法和其他 Python 的自帶功能的參數(shù)類似。你可以試試:
from rich import printprint("Hello, [bold magenta]World[/bold magenta]!", ":vampire:", locals())
可以看到,基于 Rich 的 Print 方法輸出的內(nèi)容都是帶顏色、帶重點的,相比于Python自帶的 Print 有明顯的優(yōu)勢。
4.自定義 Console 控制臺輸出
想要對 Rich 終端內(nèi)容進行更多的自定義設置,你需要導入并構造一個控制臺對象:
from rich.console import Consoleconsole = Console()
Console 對象含有一個 Print 方法,它的界面與 Python 內(nèi)置的 Print 功能相似。你可以試試:
console.print("Hello", "World!")
你可能已經(jīng)料到,這時終端上會顯示“ Hello World!”,請注意,與內(nèi)置的“打印”功能不同,Rich 會將文字自動換行以適合終端寬度。
有幾種方法可以為輸出添加自定義顏色和樣式。你可以通過添加 Style 關鍵字參數(shù)來為整個輸出設置樣式。例子如下:
console.print("Hello", "World!", style="bold red")
輸出如下圖:
這個范例一次只設置了一行文字的樣式。如果想獲得更細膩更復雜的樣式,Rich 可以渲染一個特殊的標記,其語法類似于 Bbcode。示例如下:
console.print("Where there is a [bold cyan]Will[/bold cyan] there [u]is[/u] a [i]way[/i].")
5.Console 控制臺記錄
Console 對象具有一個 Log() 方法,該方法具有與 Print() 類似的界面,除此之外,還能顯示當前時間以及被調(diào)用的文件和行。
默認情況下,Rich 將針對 Python 結構和 Repr 字符串進行語法突出顯示。如果你記錄一個集合(如字典或列表),Rich 會把它漂亮地打印出來,使其切合可用空間。下面是其中一些功能的示例:
以上范例的輸出如下:
注意其中的 Log_locals 參數(shù)會輸出一個表格,該表格包含調(diào)用 log 方法的局部變量。
Log 方法既可用于將長時間運行應用程序(例如服務器)的日志記錄到終端,也可用于輔助調(diào)試。
Logging 處理程序
你還可以使用內(nèi)置的處理類來對 Python 日志記錄模塊的輸出進行格式化和著色。下面是輸出示例:
6.表情符號
將名稱放在兩個冒號之間即可在控制臺輸出中插入表情符號。示例如下:
請謹慎地使用此功能。
7.表格
Rich 包含多種邊框,樣式,單元格對齊等格式設置的選項。下面是一個簡單的示例:
該示例的輸出如下:
請注意,控制臺標記的呈現(xiàn)方式與 print() 和 log() 相同。實際上,由 Rich 渲染的任何內(nèi)容都可以添加到標題/行(甚至其他表格)中。
Table 類很聰明,可以調(diào)整列的大小以適合終端的可用寬度,并能根據(jù)需要做文本環(huán)繞的處理。下面是相同的示例,輸出與比上表小的終端上:
8.進度條
Rich 可以渲染多個不閃爍的進度條形圖,以跟蹤長時間運行的任務。
基本用法:用 Track 函數(shù)調(diào)用程序并迭代結果。下面是一個例子:
添加多個進度條并不難。以下是效果示例:
這些列可以配置為顯示你所需的任何詳細信息。
內(nèi)置列包括完成百分比,文件大小,文件速度和剩余時間。下面是顯示正在進行的下載的示例:
它可以在顯示進度的同時下載多個 URL。
9.按列輸出數(shù)據(jù)
Rich 可以將內(nèi)容通過排列整齊的,具有相等或最佳的寬度的列來呈現(xiàn)。下面是(macOS / Linux) ls 命令的一個非?;镜目寺?,用列來顯示目錄列表:
以下屏幕截圖是列示例的輸出,該列顯示了從 API 提取的數(shù)據(jù):
10.Markdown
Rich 可以呈現(xiàn)Markdown,相當不錯的將其格式顯示到終端。
為了渲染 Markdown,請導入 Markdown 類,將其打印到控制臺。例子如下:
該例子的輸出如下圖:
11.語法突出顯示
Rich 使用 Pygments 庫來實現(xiàn)語法高亮顯示。用法類似于渲染 Markdown。構造一個 Syntax 對象并將其打印到控制臺。下面是一個例子:
輸出如下:
12.錯誤回溯(traceback)
Rich 可以渲染漂亮的錯誤回溯日志,比標準的 Python 回溯更容易閱讀,并能顯示更多代碼。
你可以將 Rich 設置為默認的回溯處理程序,這樣所有異常都將由 Rich 為你呈現(xiàn)。
下面是在 OSX(與 Linux 類似)上的外觀: