feat: 完成 issue #85 [树脂] 树脂模板打包与版本发布

2026-08-05 05:21:43 +08:00
parent 6899a2977d
commit 2afea16005
4 changed files with 220 additions and 2 deletions
@@ -0,0 +1,114 @@
+# -*- coding: utf-8 -*-
+"""树脂模板打包与版本发布 —— issue #85（父 Issue #13 子任务）。
+
+按 `version.yaml`（#13）的 assets 清单把 iAOP-Template-Resin 打包发布：
+
+- `validate_version()`：semver 校验 + assets 清单文件/目录存在性检查
+  （发布前门禁，防止打包不完整）；
+- `package_template()`：按清单打包 zip（含 version.yaml + README），
+  输出 `dist/resin-{version}.zip`；
+- `render_release_notes()`：从 version.yaml 生成 Markdown 发布说明
+  （版本/行业/基线/资产清单/备注），供仓库 Release 使用。
+
+纯标准库实现（zipfile），无第三方依赖。
+"""
+from __future__ import annotations
+
+import os
+import re
+import zipfile
+from typing import List, Optional
+
+import yaml
+
+#: 模板根目录（相对本模块）
+TEMPLATE_ROOT = os.path.dirname(os.path.abspath(__file__))
+#: 版本清单（与 #13 同构）
+VERSION_PATH = os.path.join(TEMPLATE_ROOT, "version.yaml")
+
+#: semver 校验（x.y.z）
+_SEMVER_RE = re.compile(r"^\d+\.\d+\.\d+$")
+
+#: 打包时始终包含的清单外文件
+_ALWAYS_INCLUDE = ["version.yaml", "README.md"]
+
+
+def load_version(path: str = VERSION_PATH) -> dict:
+    """加载版本清单。"""
+    with open(path, "r", encoding="utf-8") as fh:
+        return yaml.safe_load(fh) or {}
+
+
+def validate_version(path: str = VERSION_PATH) -> List[str]:
+    """版本清单校验：semver 合法 + assets 文件/目录存在。
+
+    Returns:
+        问题列表（空 = 校验通过）。
+    """
+    problems: List[str] = []
+    version = load_version(path)
+    ver = str(version.get("version", ""))
+    if not _SEMVER_RE.match(ver):
+        problems.append(f"version 非法（需 semver x.y.z）：{ver!r}")
+    for rel in version.get("assets", []):
+        full = os.path.join(TEMPLATE_ROOT, rel)
+        if not os.path.exists(full):
+            problems.append(f"资产缺失：{rel}")
+    return problems
+
+
+def _add_entry(zf: zipfile.ZipFile, rel: str) -> None:
+    """把单个文件或目录加入 zip（保留相对路径）。"""
+    full = os.path.join(TEMPLATE_ROOT, rel)
+    if os.path.isdir(full):
+        for root, _, files in os.walk(full):
+            for name in files:
+                abs_path = os.path.join(root, name)
+                zf.write(abs_path, os.path.relpath(abs_path, TEMPLATE_ROOT))
+    else:
+        zf.write(full, rel)
+
+
+def package_template(path: str = VERSION_PATH,
+                     output_dir: Optional[str] = None) -> str:
+    """按 assets 清单打包模板为 zip。
+
+    Returns:
+        生成的 zip 文件路径。
+    """
+    version = load_version(path)
+    ver = str(version.get("version", ""))
+    problems = validate_version(path)
+    if problems:
+        raise ValueError("打包前校验未通过：" + "; ".join(problems))
+
+    dist = output_dir or os.path.join(TEMPLATE_ROOT, "dist")
+    os.makedirs(dist, exist_ok=True)
+    zip_path = os.path.join(dist, f"resin-{ver}.zip")
+    with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zf:
+        entries = _ALWAYS_INCLUDE + list(version.get("assets", []))
+        for rel in dict.fromkeys(entries):  # 去重保序
+            _add_entry(zf, rel)
+    return zip_path
+
+
+def render_release_notes(path: str = VERSION_PATH) -> str:
+    """从 version.yaml 生成 Markdown 发布说明。"""
+    version = load_version(path)
+    lines = [
+        f"# iAOP-Template-Resin v{version.get('version', '?')}",
+        "",
+        f"- 行业：{version.get('industry', '')}",
+        f"- 基线：{version.get('baseline', '')}",
+        f"- 并行：{version.get('parallel_with', '')}",
+        f"- 状态：{version.get('status', '')}",
+        "",
+        "## 资产清单",
+    ]
+    lines += [f"- `{a}`" for a in version.get("assets", [])]
+    notes = version.get("notes", [])
+    if notes:
+        lines.append("")
+        lines.append("## 备注")
+        lines += [f"- {n}" for n in notes]
+    return "\n".join(lines) + "\n"