释放

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

如果提供了版本(以上非空)

将其验证为 PEP 440 字符串(例如 1.2.3、1.2.3a1、1.2.3rc1、1.2.3.post1)。注意:PEP 440 版本不得以 v 开头 — 该前缀属于 git 标签,而不是版本字符串。如果无效请停止并要求用户更正。将其存储为 VERSION 以供所有后续步骤使用。

如果没有提供版本(上面是空的)

分析步骤 1 中列出的提交以推荐正确的下一个版本。步骤 1 中显示的最后一个标签使用 v 前缀(例如 v1.14.3);在计算下一个版本时将其剥离,以便结果是一个裸 PEP 440 字符串(例如 1.14.4,而不是 v1.14.4)。应用这些 semver 规则: 主要碰撞 (X+1.0.0) — 任何破坏公共 API 或记录行为的提交

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@psd-tools · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
步骤 0 — 确定目标版本

提供的版本:$ARGUMENTS

02
第 1 步 - 审查自上次发布以来的提交

获取标签: !`git fetch --tags -q || echo "Warning: failed to fetch tags — check network/auth and consider retrying."` 最后一个标签: !`git describe --tags --abbrev=0 2>/dev/null || echo "(none)"` 今天的日期: !`date +%Y-%m-%d` 现在通过运行以下命令之一列出自上次发布以来的提交:

03
第 2 步 - 草稿变更日志条目

阅读`docs/changelog.rst` 了解当前格式,然后使用此 RST 格式为 VERSION 起草一个新条目: 重要提示:`-` 下划线必须至少与标题行一样长(RST 要求)。计算`VERSION (YYYY-MM-DD)`中的确切字符并使用那么多的破折号。使用这些类别(每个项目符号选择最具体的一个):

04
第 3 步 — 更新 docs/changelog.rst

将批准的变更日志条目直接添加到 `Changelog` 标题块和下面的空行之后,在标题和新条目之间留下一个空行。

05
步骤 4 — 创建发布分支并提交

然后使用编辑工具更新 `src/psd_tools/version.py` — 将现有的 `__version__` 行替换为: `VERSION` 是没有 `v` 前缀的裸 PEP 440 字符串(例如 `1.15.0`,而不是 `v1.15.0`)。然后暂存更改的文件并提交:将 `VERSION` 替换为实际版本字符串(例如 `1.15.0`)。

06
第 5 步——打开拉取请求

使用 `--title "Release vVERSION"` 和 `--body` 运行`gh pr create`,其中包含: A `## Release vVERSION` 标题 A `### Changelog` 部分,其中将步骤 2 中批准的条目粘贴到 A `### Release checklist` 部分,其中包含以下项目: `[ ] Changelog entry reviewed and accurate`

07
第 6 步 — 完成

打印 PR URL。提醒用户:PR 获得批准并合并后,`auto-tag` GitHub Actions 工作流程会自动将合并提交标记为`vVERSION`。该标签推送会触发`release`工作流程,为所有平台构建轮子并发布到 PyPI。无需手动标记或发布。将 `VERSION` 替换为实际版本字符串。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。