7a9d51cc70
按要求补三项(本轮不推、不打真实 tag、不部署;全部用临时仓库与假对象验):
1) 正式构建身份不能只认 --release:
- 新增 release_evidence():核①完整 40 位 SHA ②**指向该提交的注释 tag** v<版本号>
③该提交里 CHANGELOG 顶部版本一致。缺任一条 ⇒ rc=2,身份退回 development 并把
release_blocked 的原因写进 JSON(给机器读,也给人看)。
- version.py --self-test:六条负例(有版本无 tag / unknown SHA / 短 SHA / tag 指错提交 /
轻量 tag / 版本不一致)+ 证据齐正例,**tag 全部在 mktemp 临时仓库里创建**。
- Go 侧新增 TestReleaseBuildRequiresEvidence:release 构建必须 CommitSHA 完整且
v<ReleaseVersion> 是**注释 tag** 并指向该提交(独立于 Python 的二次复核)。
2) 发布预检区分"准备建议"与"发布就绪":
- 新增纯函数 readiness(facts) → (是否就绪, 阻塞项, 建议);输出分两段。
- **就绪要求候选版本已写进目标提交**(version_in_commit:查 git show <sha>:CHANGELOG.md,
工作区写了没提交不算);首发按**显式指定版本**处理,**不把"记录里有这个版本"当已发布**
(已发布的证据是 tag,不是记录条目)。
- 预检**不执行、也不在输出里推荐自动发布路径**(正式发版由人按 docs/RELEASE_RUNBOOK.md)。
3) CI 就绪判据:必需 context 集合来自 .gitea/required-contexts.txt(缺失/为空 ⇒ 没有策略 ⇒
阻断,不用观察到的状态顶替);**全部 success 才通过**,失败/缺项/pending/查询异常一律阻断。
Release 查询加 release_state():**只有 HTTP 404 才算不存在**,403/5xx/超时算查询异常 ⇒ 阻断。
验证:version.py --self-test 绿;release_preflight --self-test 绿(就绪判定 19 个分支 +
临时仓库验证 git show 语义 + 五个 HTTP 码语义);go test 三态(未注入 SKIP / 开发 PASS /
自称正式 RED);反向夹具 83/0(含临时仓库 go test 六例、预检"记录未进提交"两态);
make verify 15/15 success。
136 lines
5.7 KiB
Go
136 lines
5.7 KiB
Go
package version
|
||
|
||
import (
|
||
"os"
|
||
"os/exec"
|
||
"path/filepath"
|
||
"regexp"
|
||
"strings"
|
||
"testing"
|
||
)
|
||
|
||
// changelogTopVersion 返回仓库根 CHANGELOG.md 顶部的已发布版本号;还没有正式版本时返回 ""。
|
||
func changelogTopVersion(t *testing.T) string {
|
||
t.Helper()
|
||
path := filepath.Join("..", "..", "CHANGELOG.md")
|
||
raw, err := os.ReadFile(path)
|
||
if err != nil {
|
||
t.Fatalf("读不到 %s:%v(版本号的唯一来源就在这里)", path, err)
|
||
}
|
||
m := regexp.MustCompile(`(?m)^##\s*\[(\d+\.\d+\.\d+)\]`).FindSubmatch(raw)
|
||
if m == nil {
|
||
return ""
|
||
}
|
||
return string(m[1])
|
||
}
|
||
|
||
// 版本契约:注入进二进制的**正式版本基线**,必须等于仓库根 CHANGELOG.md 顶部的已发布版本。
|
||
//
|
||
// 为什么要有这条断言:CHANGELOG.md 是版本号的**唯一来源**,而注入是构建期动作。
|
||
// 两者只要没人对账,就会出现"改了 CHANGELOG 没重新构建"(产物报旧号)或
|
||
// "构建时手填了一个号"(产物报的号 CHANGELOG 里根本没有)—— 两种都让
|
||
// "线上跑的是哪个提交/版本"这个问题失去答案,而症状是静默的。
|
||
//
|
||
// ⚠️ "还没有正式版本"不等于出错:那时 ReleaseVersion 必须是空,**不许**编一个基线出来。
|
||
//
|
||
// 未注入时(普通 `go test ./...`)本用例 Skip:本地跑全量测试不必先构建。
|
||
// 但 CI 必须带 -ldflags 跑它,**并断言没有 SKIP**(被跳过的断言等于没有断言)。
|
||
func TestNumberMatchesChangelog(t *testing.T) {
|
||
if !HasInjection() {
|
||
t.Skip("构建身份未注入(没有 -ldflags);CI 会注入后跑这条断言,并断言它没有 Skip")
|
||
}
|
||
want := changelogTopVersion(t)
|
||
if want == "" {
|
||
if ReleaseVersion != "" {
|
||
t.Fatalf("CHANGELOG.md 里还没有已发布版本,ReleaseVersion 却是 %q —— 不许编一个版本基线出来", ReleaseVersion)
|
||
}
|
||
} else if ReleaseVersion != want {
|
||
t.Fatalf("注入的 ReleaseVersion %q != CHANGELOG 顶部 %q。"+
|
||
"常见原因:改了 CHANGELOG 却没重新构建(产物还报旧号),"+
|
||
"或者构建时手填了一个 CHANGELOG 里没有的号", ReleaseVersion, want)
|
||
}
|
||
if Number != ReleaseVersion && Number != "dev" {
|
||
t.Fatalf("Number %q 既不是 ReleaseVersion %q 也不是 dev —— 注入口径不一致", Number, ReleaseVersion)
|
||
}
|
||
}
|
||
|
||
// 开发构建不许自称正式版:这是"用正式版号代表开发版"那个问题的守门断言。
|
||
//
|
||
// - `BuildKind=release` 只允许出现在**确实有正式版本基线**的构建上,且显示就是那个版本;
|
||
// - 开发构建的 DisplayVersion 必须带 `dev` 形状,**不允许**退化成只显示上一正式版本号。
|
||
func TestDevBuildDoesNotClaimRelease(t *testing.T) {
|
||
if !HasInjection() {
|
||
t.Skip("构建身份未注入(没有 -ldflags);CI 会带 -ldflags 跑它,并断言它没有 Skip")
|
||
}
|
||
want := changelogTopVersion(t)
|
||
disp := DisplayVersion()
|
||
|
||
if BuildKind == "release" {
|
||
if want == "" {
|
||
t.Fatalf("标成了发布构建(BuildKind=release),但 CHANGELOG.md 里没有任何已发布版本条目 —— "+
|
||
"发布构建必须基于正式版本记录(现在显示 %q)", disp)
|
||
}
|
||
if ReleaseVersion != want || !semver.MatchString(ReleaseVersion) {
|
||
t.Fatalf("发布构建的 ReleaseVersion %q 不是 CHANGELOG 顶部的正式版本 %q", ReleaseVersion, want)
|
||
}
|
||
if disp != ReleaseVersion {
|
||
t.Fatalf("发布构建 DisplayVersion %q 应等于 ReleaseVersion %q", disp, ReleaseVersion)
|
||
}
|
||
return
|
||
}
|
||
|
||
if BuildKind != "development" {
|
||
t.Fatalf("BuildKind %q 既不是 development 也不是 release", BuildKind)
|
||
}
|
||
if !strings.Contains(disp, "dev") {
|
||
t.Fatalf("开发构建的 DisplayVersion %q 没有 dev 标识 —— 开发构建不能只显示正式版本号", disp)
|
||
}
|
||
if strings.Contains(disp, "+g") && ShortSHA() == "" {
|
||
t.Fatalf("DisplayVersion %q 带了 +g 但 CommitSHA %q 不是有效 SHA", disp, CommitSHA)
|
||
}
|
||
switch {
|
||
case want != "" && ShortSHA() != "":
|
||
if want := want + "-dev+g" + ShortSHA(); disp != want {
|
||
t.Fatalf("开发构建 DisplayVersion %q,期望 %q", disp, want)
|
||
}
|
||
case want == "" && ShortSHA() != "":
|
||
if want := "dev+g" + ShortSHA(); disp != want {
|
||
t.Fatalf("无正式基线的开发构建 DisplayVersion %q,期望 %q", disp, want)
|
||
}
|
||
}
|
||
}
|
||
|
||
// 正式构建必须**有证据**:完整提交 SHA + 一个指向该提交的**注释 tag** `v<ReleaseVersion>`。
|
||
// 光有"CHANGELOG 顶部有版本号"不算 —— 那会把每个开发构建都说成正式版。
|
||
func TestReleaseBuildRequiresEvidence(t *testing.T) {
|
||
if !HasInjection() {
|
||
t.Skip("构建身份未注入(没有 -ldflags);CI 会带 -ldflags 跑它,并断言它没有 Skip")
|
||
}
|
||
if BuildKind != "release" {
|
||
return // 开发构建由 TestDevBuildDoesNotClaimRelease 管
|
||
}
|
||
if !fullSHA.MatchString(CommitSHA) {
|
||
t.Fatalf("标成了正式构建,但 CommitSHA=%q 不是完整 40 位 —— 没有准确提交就谈不上正式版", CommitSHA)
|
||
}
|
||
name := "v" + ReleaseVersion
|
||
out, err := exec.Command("git", "tag", "--points-at", CommitSHA).Output()
|
||
if err != nil {
|
||
t.Fatalf("跑 `git tag --points-at %s` 失败:%v(正式构建必须能核到 tag 证据)", CommitSHA[:12], err)
|
||
}
|
||
tags := strings.Fields(string(out))
|
||
found := false
|
||
for _, x := range tags {
|
||
if x == name {
|
||
found = true
|
||
}
|
||
}
|
||
if !found {
|
||
t.Fatalf("标成了正式构建(%s),但提交 %s 上没有 tag %s(现有指向该提交的 tag:%v)—— "+
|
||
"正式构建必须有指向该提交的合规 tag", ReleaseVersion, CommitSHA[:12], name, tags)
|
||
}
|
||
kind, err := exec.Command("git", "cat-file", "-t", "refs/tags/"+name).Output()
|
||
if err != nil || strings.TrimSpace(string(kind)) != "tag" {
|
||
t.Fatalf("tag %s 不是**注释 tag**(`git tag -a`)—— 轻量 tag 不算发布证据", name)
|
||
}
|
||
}
|