基于Poetry构建python-pam的Debian软件包遇阻求助

一、适配pyproject.toml的最小rules文件 #

对于使用pyproject.toml的Python包，Debian的dh-python工具链已经原生支持，不需要复杂配置。你可以用以下最小可行的rules文件：

#!/usr/bin/make -f

%:
	dh $@ --with python3

override_dh_auto_build:
	dh_auto_build -- build

override_dh_auto_install:
	dh_auto_install -- install --destdir=$(CURDIR)/debian/python3-pam

• dh $@ --with python3：启用Python3打包支持，dh会自动识别pyproject.toml的构建后端
• override_dh_auto_build：明确调用pyproject.toml定义的构建命令，兼容setuptools、Poetry等不同构建工具
• override_dh_auto_install：将构建产物安装到Debian包的指定目录，确保后续打包能正确拾取

二、按需补充的rules内容 #

根据python-pam的特性，你可以选择性添加以下内容：

1. 测试执行（如果包有测试用例） #

如果python-pam自带测试，添加测试环节：

override_dh_auto_test:
	dh_auto_test -- pytest -v

注意要在control文件的Build-Depends中添加python3-pytest依赖。

2. 额外清理操作 #

如果构建过程产生了Poetry锁文件、虚拟环境等冗余文件，添加清理规则：

override_dh_clean:
	dh_clean
	rm -rf dist build .venv poetry.lock

3. 资源文件安装 #

如果包包含man手册、配置文件等额外资源，需要手动指定安装路径，比如：

override_dh_installman:
	dh_installman debian/python3-pam.1

三、必须检查的其他配置文件 #

1. control文件关键项 #

• Build-Depends：必须包含debhelper-compat (= 13)（或对应版本）、dh-python、python3-dev；如果用Poetry构建，需额外添加python3-poetry或python3-build+python3-installer
• Depends：使用${python3:Depends}自动生成Python依赖，避免手动维护
• Package：命名为python3-pam（符合Debian Python包命名规范）

2. pyproject.toml检查 #

确保构建系统配置正确，比如用setuptools的情况：

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

dh-python会自动识别并调用对应构建工具。

3. 其他必填文件 #

• copyright：必须包含python-pam的版权声明和许可证信息（比如GPL）
• changelog：用dch命令生成，版本号遵循Debian规范（例如1.8.5-1，上游版本-Debian修订版）

四、验证打包流程 #

在运行gbp buildpackage --git-pristine-tar之前，先单独执行dpkg-buildpackage -us -uc测试构建，排除git相关干扰，快速定位rules或配置的问题。

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