作为程序员,我们经常会遇到比较耗时的操作,这个时候我们大多数人会无助地等待程序执行完成,有些人会趁机摸一下鱼,以便渡过这个无聊看起来又有点未知的时间,我就是这样做的。
但是,我们也可以选择另一种方式——用一个炫酷的进度条,来观察处理进度,也可以及时了解程序运行的情况,做到心中有数。
今天就给大家介绍 Python 的一个库—— tqdm
,它就能非常完美的支持和解决这些问题,可以实时输出处理进度而且占用的CPU资源非常少,支持windows、Linux、mac等系统,支持循环处理、多进程、递归处理、还可以结合linux的命令来查看处理情况,等进度展示。
安装
我们常见的安装方式是直接 pip
安装:
pip install tqdm
但是我用这种方式安装的时候报错:
看报错的意思是这个 pypi.org 不是可信网站,于是我加上了:
pip install tqdm –trusted-host pypi.org
结果还是这个报错。
这有点无语了。我接着尝试使用豆瓣的源来进行安装:
pip install -i https://pypi.douban.com/simple tqdm
还是一样的报错。
但是我浏览器访问这个网站没问题:https://pypi.org/project/tqdm/
既然这样,我就把文件下载下来再安装吧。
下载下来之后,我将 whl 文件放在我的项目目录,然后使用命令行安装:
pip install –trusted-host pypi.org tqdm-4.62.3-py2.py3-none-any.whl
这回安装没报错。我再用命令检查一下安装是否成功:
pip show tqdm
命令行成功显示信息:
1 |
|
折腾了半天,终于安装成功了!
使用实例
本文的示例都是在 jupyter notebook 环境下运行的,不同环境运行的效果会有差别。
我们进入 tqdm
的源码,可以找到 __init__
方法:
1 |
|
从中我们可以看到 tqdm
支持很多参数,下面列一些常见的参数:
- iterable:可迭代的对象,在手动更新时不需要进行设置。
- desc:字符串,左边进度条描述文字。
- total:总的项目数。
- leave:布尔值,迭代完成后是否保留进度条。
- file:输出指向位置,默认是终端, 一般不需要设置。
- ncols:调整进度条宽度,默认是根据环境自动调节长度,如果设置为0,就没有进度条,只有输出的信息。
- unit:描述处理项目的文字,默认是’it’,例如: 100 it/s,处理照片的话设置为’img’ ,则为 100 img/s。
- unit_scale:自动根据国际标准进行项目处理速度单位的换算,例如 100000 it/s » 100k it/s。
基于可迭代对象使用
直接将可迭代对象传入作为参数,我们来看一下例子:
1 |
|
实现的进度条效果如下:
这里面的 tqdm(range())
我们也可以用 tqdm
提供的 trange()
来代替,可以简化代码。
1 |
|
实现的进度条效果如下:
我们还可以为进度条添加描述:
1 |
|
实现的进度条效果如下:
接下来,我要改变一下进度条的颜色:
手动控制进度条
我们可以使用 with
语句来手动控制进度条。
1 |
|
这里我设置进度条的更新的间隔,设置总数为 total=100,然后分四次,使得进度条按 10%,20%,30%,40%的间隔来更新。
实现的进度条效果如下:
接下来, 我要改变一下进度条的颜色:
1 |
|
我把进度条改为了黄色。
接下来,我们来个嵌套进度条玩玩。
1 |
|
这里我用两层 for 循环实现了嵌套,并且将内层的 参数 leave
设置为 False
,意思是内层的进度条每执行一次都会消失。
我们来看看最终运行的效果:
总结
这个进度条库的使用方法是不是很简单,几行代码就能为我们的程序增色不少。心动不如行动,赶快用起来吧!
示例代码:(https://github.com/JustDoPython/python-examples/tree/master/xianhuan/tqdm)