如何配置使pip show显示Summary、Home-Page等元数据字段?
问题解决:pip show字段为空的配置修正
针对你遇到的pip show中Summary、Home-Page、Author、License字段为空的问题,结合你的pyproject.toml配置,给出以下修正方案:
1. Summary(摘要)
你已通过移除dynamic中的description并显式声明解决此问题,确认配置如下:
[project] # 移除dynamic里的"description",添加显式描述 description = "你的项目简短摘要" # 替换为实际项目描述
如果希望从README自动提取摘要,可保持dynamic = ["description"]并确保Hatchling版本≥1.10.0(该版本优化了README提取逻辑)。
2. Home-Page
旧版pip(如22.1.2)对PEP 621的URL配置映射支持不完善,需确保Hatchling正确将Home地址映射到旧元数据字段。检查配置格式是否正确:
[project.urls] Home = "你的项目主页地址"
若仍不显示,建议升级pip至23.0+(新版pip对PEP 621元数据支持更完善)。
3. Author
pip show的Author字段对应旧元数据格式,而PEP 621使用authors列表形式。Hatchling需将列表中的作者名称拼接为单个字符串,若当前版本未自动处理,可升级Hatchling至≥1.8.0版本(该版本优化了作者字段的映射逻辑)。同时确保authors配置格式正确:
[project] authors = [ {name = "Wolfgang Fahl", email = "wf@bitplan.com"}, {name = "Tim Holzheim", email = "tim.holzheim@rwth-aachen.de"} ]
4. License
PEP 621中license字段若使用SPDX标识符,需确保Hatchling将其映射到旧元数据的License字段。若当前配置license = "Apache-2.0"不生效,可改为对象格式:
[project] license = {text = "Apache-2.0"}
同时升级Hatchling至≥1.7.0版本,该版本修复了License字段的打包问题。
完整修正后的关键片段
[project] name = "py-3rdparty-mediawiki" description = "Python第三方MediaWiki工具库" # 显式摘要 authors = [ {name = "Wolfgang Fahl", email = "wf@bitplan.com"}, {name = "Tim Holzheim", email = "tim.holzheim@rwth-aachen.de"} ] license = {text = "Apache-2.0"} dynamic = ["version"] # 移除"description" # ... 其余配置保持不变 [project.urls] Home = "你的项目主页地址" # ... 其余URL保持不变
额外建议
- 升级Hatchling到最新稳定版:
pip install --upgrade hatchling - 升级pip到最新版:
pip install --upgrade pip - 重新构建并安装包:
hatch build && pip install dist/*.whl
内容的提问来源于stack exchange,提问作者Wolfgang Fahl
相关产品推荐
相关产品推荐

