
如果你的程序需要一段時間才能顯示結果,可通過顯示它的進度來避免讓用戶感到沮喪。
- 來源:https://linux.cn/article-12990-1.html
- 作者:Moshe Zadka
- 譯者:geekpi
(本文字數:3093,閱讀時長大約:3 分鐘)
阿拉米語,希伯來語和阿拉伯語中的閃米特語根 q-d-m 通常與前進或進度有關。阿拉伯語 taqaddum ( )的意思是“進度”。進度是很重要的。正如每部感覺良好的電影都會告訴你,旅程和目的地同樣重要。
大多數程序都有一個明確的目標,一個期望的最終狀態。有時,計算這個最終狀態可能需要很長的時間。雖然計算機沒有感情不在乎,但人卻在乎。人類并不樂意坐在原地等待,而看不到任何明顯的進展跡象。疑問不斷蔓延。程序崩潰了嗎?磁盤性能是否抖動?操作系統是否把所有的計算資源都分配給了其他任務?
就像正義一樣,進度必須被看到,而不僅僅是完成。Python 庫 tqdm 有助于使進度變得明確。
tqdm
模塊可在控制臺下工作,但它也專門支持了我最喜歡的環境之一 Jupyter。要在 Jupyter 中使用 tqdm
,你需要導入 notebook
子模塊并安裝 ipywidgets。notebook
子模塊與 tqdm
接口兼容。
這意味著你可以做一些導入時操作來導入正確的模塊,同時保持 tqdm
的用法不變。訣竅是檢查 __main__
模塊是否具有全局變量 get_ipython
。雖然這只是一個啟發式的方法,但卻是一個相當準確的方法:
import sys
if hasattr(sys.modules["__main__"], "get_ipython"):from tqdm import notebook as tqdm
else:import tqdm
最簡單的情況是,某件事情需要運行一定的迭代次數(事先已知),而每一次迭代的時間都差不多。例如,有一個計算任何數字的平方根的算法,通過從 1 作為猜測值開始,然后計算出一個改進后的猜測值:
def improve_guess(rt, n):return (rt + n/rt) / 2
一點點的改進可以讓你更加接近該平方根。例如,你可以計算 2 的平方根:
guess = 1
target = 2
for i in tqdm.trange(10):guess = improve_guess(guess, target)

精確了到小數點后 10 位!
round(2 - guess*guess, 10)
0.0
一個稍微復雜一點的例子是,當元素的數量是已知的,而處理每個元素需要類似的時間。例如,你可以計算一些數字的乘積。為此,你需要一些隨機數:
import random
numbers = [random.uniform(0, 2.8) for i in range(100)]
numbers[:5]
[2.6575636572230916,
0.1286674965830302,
1.0634250104041332,
1.1760969844376505,
0.45192978568125486]
現在有了這些數字,可以將它們相乘了。使用 tqdm
最簡單的方法是包裝一個 Python 迭代函數。數值是一樣的,但是 tqdm
會顯示一個進度條:
result = 1
for num in tqdm.tqdm(numbers):result *= num
result
2.4081854901728303

然而,并不是所有的事情都可以預測。最不容易預測的事情之一就是網絡速度。當你下載一個大文件時,衡量進度的唯一方法就是檢查已經下載了多少:
url = "https://www.python.org/ftp/python/3.9.0/Python-3.9.0.tgz"
import httpx
with httpx.stream("GET", url) as response:total = int(response.headers["Content-Length"])with tqdm.tqdm(total=total) as progress:for chunk in response.iter_bytes():progress.update(len(chunk))

有時,“嵌套”進度條是有意義的。例如,如果你要下載一個目錄,你就需要一個進度條來跟蹤文件,并為每個文件設置一個進度條。
下面是一個例子(但沒有實際下載一個目錄):
files = [f"vid-{i}.mp4" for i in range(4)]
for fname in tqdm.tqdm(files, desc="files"):total = random.randrange(10**9, 2 * 10**9)with tqdm.tqdm(total=total, desc=fname) as progress:current = 0while current < total:chunk_size = min(random.randrange(10**3, 10**5), total - current)current += chunk_sizeif random.uniform(0, 1) < 0.01:time.sleep(0.1)progress.update(chunk_size)

所以,如果你的程序需要一段時間才能顯示最終結果,為避免讓你的用戶感到沮喪。請顯示它的進度!