給 Python 添加進度條 | 給小白的 tqdm 精煉實例！

給 Python 添加進度條 | 給小白的 tqdm 精煉實例！

假設咱們有一個循環：

for i in range(100):
    do_something()  # 這裏作某些事

假設 do_something() 很慢，且運行時間不穩定，當咱們運行時，咱們並不知道運行到哪裏了。

咱們引入一個進度條。

from tqdm import trange
for i in trange(100):
    do_something()

輸出
  5%|██▌                                                 | 5/100 [00:05<01:35,  1.01s/it]

如上，咱們就可用實時查看進度。

安裝

這個庫並非 python 自帶的庫，使用 pip 安裝就可。

pip install tqdm

來看看個人實驗環境。

❯ python --version
Python 3.7.0

>>> tqdm.__version__
'4.59.0'

入門實例

說實在的，官方文檔寫得並非很好。

對於 range() ，咱們把其改成 tqdm 中的 trange() 就能夠。

其實， trange(5) 至關於 tqdm(range(5)) 。

因此不難看出，用 tqdm 包裹 tqdm(可迭代的對象) 就能夠自動爲咱們創建進度條。

>>> a = ['a', 'b', 'c'] * 10000
>>> from tqdm import tqdm
>>> for i in tqdm(a):
...     pass
...
100%|███████████| 30000/30000 [00:00<?, ?it/s]
>>>

使用 for i in tqdm(a) 和 for i in a 邏輯上沒有區別，可是前者讓控制檯多出了一個進度條。

自定義進度條

其實，咱們還可用「手把手地」操做進度條。尤爲是當咱們的進度並非單純的依靠可迭代變量時。

假設咱們有個任務以下。

import random
import time

class Task:
    def __init__(self) -> None:
        self.jobs = int(1e3)

    @property
    def job_done(self) -> bool:
        return self.jobs <= 0

    def do_job(self) -> int:
        time.sleep(1)
        job_minus = random.randint(1, 50)
        self.jobs = max(0, self.jobs - job_minus)
        return job_minus

咱們總共有 1e3 = 1000 個任務要作，可是這些任務並非每次作一個，而是每次可能作 [1, 50) 箇中的任意數量的工做。

因此咱們不能夠單純讓 do_job 運行 1000 次，由於每次 do_job 的效率不一樣。

這時咱們定製咱們的進度條。

from tqdm import tqdm

task: Task = Task()

info = { 'efficiency': None }

with tqdm(
    total=task.jobs, desc='Doing jobs'
) as t:

    while not task.job_done:

        job_minus = task.do_job()

        info['efficiency'] = job_minus
        t.update(job_minus)
        t.set_postfix(info)

如上，咱們聲明瞭一個 tqdm 對象：

• 這個對象的計數總量是咱們的總工做量 total=task.jobs
• 進度條的前綴是 'Doing jobs'
• 每一次刷新進度，咱們進度條的增量是 t.update(job_minus)
• 咱們進度條後綴輸出信息 info['efficiency'] = job_minus

來看看效果。

❯ python .\example.py
Doing jobs:   9%|██▏                    | 94/1000 [00:03<00:28, 31.73it/s, efficiency=30]

動圖以下。

總結

經過實例探討了 tqdm 進度條的使用。

我是小拍，老鐵們記得點贊關注！微信 PiperLHJ 。