PyPI install_requires 直接链接

Question

我有一个我无法控制的 Python 库 (https://github.com/jcrozum/PyStableMotifs) that I want to publish on PyPI. It depends on another library (https://github.com/hklarner/PyBoolNet)，它仅在 GitHub 上可用，特别是在 PyPI 上不可用。我的 setup.py 看起来像这样：

from setuptools import
setup(
    ... <other metadata> ...,
    install_requires=[
    'PyBoolNet @ git+https://github.com/hklarner/PyBoolNet@2.3.0',
    ... <other packages> ...
    ]
)

运行 pip install git+https://github.com/jcrozum/PyStableMotifs 完美运行，但由于 twine 出现以下错误，我无法将其上传到 PyPI：

Invalid value for requires_dist. Error: Can't have direct dependency: 'PyBoolNet @ git+https://github.com/hklarner/PyBoolNet@2.3.0'

我的理解是，出于安全原因，PyPI 禁止直接链接。尽管如此，PyBoolNet 是 PyStableMotifs 的硬性要求。我该怎么办？放弃 PyPI？

我只想 pip install PyStableMotifs 为我的用户工作。理想情况下，此命令应该安装依赖项，我不必维护 setup.py.

的两个版本

失败后，我考虑在 PyPI 上创建一个“虚拟”包，指导用户使用命令 pip install git+https://github.com/jcrozum/PyStableMotifs 进行安装。这是个坏主意（甚至可能）吗？

是否已经针对这种情况建立了最佳实践或其他常见的解决方法？

编辑：现在，我有一个笨拙且完全不能令人满意的解决方法。我保留了两个版本；一个完美运行的 GitHub 版本，以及一个删除了 PyBoolNet 要求的 PyPI 版本。如果用户尝试在未安装 PyBoolNet 的情况下导入 PyStableMotifs，则会显示一条错误消息，其中包含 PyBoolNet 的安装说明。这在我看来远非理想，但在我找到更好的解决方案或 PyPI 修复此错误（或删除此功能，具体取决于您询问的对象）之前，它必须这样做。

Answer 1

我的建议是摆脱 install_requires 中的直接 URL，并告诉您的用户在哪里可以找到该依赖项 PyBoolNet，因为它不在 PyPI 上。不要强迫他们使用特定的安装方法，而是给他们看一个例子。

也许可以简单地告诉您的用户：

This project depends on PyBoolNet, which is not available on PyPI. One place where you can find it is at: https://github.com/hklarner/PyBoolNet.

One way to install PyStableMotifs as well as its dependency PyBoolNet is to run the following command:
python -m pip install 'git+https://github.com/hklarner/PyBoolNet@2.3.0#egg=PyBoolNet' PyStableMotifs

您还可以准备一个 requirements.txt 文件并告诉您的用户：

Install with the following command:

python -m pip install --requirement https://raw.githubusercontent.com/jcrozum/PyStableMotifs/master/requirements.txt

requirements.txt 的内容可能是这样的：

git+https://github.com/hklarner/PyBoolNet@2.3.0#egg=PyBoolNet
PyStableMotifs

但最后，您真的应该让您的用户选择如何安装该依赖项。你的项目只需要声明它依赖于那个库而不是如何安装它。

PyPI install_requires 直接链接

PyPI install_requires direct links

github

setuptools

packaging

pypi

twine