极客笔记Python pip在setup.py中忽略dependency_links的问题
在本文中，我们将介绍Python pip在解析setup.py文件时忽略dependency_links的问题。pip是Python的一个著名的包管理工具，能够方便地安装、升级和管理Python包。setup.py是Python包的配置文件，其中定义了包的依赖关系，包括依赖其他包和依赖外部资源的链接。然而，pip在解析setup.py文件时，会忽略dependency_links中的链接，导致一些依赖包无法正确安装。
阅读更多：Python 教程
背景
Python的包管理工具pip可以方便地安装和管理Python包。在创建Python包的时候，我们可以在setup.py文件中定义依赖关系，指明需要依赖的其他包或者依赖的外部资源的链接。dependency_links可以用来指定外部链接的地址，告诉pip在安装包的时候需要下载这些额外的链接资源。然而，近期的pip版本(>=20.2)在解析setup.py文件时已经不再支持dependency_links，这导致了一些包可能无法正确安装。这个问题引起了开发者们的关注和讨论。
问题分析
为了解决依赖关系的问题，pip引入了requirements.txt文件作为包的依赖配置文件。在这个文件中，我们可以明确列出需要的包及其版本号，pip会根据这个文件来安装相关的依赖包。因此，pip不再支持setup.py中的dependency_links字段，这个字段在pip安装包的过程中会被忽略掉。
解决方案
为了解决pip忽略dependency_links的问题，我们需要采取以下的解决方案：
方案一：使用requirements.txt
推荐使用requirements.txt文件来管理Python包的依赖关系。在requirements.txt文件中，可以明确列出需要的包及其版本号，pip会根据这个文件来安装相关的依赖包。这样可以避免依赖关系被忽略的问题。下面是一个示例的requirements.txt文件内容：
numpy==1.18.0
matplotlib==3.1.2
运行以下命令来安装依赖包：
pip install -r requirements.txt
方案二：使用extras_require
在setup.py文件中，可以使用extras_require字段来定义额外的依赖包。extras_require可以指定一组包的名称和版本号，pip可以根据这个字段来安装额外的依赖包。下面是一个示例的setup.py文件内容：
from setuptools import setup
setup(
name='my_package',
version='0.1',
install_requires=[
'numpy==1.18.0',
'matplotlib==3.1.2',
],
extras_require={
'dev': [
'pytest==5.3.2',
'flake8==3.7.9',
],
},
)
运行以下命令来安装依赖包：
pip install my_package[dev]
方案三：使用find_links
虽然pip不再支持dependency_links字段，但可以使用find_links来指定要安装的包的链接。find_links可以指定一组链接的地址，pip会从这些地址下载并安装相应的包。下面是一个示例的setup.py文件内容：
from setuptools import setup
setup(
name='my_package',
version='0.1',
install_requires=[
'numpy==1.18.0',
'matplotlib==3.1.2',
],
dependency_links=[
'http://example.com/packages/matplotlib-3.1.2.tar.gz',
],
)
运行以下命令来安装依赖包：
pip install --process-dependency-links my_package
总结
本文介绍了Python pip在解析setup.py文件时忽略dependency_links的问题，并提供了三种解决方案。推荐使用requirements.txt文件来管理Python包的依赖关系，或者使用extras_require来定义额外的依赖包，也可以使用find_links来指定要安装的包的链接。开发者们可以根据自己的需求选择合适的方案来解决这个问题，确保依赖包正确安装。