refactor: 本仓升为唯一源(原 sap-cli 源码仓归档)

方向反转:此前 SKILL.md 是「模板渲染产物」、sap-cli 是源;现 sap-cli 归档,
sap-cli-skill 承接开发与分发,SKILL.md 回归手工维护的正本。

迁移(来自 sap-cli,共 104 文件):
- tests/           692 例测试(15 个文件的内联 sys.path 改指 assets/)
- openspec/        SDD 规格与归档变更(42 文件)
- docs/            开发文档与 ADT 原理(含 dev/CLAUDE.md、AGENTS.md)
- .claude/         rules 副本 + settings.json(供 Claude Code)
- .github/ .hermes/ .pre-commit-config.yaml .editorconfig CLAUDE.md
- scripts/ 保持仅 setup.py(pack_skill.py 已随旧仓归档,不迁)

修复(迁移暴露的真实缺陷):
- assets/pyproject.toml 的 build-backend 写作 `setuptools.backends._legacy:_Backend`,
  该模块在 setuptools 中不存在 → `pip install -e` 从来装不上。改为 build_meta。
  实测:临时 venv 安装成功,sap-cli --help 正常列出 31 个命令
- pyproject readme 指向不存在的 assets/README.md(editable 安装会失败)→ 改内联文本
- pyproject urls 改指 sap-cli-skill

机制调整:
- .github/workflows/ci.yml 适配 assets/ 布局;顶部注明该工作流仅 GitHub 执行,
  本仓在 Gitee 不会自动跑
- pre-commit 增本地测试门禁(Gitee 上真正生效的那道)
- .gitignore 合并旧仓完整规则(保留 log/ 下 md 知识库入库,只忽略运行日志)
- 大文件上限 100KB→1MB(架构图 512KB)

守卫测试 tests/unit/test_repo_guards.py(10 → 18 例):
- SKILL.md 须记录 parser 全部 CLI 命令 / 铁律 1-5 须为真实小节标题 / 示例不得违反铁律 5
- references/ 规则齐备;.claude/rules 与 references 必须一致(实测抓到一次真实漂移)
- VERSION == sapcli.__version__ == README 版本
- 仓内不得再出现 pack_skill.py / skill-src(防废弃流程回潮)

698 tests OK;editable 安装与 CLI 入口经临时 venv 实测通过。
docs/RELEASING.md 重写为单源开发流程。
This commit is contained in:
吴让宇
2026-09-11 00:40:15 +08:00
parent e786742bcb
commit c5905a5b1e
104 changed files with 20744 additions and 10 deletions
+171
View File
@@ -0,0 +1,171 @@
"""commands/enhancement.py 单元测试 — cmd_enhancement。
运行: python tests/unit/test_enhancement.py
"""
from __future__ import annotations
import argparse
import os
import sys
import unittest
from unittest.mock import MagicMock, patch
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "assets"))
def _args(**kwargs):
defaults = {"type": "class", "name": "ZCL_TEST"}
defaults.update(kwargs)
return argparse.Namespace(**defaults)
class TestCmdEnhancement(unittest.TestCase):
"""cmd_enhancement 查询对象的增强实现。"""
def test_object_not_found_raises(self):
from sapcli.commands.enhancement import cmd_enhancement
from sapcli.exceptions import ObjectNotFoundError
client = MagicMock()
client.object_exists.return_value = False
with self.assertRaises(ObjectNotFoundError) as ctx:
cmd_enhancement(_args(), client)
self.assertIn("ZCL_TEST", str(ctx.exception))
def test_api_error_prints_failure_and_returns(self):
"""get_enhancements 抛异常时打印失败并返回。"""
from sapcli.commands.enhancement import cmd_enhancement
client = MagicMock()
client.object_exists.return_value = True
client.get_enhancements.side_effect = Exception("network error")
with patch("builtins.print") as mock_print:
cmd_enhancement(_args(), client)
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
self.assertIn("失败", printed)
def test_no_enhancements(self):
"""无增强实现时打印提示。"""
from sapcli.commands.enhancement import cmd_enhancement
client = MagicMock()
client.object_exists.return_value = True
client.get_enhancements.return_value = []
with patch("builtins.print") as mock_print:
cmd_enhancement(_args(), client)
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
self.assertIn("未找到增强实现", printed)
def test_with_enhancements_and_full_elements(self):
"""增强实现含完整字段(enhanced_name、elements、mode、replacing)。"""
from sapcli.commands.enhancement import cmd_enhancement
client = MagicMock()
client.object_exists.return_value = True
client.get_enhancements.return_value = [
{
"name": "ZENH_TEST",
"type": "ENHO",
"enhanced_name": "ZCL_TEST",
"enhanced_type": "CLAS/OC",
"elements": [
{
"type": "METHOD", "name": "HELLO",
"mode": "overwrite", "replacing": "ZCL_TEST=>HELLO",
},
],
},
]
with patch("builtins.print") as mock_print:
cmd_enhancement(_args(), client)
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
self.assertIn("ZENH_TEST", printed)
self.assertIn("ENHO", printed)
self.assertIn("Enhanced Object", printed)
self.assertIn("ZCL_TEST", printed)
self.assertIn("METHOD: HELLO", printed)
self.assertIn("Mode: overwrite", printed)
self.assertIn("Replacing: ZCL_TEST=>HELLO", printed)
self.assertIn("Element 1", printed)
def test_element_label_name_only(self):
"""element 只有 name 时 label 为 name。"""
from sapcli.commands.enhancement import cmd_enhancement
client = MagicMock()
client.object_exists.return_value = True
client.get_enhancements.return_value = [
{
"name": "ZENH1", "elements": [{"name": "ONLY_NAME"}],
},
]
with patch("builtins.print") as mock_print:
cmd_enhancement(_args(), client)
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
self.assertIn("ONLY_NAME", printed)
def test_element_label_type_only(self):
"""element 只有 type 时 label 为 type。"""
from sapcli.commands.enhancement import cmd_enhancement
client = MagicMock()
client.object_exists.return_value = True
client.get_enhancements.return_value = [
{
"name": "ZENH1", "elements": [{"type": "ONLY_TYPE"}],
},
]
with patch("builtins.print") as mock_print:
cmd_enhancement(_args(), client)
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
self.assertIn("ONLY_TYPE", printed)
def test_enhancement_minimal_fields(self):
"""增强实现仅含 name(无 type/enhanced_name/elements)。"""
from sapcli.commands.enhancement import cmd_enhancement
client = MagicMock()
client.object_exists.return_value = True
client.get_enhancements.return_value = [{"name": "ZENH_MIN"}]
with patch("builtins.print") as mock_print:
cmd_enhancement(_args(), client)
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
self.assertIn("ZENH_MIN", printed)
# 默认 type 为 ENHO
self.assertIn("ENHO", printed)
# 无 enhanced_name 时不打印 Enhanced Object 行
self.assertNotIn("Enhanced Object", printed)
def test_multiple_enhancements_count(self):
"""多个增强实现时打印数量。"""
from sapcli.commands.enhancement import cmd_enhancement
client = MagicMock()
client.object_exists.return_value = True
client.get_enhancements.return_value = [
{"name": "ZENH1", "elements": []},
{"name": "ZENH2", "elements": []},
]
with patch("builtins.print") as mock_print:
cmd_enhancement(_args(), client)
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
self.assertIn("2", printed)
if __name__ == "__main__":
unittest.main(verbosity=2)