Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

10.4 KB
Raw Blame
import subprocess
import tempfile
import unittest
from pathlib import Path

from scripts import version_bump
from scripts.version_bump import (
    VersionError, bump_part_for, bump_version, plan_bump, read_version, runtime_inputs_changed,
    write_version,
)

#: 版本号的唯一来源,`src/peach/__init__.py` 在测试仓库里的最小复刻。
VERSION_SEED = '"""Peach application package."""\n\n__version__ = "0.7.14"\n'


class BumpPartTests(unittest.TestCase):
    def test_the_bump_part_follows_commit_types_and_new_migrations(self):
        """feat 与破坏性标记推 minor,新迁移文件推 minor,其余都是 patch;major 不自动判。"""
        self.assertEqual(bump_part_for(["fix: 抽屉重画只写滚动层"], []), "patch")
        self.assertEqual(bump_part_for(["docs: 记录运行状态", "chore(release): 版本 0.7.27"], []),
                         "patch")
        self.assertEqual(bump_part_for(["refactor(follow): 来源登记表变成唯一真相"], []), "patch")
        self.assertEqual(bump_part_for(["feat: 配置页并入主站管理菜单"], []), "minor")
        self.assertEqual(bump_part_for(["feat(web): 滚动条改成自绘覆盖式"], []), "minor")
        self.assertEqual(bump_part_for(["fix!: 数据库路径改成 location 键"], []), "minor")
        self.assertEqual(bump_part_for(["refactor(config)!: 删掉盘符键"], []), "minor")
        self.assertEqual(bump_part_for(["fix: 补迁移"], ["migrations/0027_thing.sql"]), "minor")
        self.assertEqual(bump_part_for(["fix: 补迁移"], [r"migrations\0027_thing.sql"]), "minor")
        self.assertEqual(bump_part_for(["fix: 改了迁移的注释"], ["src/peach/tray.py"]), "patch")
        self.assertEqual(
            bump_part_for(["Merge branch 'master' into agent/claude/x", "feature: 新东西"], []),
            "minor")
        self.assertEqual(bump_part_for([], []), "patch")

    def test_runtime_inputs_are_told_apart_from_development_only_paths(self):
        self.assertTrue(runtime_inputs_changed(["src/peach/tray.py"]))
        self.assertTrue(runtime_inputs_changed(["web/app.js"]))
        self.assertTrue(runtime_inputs_changed(["frontend/src/main.ts"]))
        self.assertTrue(runtime_inputs_changed(["migrations/0042_thing.sql"]))
        self.assertTrue(runtime_inputs_changed(["resources/peach.ico"]))
        self.assertTrue(runtime_inputs_changed(["scripts/build_windows.ps1"]))
        self.assertTrue(runtime_inputs_changed(["scripts/build_app_entry.py"]))
        for path in ("scripts/build_macos_app.py", "scripts/build_macos_standalone.py",
                     "scripts/peach_macos.spec", "scripts/package_windows_release.py",
                     "scripts/installer/peach.iss", "scripts/ci_windows.ps1",
                     "scripts/ci_macos.sh", ".gitlab-ci.yml"):
            with self.subTest(path=path):
                self.assertTrue(runtime_inputs_changed([path]))
        self.assertTrue(runtime_inputs_changed(["pyproject.toml"]))
        self.assertTrue(runtime_inputs_changed(["uv.lock"]))
        self.assertTrue(runtime_inputs_changed([".github/workflows/release.yml"]))
        self.assertTrue(runtime_inputs_changed([r"src\peach\tray.py"]))

        self.assertFalse(runtime_inputs_changed([]))
        self.assertFalse(runtime_inputs_changed(["docs/STATUS.md", "AGENTS.md"]))
        self.assertFalse(runtime_inputs_changed(["tests/test_tray.py"]))
        self.assertFalse(runtime_inputs_changed([".claude/skills/peach-worktree/SKILL.md"]))
        self.assertFalse(runtime_inputs_changed(["scripts/agent_worktree.py"]))

    def test_only_the_version_line_moves(self):
        updated, version = bump_version(VERSION_SEED, "patch")
        self.assertEqual(version, "0.7.15")
        self.assertEqual(updated,
                         '"""Peach application package."""\n\n__version__ = "0.7.15"\n')

        self.assertEqual(bump_version('__version__ = "0.7.14"', "minor")[1], "0.8.0")
        self.assertEqual(bump_version('__version__ = "0.7.14"', "major")[1], "1.0.0")
        with self.assertRaisesRegex(VersionError, "unknown bump part"):
            bump_version('__version__ = "0.7.14"', "epoch")
        with self.assertRaisesRegex(VersionError, "__version__"):
            bump_version("nothing here\n", "patch")


class ReleasePlanTests(unittest.TestCase):
    """区间与档位落在真实 git 仓库上,不是拿字符串假装。"""

    def setUp(self):
        self.tmp = tempfile.TemporaryDirectory()
        self.addCleanup(self.tmp.cleanup)
        # 先 resolve:CI runner 的临时目录都是别名,未 resolve 的路径只在本机成立。
        self.root = Path(self.tmp.name).resolve()
        subprocess.run(["git", "init", "-b", "master", str(self.root)], check=True,
                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
        self.git("config", "user.email", "[email protected]")
        self.git("config", "user.name", "Peach Test")
        self.commit("chore: 起点", self.write("src/peach/__init__.py", VERSION_SEED))

    def git(self, *args: str) -> str:
        done = subprocess.run(["git", "-C", str(self.root), *args], check=True,
                              capture_output=True, text=True, encoding="utf-8")
        return done.stdout.strip()

    def write(self, path: str, text: str = "改了\n") -> str:
        target = self.root / path
        target.parent.mkdir(parents=True, exist_ok=True)
        target.write_text(text, encoding="utf-8", newline="\n")
        return path

    def commit(self, subject: str, *paths: str) -> None:
        for path in paths:
            self.git("add", path)
        self.git("commit", "-m", subject)

    def tag(self, name: str = "v0.7.14") -> None:
        self.git("tag", "-a", name, "-m", f"Peach {name}")

    def test_the_range_starts_at_the_last_version_tag(self):
        self.tag()
        self.commit("fix: 托盘图标补回来", self.write("src/peach/tray.py"))
        self.assertEqual(version_bump.last_tag(self.root), "v0.7.14")
        self.assertEqual(version_bump.release_range(self.root), "v0.7.14..HEAD")
        self.assertEqual(version_bump.subjects_in(self.root, "v0.7.14..HEAD"),
                         ["fix: 托盘图标补回来"])
        self.assertEqual(version_bump.changed_in(self.root, "v0.7.14..HEAD"),
                         ["src/peach/tray.py"])

    def test_without_any_tag_the_range_is_the_whole_history(self):
        self.assertIsNone(version_bump.last_tag(self.root))
        self.assertEqual(version_bump.release_range(self.root), "HEAD")
        self.assertEqual(version_bump.changed_in(self.root, "HEAD"), ["src/peach/__init__.py"])
        self.assertEqual(plan_bump(self.root)["version"], "0.7.15")

    def test_a_feature_since_the_last_tag_plans_the_next_minor(self):
        self.tag()
        self.commit("feat: 配置页加桌面快捷方式", self.write("src/peach/routes_configuration.py"))
        planned = plan_bump(self.root)
        self.assertEqual((planned["range"], planned["bump"], planned["current"],
                          planned["version"], planned["commits"]),
                         ("v0.7.14..HEAD", "minor", "0.7.14", "0.8.0", 1))

    def test_a_fix_since_the_last_tag_plans_the_next_patch(self):
        self.tag()
        self.commit("fix: 忙态提示说明在做什么", self.write("web/app.js"))
        self.assertEqual(plan_bump(self.root)["version"], "0.7.15")

    def test_an_explicit_part_overrides_the_commit_types(self):
        self.tag()
        self.commit("fix: 一处小修", self.write("src/peach/tray.py"))
        self.assertEqual(plan_bump(self.root, "major")["version"], "1.0.0")
        self.assertEqual(plan_bump(self.root, "minor")["version"], "0.8.0")

    def test_release_workflow_changes_plan_a_patch(self):
        self.tag()
        self.commit("fix(desktop): 发布构建使用完整依赖", self.write(".github/workflows/release.yml"))
        self.assertEqual(plan_bump(self.root)["version"], "0.7.15")

    def test_locked_dependency_changes_plan_a_patch(self):
        self.tag()
        self.commit("fix(desktop): 固定构建依赖", self.write("uv.lock"))
        self.assertEqual(plan_bump(self.root)["version"], "0.7.15")

    def test_bundled_sidecar_fetch_changes_plan_a_patch(self):
        self.tag()
        self.commit('fix(desktop): 获取随包工具', self.write('scripts/fetch_cloudflared.ps1'))
        self.assertEqual(plan_bump(self.root)['version'], '0.7.15')

    def test_bundled_sidecar_lock_changes_plan_a_patch(self):
        self.tag()
        self.commit('fix(desktop): 固定随包工具版本', self.write('scripts/cloudflared-windows.json'))
        self.assertEqual(plan_bump(self.root)['version'], '0.7.15')

    def test_macos_disk_image_changes_plan_a_patch(self):
        self.tag()
        self.commit("fix(macos): 保留镜像资源签名", self.write("scripts/build_macos_standalone.py"))
        self.assertEqual(plan_bump(self.root)["version"], "0.7.15")

    def test_gitlab_release_build_changes_plan_a_patch(self):
        self.tag()
        self.commit("fix(packaging): 使用项目要求的解释器", self.write(".gitlab-ci.yml"))
        self.assertEqual(plan_bump(self.root)["version"], "0.7.15")

    def test_planning_writes_nothing(self):
        self.tag()
        self.commit("feat: 新面板", self.write("src/peach/panel.py"))
        plan_bump(self.root)
        self.assertEqual(read_version(self.root), "0.7.14")
        self.assertEqual(self.git("status", "--porcelain"), "")

    def test_a_batch_that_never_reaches_the_runtime_cannot_be_released(self):
        """只改文档、技能与测试时,打出来的包和上一个标签逐字节相同。"""
        self.tag()
        self.commit("docs: 记一笔运行状态", self.write("docs/STATUS.md"))
        self.commit("test: 补一条断言", self.write("tests/test_tray.py"))
        with self.assertRaisesRegex(VersionError, "开发过程"):
            plan_bump(self.root)

    def test_a_tag_with_nothing_after_it_cannot_be_released(self):
        self.tag()
        with self.assertRaisesRegex(VersionError, "没有提交"):
            plan_bump(self.root)

    def test_writing_the_version_leaves_the_rest_of_the_file_alone(self):
        self.assertEqual(write_version(self.root, "minor"), "0.8.0")
        self.assertEqual(read_version(self.root), "0.8.0")
        self.assertEqual((self.root / "src/peach/__init__.py").read_text(encoding="utf-8"),
                         VERSION_SEED.replace("0.7.14", "0.8.0"))


if __name__ == "__main__":
    unittest.main()