複雜任務常包含多層子任務(如:下載 → 解壓 → 解析 → 入庫),每層佔總進度不同權重。本文實作 StepedProgress 類,支援任意層級巢狀進度、權重分配、自動向上聚合、即時終端機輸出,讓長流程執行狀態一目瞭然。
stockPercent=[60, 40] 表示子任務佔比,自動正規化總和為 1。parentProgress 參考,子進度更新時自動按權重向父級匯報。notifyProgress 以 \r 覆蓋同一行顯示百分比與訊息。
class StepedProgress:
def __init__(self, stockPercent=[1], parentProgress=None):
self.percent = 0
self.info = ''
self.stockPercent = stockPercent
self.parentProgress = parentProgress
self.cur_running_process = 0
# 正規化權重
w = sum(stockPercent)
self.stockPercent = [p / w for p in stockPercent]
# 建立子進度節點
self.subProgress = [StepedProgress(parentProgress=self) for _ in self.stockPercent] \
if len(self.stockPercent) > 1 else None
def subprogress(self, index):
'''取得或建立第 index 個子進度'''
if self.subProgress is None:
return self
if index >= len(self.subProgress):
index = len(self.subProgress) - 1
elif index < self.cur_running_process:
index = self.cur_running_process
self.cur_running_process = index
return self.subProgress[index]
def notifyProgress(self, percent, info=None):
'''葉子節點回報進度(0-100)'''
if percent > self.percent:
self.percent = percent
if info is not None:
self.info = info
if self.parentProgress:
self.parentProgress.notifyParentProgress(percent, info)
else:
# 根節點:輸出
print(self.info[:77].ljust(80, '.'), f"[{self.percent:.1f}%]")
def notifyParentProgress(self, child_percent, info):
'''父節點聚合子進度'''
accumulated = sum(self.stockPercent[:self.cur_running_process])
accumulated += (child_percent / 100.0) * self.stockPercent[self.cur_running_process]
self.notifyProgress(accumulated * 100, info)
if __name__ == "__main__":
# 總進度:步驟1佔60%、步驟2佔40%
s = StepedProgress([60, 40])
s.notifyProgress(10, 'aaa') # 總進度 10% * 0.6 = 6% → 顯示 6%
s1 = s.subprogress(0) # 進入步驟1
s1.notifyProgress(50, 'bbb') # 步驟1 50% → 總進度 6% + 50%*60% = 36%
s3 = s.subprogress(1) # 進入步驟2
s3 = StepedProgress([1, 1], parentProgress=s3.parentProgress) # 步驟2再分兩子步
s3.notifyProgress(20, 'ddd') # 步驟2 20% → 總進度 60% + 20%*40% = 68%
s4 = s3.subprogress(0)
s4.notifyProgress(50, 'eee') # 步驟2.1 50% → 總進度 70%
s5 = s3.subprogress(1)
s5.notifyProgress(50, 'fff') # 步驟2.2 50% → 總進度 90%
aaa............................................................................. [6.0%]
bbb............................................................................. [36.0%]
ddd............................................................................. [68.0%]
eee............................................................................. [70.0%]
fff............................................................................. [90.0%]
threading.Lock 保護多執行緒並發更新。tqdm/rich 進度條後端,替換終端機輸出邏輯。start_time 計算 ETA、吞吐率。StepedProgress 以不到 80 行核心代碼,解決了多層任務進度可視化的通用難題,適合資料管線、部署腳本、批次處理等長流程場景。