如何在pyproject.toml中动态设置GDAL依赖版本以匹配系统全局已安装版本？

这个问题挺常见的，毕竟GDAL的Python绑定版本必须和系统全局安装的GDAL库严格匹配，不然很容易出兼容性问题。不过遗憾的是，pyproject.toml本身是静态配置文件，没法直接执行shell命令来动态获取系统GDAL的版本号，不过我们有几种变通方案可以实现类似的效果：

方案1：结合setup.py动态获取版本 #

虽然现在推荐用pyproject.toml做配置，但我们可以搭配setup.py来实现动态依赖设置。具体步骤如下：

1. 在项目根目录创建setup.py文件，写入以下代码：

import subprocess
import sys
from setuptools import setup

def get_system_gdal_version():
    try:
        # 调用gdal-config获取系统GDAL版本
        result = subprocess.run(
            ["gdal-config", "--version"],
            capture_output=True,
            text=True,
            check=True
        )
        return result.stdout.strip()
    except (subprocess.CalledProcessError, FileNotFoundError):
        # 处理找不到gdal-config的情况，这里可以根据需求调整
        print(
            "警告：未找到gdal-config工具，请确保系统已安装GDAL，或手动指定GDAL版本",
            file=sys.stderr
        )
        # 可以返回一个最低兼容版本，或者直接抛出异常终止安装
        return ">=3.0.0"

setup(
    name="your-package-name",
    version="0.1.0",
    # 其他项目配置...
    install_requires=[
        f"GDAL=={get_system_gdal_version()}",
        # 其他依赖项...
    ]
)

2. 在pyproject.toml中指定使用setuptools作为构建后端：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

这样当用户执行pip install .时，setup.py会自动调用gdal-config获取系统GDAL版本，并将其作为Python GDAL包的依赖版本。

方案2：通过环境变量传递版本 #

如果你不想用setup.py，可以通过前置命令设置环境变量，再在pyproject.toml中引用这个变量：

1. 安装前先获取系统GDAL版本并设置环境变量：

export GDAL_VERSION=$(gdal-config --version)

2. 在pyproject.toml的依赖中引用这个环境变量：

[project]
name = "your-package-name"
version = "0.1.0"
dependencies = [
    "GDAL==${GDAL_VERSION}",
    # 其他依赖...
]

注意：这种方式依赖于构建后端对环境变量的支持，setuptools是支持这种变量替换的，但其他构建后端可能不兼容。

方案3：预安装检查脚本（辅助方案） #

如果你想更友好地处理用户环境，可以写一个简单的shell脚本作为安装前置检查，自动匹配版本并安装：

#!/bin/bash
GDAL_VERSION=$(gdal-config --version)
if [ -z "$GDAL_VERSION" ]; then
    echo "Error: gdal-config not found. Please install GDAL first."
    exit 1
fi
echo "Found system GDAL version: $GDAL_VERSION"
pip install GDAL==$GDAL_VERSION
# 再安装你的包
pip install .

用户只需要运行这个脚本，就能自动完成版本匹配和安装流程。

备注：内容来源于stack exchange，提问作者andrewr