使用 setup.py 从 git at tag 安装 python 包

Question

我在私有 git 仓库中有一个包 (foo)。 我想通过 bar 的 setup.py 安装 foo 以供另一个包 bar 使用。 我想要一个特定的版本 - setup.py 中 foo 的版本匹配它的 git 标签（0.3.2，git 标签是 v0.3.2）

bar 的 setup.py 如下所示：

#!/usr/bin/env python
  
from setuptools import setup, find_packages

setup(name='bar',
        install_requires=['foo@ git+ssh://git@github.com/fergusmac/foo.git@v0.3.2#subdirectory=somedir']
    )

我还尝试在最后明确添加版本：

install_requires=['foo@ git+ssh://git@github.com/fergusmac/foo.git@v0.3.2#subdirectory=somedir==0.3.2']

我目前在我的 venv 中安装了 0.3.1 版。 当我尝试通过pip install .安装这个 setup.py 时pip install . , 或pip install . -U pip install . -U版本没有升级 - repo 甚至没有签出：

Requirement already satisfied, skipping upgrade: foo@ git+ssh://git@github.com/fergusmac/foo.git@v0.3.2#subdirectory=src==0.3.2 from 
git+ssh://****@github.com/fergusmac/foo.git@v0.3.2#subdirectory=src==0.3.2 in 
./venv/lib/python3.8/site-packages (from bar==0.0.0) (0.3.1)

但是，当我直接使用pip安装foo时，升级就完成了：

pip install git+ssh://git@github.com/fergusmac/foo.git@v0.3.2#subdirectory=src

Collecting git+ssh://****@github.com/fergusmac/foo.git@v0.3.2#subdirectory=src
  Cloning ssh://****@github.com/fergusmac/foo.git (to revision v0.3.2) to /tmp/pip-req-build-gxj2duq6
  Running command git clone -q 'ssh://****@github.com/fergusmac/foo.git' /tmp/pip-req-build-gxj2duq6
  Running command git checkout -q 40fa65eb75fc26541c90ee9e489ae6dd5538db1f
  Running command git submodule update --init --recursive -q
...
Installing collected packages: foo
  Attempting uninstall: foo
    Found existing installation: foo0.3.1
    Uninstalling foo-0.3.1:
      Successfully uninstalled foo-0.3.1
    Running setup.py install for foo... done
Successfully installed foo-0.3.2

我不明白为什么用 setup.py 安装会产生不同的行为。 我如何确保它检查回购并寻找正确的版本？

后续问题 - 我将如何指定“检查 foo 的主分支并安装任何版本，如果它高于当前安装的版本”？

Answer 1

你问的是一个准确而有效的问题，但我不相信会出现令人满意的答案。 我不确定为什么您所做的不起作用，但是使用 pip 和 setuptools 的直接 URL 依赖项是一个新的且相当复杂的功能，并且在 setuptools 方面可能存在错误/缺乏。

我假设您想要做的是将包foo作为bar的依赖项 - 您实际上不需要使用PEP 508直接 URL 说明符格式。 相反，您可以提供带有（相对）路径作为依赖项说明符的pip或setuptools ，然后使用 Git 子模块来填充这些路径。 例如：

git submodule add git@github.com/fergusmac/foo.git
pip install ./foo

这将安装您添加子模块时检出的 foo 的任何版本。 正如这个答案所解释的，您可以更改子模块的检出版本，然后像这样安装它：

cd foo
git checkout v0.3.2
cd ..
pip install ./foo

对于 setuptools，您可以像这样指定它：

from pathlib import Path

...

setup(
    name='bar',
    install_requires=[
        f'foo @ file://localhost/{Path(__file__).parent}/foo/',
    ],
)

Path(__file__).parent是包含 bar 的setup.py文件的目录。 该位/foo/的路径（例如/foo/在这种情况下）应该是 foo 的子模块相对于包含 bar 的setup.py文件的目录的位置。

---

后续问题 - 我将如何指定“检查 foo 的主分支并安装任何版本，如果它高于当前安装的版本”？

在子模块中签出master ，然后通过pip install --upgrade . （假设.是 bar 的项目目录）。

---

另见： https : //softwareengineering.stackexchange.com/a/365583/271937