在我第一次用到 requirements.txt 时,是在一个虚拟环境中,我使用 pip freeze > requirements.txt 就把项目中的依赖项导出到了 txt 文件中,然后上传到 GitHub,别人在使用该项目时可以使用 pip install -r requirements.txt 就可以了,很方便不是吗。
不过,这样管理依赖的方式也并不完美。
比如说,我这个项目就依赖一个 Django,结果导出的 requirements.txt 却有这么多:
pip freeze
asgiref==3.5.0
backports.zoneinfo==0.2.1
Django==4.0.1
sqlparse==0.4.2
~/tmp ❯
也就是说,你安装依赖项 A ,它恰好有 B 作为子依赖项,B 又依赖 C。有时候你只是测试目的或者为了一个小 demo 也使用 pip 安装了一些包,那么这些依赖也会在 pip freeze 的列表中。
一段时间后,你在 requirements.txt 中看到的是 A、B、C、D、E、F、G、H,你并不知道直接或间接安装了哪些依赖项,因此现在更新甚至删除 F 成为一个问题,你必须搜索才能知道 F 是作为子依赖项安装的。最终会留下陈旧的依赖项并堆积垃圾或花费大量时间进行搜索并删除所有未使用的内容。
如何解决这个问题呢?
那就是用 pip-tools,具体方法如下:
1、安装
首先,我们来创建一个虚拟环境,然后使用 pip 安装 pip-tools:
python3 -m venv venv
source venv/bin/activate
pip install pip-tools
2、创建 requirements.in 文件
现在,我们需要创建一个 requirements.in 文件,并且只包含项目的直接依赖项。每次您想要更新或包含依赖项时,都必须先修改 requirements.in 。它与 requirements.txt 的区别也很明显,那就是只包含直接依赖的库,也可以指定版本:
3、编译 requirements.in
pip-compile requirements.in 可以直接生成 requirements.txt,但是你会发现这个 requirements.txt 跟 pip freeze 生成的有很大不同,你可以看到某个包是通过那个包引入的,依赖关系一目了然:
就这样,之前提到的问题已经不存在了,你拥有了管理依赖所需的所有信息。
4、额外功能
除此之外,pip-tools 还提供了其他有用的功能:
1、升级包。
以 Django 为例:
pip-compile --upgrade-package django
这将自动更新您的 requirements.txt 文件,包括依赖项的修改。
2、同步包
为了使 virtualenv 与当前的 requirements.txt 文件同步,您可以简单地运行以下命令:
pip-sync -a requirements.txt
这将先询问,当你输入 y 时,会在虚拟环境中安装、升级或卸载,最终与 requirements.txt 文件包含的包保持一致。
有关 pip-tools 的更多详细信息,请参阅其文档[1]。