SuperAPI AI 工具集

managing-python-releases

编程与开发

查看项目

更新于 10-16 01:10

技能介绍

该技能用于管理 Python 库的发布流程。用途与能力包括:语义化版本(MAJOR.MINOR.PATCH),其中 PATCH 为不改变 API 的修复,MINOR 为向后兼容的新功能,MAJOR 为破坏性变更;按 Keep a Changelog 格式维护 CHANGELOG,类别为 Added、Changed、Deprecated、Removed、Fixed、Security;在代码中写入版本,可在 src/package/init.py 设置 version = "1.2.3",或用 importlib.metadata 的 version("my-package") 获取。发布自动化由 tag 触发的 GitHub Actions 完成,使用 uv 构建并通过 trusted publishing 发布到 PyPI,无需存储令牌;示例工作流在 .github/workflows/release.yml,完整流水线(TestPyPI 试运行、GitHub release 与发布手册)见 AUTOMATION.md。弃用流程通过 warnings.warn 配合 stacklevel=2 使提示指向调用方,弃用参数、类或整个模块及迁移指南模板见 MIGRATION.md。发布步骤:更新 CHANGELOG.md、在 pyproject.toml 与 init.py 提升版本、提交并打标签 git commit -am "Release v1.2.0";git tag -a v1.2.0 -m "Release v1.2.0";git push origin main --tags,之后 CI 自动发布。限制:资料未提供具体版本号规则细节、价格、支持平台或效果数据,均暂未提供。