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

Question

我在私有(private) 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 版。
当我尝试安装这个 setup.py 时，通过 pip install . , 或 pip install . -U版本没有升级 - repo 甚至没有 checkout :

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 安装会产生不同的行为。我如何确保它检查 repo 并寻找正确的版本？
后续问题 - 我将如何指定“检查 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

这将安装您添加子模块时 check out 的 foo 的任何版本。如 this answer解释说，您可以更改子模块的 check out 版本，然后像这样安装它:

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 的子模块相对于包含 bar 的 setup.py 的目录的位置。文件。

Follow up question - how would I specify 'check master branch for foo and install whatever version is there if it is higher than the current installed version'?

checkout master在子模块中，然后通过 pip install --upgrade . 安装(假设 . 是 bar 的项目目录)。

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