如何参数化整个Pytest会话，自动测试Git子模块多版本

我正在使用pytest测试一个依赖外部Git子模块数据的Python模块，希望添加一个可选功能，自动针对该子模块的多个不同版本测试代码——即对所有>=1.0.0的Git tag运行全部测试。理想情况是调用一次pytest等价于依次执行以下命令：

git checkout 1.0.0
pytest
git checkout 1.0.1
pytest
git checkout 1.0.2
pytest
...

此时总测试执行次数为测试用例数 * 子模块版本数。

我尝试用pytest_sessionstart()钩子在测试套件运行前切换Git版本标签，代码如下：

@pytest.hookimpl()
def pytest_sessionstart(session):
    # Grab and populate the repo
    repo = git.Repo(path_to_repo)
    repo.git.fetch()

    tag_list = sorted([version_string_to_tuple(tag.name) for tag in repo.tags])
    # Only select versions >= 1.0.0
    tag_list = tag_list[tag_list.index((1, 0, 0)):]
    
    # Checkout (singular) version
    repo.git.checkout(version_tuple_to_string(tag_list[-1])) # latest, because why not

    # Test collection/execution begins after this function ends

但这种方式每次调用pytest只能切换一个版本，请问如何实现一次调用完成多版本测试？

方法一：参数化Fixture + 单测试用例多版本运行 #

核心是把Git版本作为参数注入每个测试用例，让每个测试用例自动遍历所有目标版本执行。通过Fixture在每个测试前后切换版本，保证环境隔离。

实现代码 #

import pytest
from git import Repo

# 工具函数：版本字符串转元组（如"1.0.0"→(1,0,0)）
def version_string_to_tuple(version_str):
    return tuple(map(int, version_str.split(".")))

# 工具函数：版本元组转字符串
def version_tuple_to_string(version_tuple):
    return ".".join(map(str, version_tuple))

def get_valid_submodule_tags(repo_path):
    repo = Repo(repo_path)
    repo.git.fetch("--tags")
    # 筛选并排序符合条件的标签
    all_tag_tuples = sorted([
        version_string_to_tuple(tag.name) 
        for tag in repo.tags 
        if tag.name.replace(".", "").isdigit()  # 过滤非语义化版本标签
    ])
    # 找到>=1.0.0的起始位置
    start_idx = all_tag_tuples.index((1, 0, 0))
    return [version_tuple_to_string(t) for t in all_tag_tuples[start_idx:]]

# 全局存储原始版本，用于测试后恢复
original_rev = None

@pytest.fixture(scope="function", params=get_valid_submodule_tags("path/to/your/submodule"))
def submodule_version(request):
    global original_rev
    repo = Repo("path/to/your/submodule")
    
    # 首次运行时保存当前分支/版本
    if original_rev is None:
        original_rev = repo.head.commit.hexsha
    
    # 切换到当前参数指定的版本
    repo.git.checkout(request.param)
    yield request.param  # 将版本号传递给测试用例（可选）
    
    # 测试完成后切回原始版本
    repo.git.checkout(original_rev)

# 示例测试用例：所有需要多版本测试的用例都需依赖该fixture
def test_data_parsing(submodule_version):
    # 测试逻辑：此时子模块已切换到指定版本
    from your_module import parse_submodule_data
    data = parse_submodule_data()
    assert len(data) > 0

方法二：自定义钩子 + 多轮测试套件运行 #

如果希望每个版本完整跑一遍整个测试套件（而非每个测试用例重复多版本），可以通过自定义钩子触发多轮测试，每轮切换一个版本。

实现代码 #

import pytest
from git import Repo

def pytest_addoption(parser):
    parser.addoption(
        "--test-submodule-versions",
        action="store_true",
        default=False,
        help="Run tests against all submodule versions >=1.0.0"
    )

def get_valid_submodule_tags(repo_path):
    repo = Repo(repo_path)
    repo.git.fetch("--tags")
    tag_tuples = sorted([
        version_string_to_tuple(tag.name) 
        for tag in repo.tags 
        if tag.name.replace(".", "").isdigit()
    ])
    start_idx = tag_tuples.index((1, 0, 0))
    return [version_tuple_to_string(t) for t in tag_tuples[start_idx:]]

@pytest.hookimpl(tryfirst=True)
def pytest_sessionstart(session):
    # 未启用多版本测试则跳过
    if not session.config.getoption("--test-submodule-versions"):
        return
    
    repo = Repo("path/to/your/submodule")
    original_rev = repo.head.commit.hexsha
    target_tags = get_valid_submodule_tags("path/to/your/submodule")
    
    # 遍历每个版本执行测试套件
    for tag in target_tags:
        print(f"\n=== Running tests against submodule version: {tag} ===")
        repo.git.checkout(tag)
        # 手动触发测试循环
        session.config.hook.pytest_runtestloop(session=session)
    
    # 恢复原始版本并终止默认测试流程
    repo.git.checkout(original_rev)
    session.shouldstop = True

使用方式：

pytest --test-submodule-versions

方法三：Shell脚本封装（最简方案） #

如果不想修改测试代码，直接用Shell脚本循环切换版本并调用pytest，快速实现需求：

#!/bin/bash

# 配置子模块路径
SUBMODULE_PATH="./path/to/your/submodule"
# 获取所有>=1.0.0的语义化版本标签
TAGS=$(cd "$SUBMODULE_PATH" && git fetch --tags && git tag -l | grep -E "^[0-9]+\.[0-9]+\.[0-9]+$" | sort -V | awk '$0 >= "1.0.0"')

# 保存当前版本
ORIGINAL_REV=$(cd "$SUBMODULE_PATH" && git rev-parse HEAD)

# 循环执行测试
for TAG in $TAGS; do
    echo -e "\n====================================="
    echo "Running tests with submodule version: $TAG"
    echo -e "=====================================\n"
    cd "$SUBMODULE_PATH" && git checkout "$TAG"
    pytest
done

# 恢复原始版本
cd "$SUBMODULE_PATH" && git checkout "$ORIGINAL_REV"

内容的提问来源于stack exchange，提问作者RedRuin