Skip to content

alive-progress

项目功能
alive-progress 是一个 Python 库,用于在终端和 Jupyter Notebook 中显示动态进度条和动画,支持实时更新任务进度、预估剩余时间(ETA)、自定义样式(如主题、颜色、动画模式)以及多线程日志集成。

使用方法
通过 pip 安装后,可直接导入库创建进度条对象。支持通过参数调整刷新率、动画风格(如滚动、弹跳)、主题颜色,并可通过配置选项控制是否显示百分比、文本标题或隐藏光标。在 Jupyter 中可自动适配动画显示。

主要特性

  1. 动态计算:自动计算任务进度、速率及 ETA,支持大任务的平滑估算。
  2. 高度自定义:提供多种动画模式(如并行、序列)、主题样式、文本格式及刷新频率调整。
  3. 兼容性:支持 Python 3.6+,适配终端、Jupyter Notebook 和多线程日志系统。
  4. 异常处理:可捕获中断信号(如 Ctrl+C),并保留最终进度状态。
  5. 扩展功能:集成图形集群支持(处理宽字符),允许自定义背景样式和文本内容。
  6. 版本管理:明确标注 Python 版本支持范围,提供历史版本兼容性指令(如 pip install "alive_progress<3.2" 适配 Python 3.7)。

许可证
采用 MIT 协议,开源免费使用。