12.4 开源贡献闭环:使用 pyproject.toml 打包自己的 Python 工具库并发布至 PyPI
本节目录
欢迎来到 HelloWorld 技术社区(www.helloworld.net) 《Python 现代开发实战》全专栏的最后一课!
从第 1 节安装 uv 开始,到今天能独立架构异步高并发微服务,你已经完成了从 Python 学习者到现代工程实践者的完整蜕变。最后一公里,让我们把你在项目中沉淀出的通用工具封装成标准 Python 库,发布到全球开发者共享的 PyPI(Python Package Index),完成属于你的第一次开源发布闭环!
1. 完善 pyproject.toml 开源元数据
[project]
name = "helloworld-toolkit"
version = "0.1.0"
description = "Modern Python engineering utilities from HelloWorld Community"
readme = "README.md"
license = { text = "MIT" }
authors = [{ name = "CodeCraft", email = "dev@helloworld.net" }]
requires-python = ">=3.12"
keywords = ["utilities", "logging", "helloworld"]
classifiers = [
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"License :: OSI Approved :: MIT License",
]
dependencies = []
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
2. 一键构建 Wheel 分发包并安全发布
现代 PyPI 推荐使用 Trusted Publishers(OIDC 令牌免密认证) 配合 GitHub Actions 自动发布,本地调试或首次发包也可通过 uv 两条命令搞定:
# 1. 构建标准源码包 (.tar.gz) 与预编译二进制轮子 (.whl) 至 dist/ 目录
uv build
# 2. 先发布到 TestPyPI 测试仓库验证安装效果,确认无误后再推正式 PyPI
uv publish --publish-url https://test.pypi.org/legacy/
🎉 全专栏结业寄语(来自 HelloWorld 技术社区运营与技术团队)
至此,《Python 现代开发实战:从零构建到高并发架构》全专栏 12 章 48 节课程已全部圆满完结!
技术迭代永无止境,但扎实的数据结构直觉、严谨的类型与测试习惯、克制的并发架构设计,永远是你穿越周期的硬核底气。
🏆 终极毕业荣誉任务:
将你在本专栏沉淀出的任意实用工具库或异步小项目开源到 GitHub/Gitee(或发布至 TestPyPI),将仓库链接与项目简介带 #Python专栏毕业设计 标签发布在 www.helloworld.net 社区动态中!我们将为每一位完成毕业设计的开发者颁发 「HelloWorld 认证 Python 全栈架构师」 永久黄金勋章,并精选优秀项目登上社区首页置顶推荐!
感谢一路同行,我们在代码的世界里继续向更高处攀登!