setup.py：在尝试安装之前需要最新版本的 setuptools

Question

我正在创建一个包含'typing;python_version<"3.5"' 的包，它是install_requires。显然，这种dependency specification 仅在setuptools 的最新版本中实现。如果用户机器上的setuptools 是旧的，他们会得到：

'install_requires' 必须是包含有效项目/版本要求说明符的字符串或字符串列表；预期版本规范 键入；python_version

简单的解决方案是在pip install my-package 之前告诉用户pip install 'setuptools>=36.2.1'。 （请注意，36.2.1 只是我知道有效的版本，不一定是绝对最低要求）

但是有没有办法在setup.py 中指定这个要求，以便它自动完成？将setuptools>=36.2.1 添加到install_requires 和setup_requires 不起作用。它说Installed /tmp/pip-si2fqg-build/.eggs/setuptools-38.2.5-py3.3.egg，然后给出与上面相同的错误。

Answer 1

我刚刚了解到PEP 518 -- Specifying Minimum Build System Requirements for Python Projects 可以解决这个确切的问题。

简而言之，这个被接受的 PEP 建议将依赖项以 TOML 格式存储在一个名为 pyproject.toml 的文件中。对于大多数 Python 项目，此文件的内容为：

[build-system]
# Minimum requirements for the build system to execute.
requires = ["setuptools", "wheel"]  # PEP 508 specifications.

在这个具体问题的情况下，我们只需要将"setuptools" 替换为"setuptools>=36.2.1"。

坏消息是pip 还不支持这个。好消息是it is implemented 和will probably be shipped with pip 9.1。

Answer 2

您无法一次性更新setuptools 并在设置脚本中使用其代码。我看到了两种可能的解决方案：如果您想支持旧版本的 setuptools，则不能使用 env 标记。使用sys.version_info 自行实施检查：

import sys
from setuptools import setup


setup(
    name='spam',
    version='0.1',
    packages=[],
    install_requires=['typing'] if sys.version_info < (3, 5) else []
)

如果您不想支持旧版本的setuptools，请检查其版本并提前中止，并通知用户：

import sys
from distutils.version import StrictVersion
from setuptools import setup, __version__


if StrictVersion(__version__) < StrictVersion('20.2'):
    print('your setuptools version does not support PEP 508. Upgrade setuptools and repeat the installation.')
    sys.exit(1)


setup(
    name='spam',
    version='0.1',
    packages=[],
    install_requires=['typing;python_version<"3.5"']
)