萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 級聯進度顯示器:多層任務進度聚合與即時輸出

複雜任務常包含多層子任務(如:下載 → 解壓 → 解析 → 入庫),每層佔總進度不同權重。本文實作 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、吞吐率。
  • 序列化狀態至檔案/Redis,支援跨程序、跨機器進度聚合。

StepedProgress 以不到 80 行核心代碼,解決了多層任務進度可視化的通用難題,適合資料管線、部署腳本、批次處理等長流程場景。

copyright © 萬盛學電腦網 all rights reserved