refactor: unify plugin package version resolution

2026-09-06 16:07:01 +08:00 · 2026-08-24 11:01:51 +08:00
parent e95a9e123d
commit 34131baf02
3 changed files with 135 additions and 48 deletions
@@ -0,0 +1,80 @@
+"""插件市场同步与异步包代际解析的统一合同测试。"""
+
+from types import SimpleNamespace
+
+import pytest
+
+from app.adapters.external import market
+from app.adapters.external.market import PluginHelper
+
+
+@pytest.mark.parametrize(
+    ("configured_version", "requested_version", "expected"),
+    [
+        ("v3", None, ("v3", "v2", "")),
+        ("v3", "v2", ("v2", "")),
+        ("", None, ("",)),
+    ],
+)
+def test_package_version_candidates_have_one_canonical_order(
+    monkeypatch,
+    configured_version: str,
+    requested_version: str | None,
+    expected: tuple[str, ...],
+) -> None:
+    """显式版本、向后兼容版本和基础索引必须由一个有序事实源产生。"""
+    monkeypatch.setattr(
+        market,
+        "settings",
+        SimpleNamespace(VERSION_FLAG=configured_version),
+    )
+
+    assert PluginHelper._package_version_candidates(requested_version) == expected
+
+
+@pytest.mark.asyncio
+async def test_sync_and_async_package_resolution_visit_same_candidates(
+    monkeypatch,
+) -> None:
+    """同步与异步安装必须按相同顺序停止在首个兼容插件索引。"""
+    monkeypatch.setattr(
+        market,
+        "settings",
+        SimpleNamespace(VERSION_FLAG="v3"),
+    )
+    helper = PluginHelper.__new__(PluginHelper)
+    indexes = {
+        "v3": {},
+        "v2": {"CompatiblePlugin": {"version": "1.0.0"}},
+        None: {"CompatiblePlugin": {"version": "0.9.0", "v2": True}},
+    }
+    sync_candidates: list[str | None] = []
+    async_candidates: list[str | None] = []
+
+    def get_plugins(_repo_url: str, package_version: str | None = None) -> dict:
+        """记录同步入口访问顺序并返回固定索引。"""
+        sync_candidates.append(package_version)
+        return indexes[package_version]
+
+    async def async_get_plugins(
+        _repo_url: str,
+        package_version: str | None = None,
+    ) -> dict:
+        """记录异步入口访问顺序并返回同一份固定索引。"""
+        async_candidates.append(package_version)
+        return indexes[package_version]
+
+    monkeypatch.setattr(helper, "get_plugins", get_plugins)
+    monkeypatch.setattr(helper, "async_get_plugins", async_get_plugins)
+
+    sync_result = helper.get_plugin_package_version(
+        "CompatiblePlugin",
+        "https://github.com/example/plugins",
+    )
+    async_result = await helper.async_get_plugin_package_version(
+        "CompatiblePlugin",
+        "https://github.com/example/plugins",
+    )
+
+    assert sync_result == async_result == "v2"
+    assert sync_candidates == async_candidates == ["v3", "v2"]