ping-rust 0.3.2

Menu-driven installer and manager for the shoes proxy server
"""Check release metadata and upgrade guidance before publishing a version."""

import argparse
import re
import unittest
from pathlib import Path

ROOT = Path(__file__).resolve().parents[2]
VERSION = "0.3.2"


class ReleaseMetadataTest(unittest.TestCase):
    def test_v030_documentation_has_current_release_and_reload_guidance(self):
        vless_enc = (ROOT / "docs" / "wiki" / "VLESS-ENC.md").read_text(encoding="utf-8")
        readme = (ROOT / "README.md").read_text(encoding="utf-8")
        for stale_text in ("开发分支", "未发版", "Release 可使用受验证热重载"):
            with self.subTest(stale_text=stale_text):
                self.assertNotIn(stale_text, vless_enc)
        self.assertIn("VLESS-ENC 与其他协议使用相同的热重载资格", vless_enc)
        self.assertNotIn("本分支把默认 shoes Release", readme)

    def test_manifest_and_lock_agree_with_release(self):
        manifest = (ROOT / "Cargo.toml").read_text(encoding="utf-8")
        lock = (ROOT / "Cargo.lock").read_text(encoding="utf-8")
        self.assertRegex(manifest, rf'(?m)^version = "{re.escape(VERSION)}"$')
        self.assertIn(f'name = "ping-rust"\nversion = "{VERSION}"', lock)

    def test_readme_installation_examples_use_release(self):
        readme = (ROOT / "README.md").read_text(encoding="utf-8")
        installation = readme.split("## 一键安装(推荐)", 1)[1].split("## 功能", 1)[0]
        self.assertIn(f"releases/tag/v{VERSION}", readme)
        self.assertIn(f"--version v{VERSION}", installation)
        self.assertNotRegex(installation, r"--version v0\.2\.")
        self.assertNotIn("VLESS-ENC(开发分支,未发版)", readme)

    def test_readme_downgrade_example_and_version_history(self):
        readme = (ROOT / "README.md").read_text(encoding="utf-8")
        self.assertRegex(readme, r"(?m)^sudo ping-rust self-update --version v0\.2\.2$")
        self.assertIn("sudo ping-rust update --method release --allow-downgrade", readme)
        self.assertIn("v0.2.2 将默认安装的 shoes 固定为经过验证的 v0.2.7", readme)

    def test_readme_self_update_commands_have_no_allow_downgrade(self):
        readme = (ROOT / "README.md").read_text(encoding="utf-8")
        self.assertNotRegex(
            readme,
            r"(?m)^[^\n]*\b(?:ping-rust|prs)\s+self-update\b[^\n]*--allow-downgrade\b",
        )

    def test_release_notes_state_verified_reality_clients_and_downgrade_limit(self):
        notes = (ROOT / "docs" / f"RELEASE_NOTES_v{VERSION}.md").read_text(encoding="utf-8")
        self.assertIn(
            "Reality 客户端:CI 实测 Xray **v25.5.16** 和 **v26.6.27** 可以连接,"
            "建议使用 Xray 25.5.16 及以上。更早的版本未验证,可能连不上"
            "(例如旧版 v2rayN 内置的 Xray),请先升级客户端及其 Xray 内核。",
            notes,
        )
        self.assertIn("删除 VLESS-ENC 节点后再降级的其他行为未验证。", notes)

    def test_release_notes_cover_compatibility_and_upgrade_order(self):
        notes = (ROOT / "docs" / f"RELEASE_NOTES_v{VERSION}.md").read_text(encoding="utf-8")
        for requirement in (
            "25.5.16", "旧版 v2rayN", "aes-128-gcm", "已有节点",
            "通配符", "自动迁移", "先升级 shoes", "不套 TLS",
            "不支持 sing-box", "v26.6.27", "v1.19.33", "CI 实测",
            "不能降级到 v0.2.x", "v0.3.6",
        ):
            with self.subTest(requirement=requirement):
                self.assertIn(requirement, notes)
        self.assertLess(notes.index("sudo ping-rust self-update"), notes.index("sudo ping-rust update"))
        self.assertNotIn("bero", notes)


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("--version", default=VERSION)
    args, remaining = parser.parse_known_args()
    VERSION = args.version
    unittest.main(argv=[__file__, *remaining])