方向反转:此前 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 重写为单源开发流程。
207 lines
7.2 KiB
Python
207 lines
7.2 KiB
Python
"""commands/unit_test.py 单元测试 — cmd_unit_test + _parse_duration。
|
|
|
|
运行: python tests/unit/test_unit_test.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)
|
|
|
|
|
|
# ═══════════════════════════════════════════
|
|
# _parse_duration
|
|
# ═══════════════════════════════════════════
|
|
|
|
class TestParseDuration(unittest.TestCase):
|
|
"""_parse_duration 安全解析方法耗时。"""
|
|
|
|
def test_valid_float_string(self):
|
|
from sapcli.commands.unit_test import _parse_duration
|
|
self.assertEqual(_parse_duration("1.5"), 1.5)
|
|
self.assertEqual(_parse_duration("0.25"), 0.25)
|
|
self.assertEqual(_parse_duration("3"), 3.0)
|
|
|
|
def test_invalid_string_returns_zero(self):
|
|
from sapcli.commands.unit_test import _parse_duration
|
|
self.assertEqual(_parse_duration("abc"), 0.0)
|
|
|
|
def test_none_returns_zero(self):
|
|
from sapcli.commands.unit_test import _parse_duration
|
|
self.assertEqual(_parse_duration(None), 0.0)
|
|
|
|
def test_empty_string_returns_zero(self):
|
|
from sapcli.commands.unit_test import _parse_duration
|
|
self.assertEqual(_parse_duration(""), 0.0)
|
|
|
|
def test_zero_string(self):
|
|
from sapcli.commands.unit_test import _parse_duration
|
|
self.assertEqual(_parse_duration("0"), 0.0)
|
|
|
|
|
|
# ═══════════════════════════════════════════
|
|
# cmd_unit_test
|
|
# ═══════════════════════════════════════════
|
|
|
|
class TestCmdUnitTest(unittest.TestCase):
|
|
"""cmd_unit_test 执行 ABAP Unit 测试并汇总结果。"""
|
|
|
|
def test_api_error_prints_failure_and_returns(self):
|
|
"""run_unit_test 抛异常时打印失败提示并返回(不抛)。"""
|
|
from sapcli.commands.unit_test import cmd_unit_test
|
|
|
|
client = MagicMock()
|
|
client.run_unit_test.side_effect = Exception("connection refused")
|
|
|
|
with patch("builtins.print") as mock_print:
|
|
cmd_unit_test(_args(), client)
|
|
|
|
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
|
|
self.assertIn("失败", printed)
|
|
|
|
def test_no_test_classes(self):
|
|
"""无测试类时打印提示。"""
|
|
from sapcli.commands.unit_test import cmd_unit_test
|
|
|
|
client = MagicMock()
|
|
client.run_unit_test.return_value = {"summary": {}, "classes": []}
|
|
|
|
with patch("builtins.print") as mock_print:
|
|
cmd_unit_test(_args(), client)
|
|
|
|
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
|
|
self.assertIn("未找到测试类", printed)
|
|
|
|
def test_passed_class(self):
|
|
"""全部通过时打印 PASSED 和方法数。"""
|
|
from sapcli.commands.unit_test import cmd_unit_test
|
|
|
|
client = MagicMock()
|
|
client.run_unit_test.return_value = {
|
|
"summary": {
|
|
"tests": "2", "failures": "0", "errors": "0", "skipped": "0",
|
|
},
|
|
"classes": [
|
|
{
|
|
"name": "ZCL_TEST",
|
|
"methods": [
|
|
{"name": "test1", "duration": "1.5"},
|
|
{"name": "test2", "duration": "0.5"},
|
|
],
|
|
},
|
|
],
|
|
}
|
|
|
|
with patch("builtins.print") as mock_print:
|
|
cmd_unit_test(_args(), client)
|
|
|
|
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
|
|
self.assertIn("PASSED", printed)
|
|
self.assertIn("2 methods", printed)
|
|
# 合计行
|
|
self.assertIn("合计", printed)
|
|
|
|
def test_failed_class_with_alert_and_line(self):
|
|
"""方法失败时打印 FAILED、方法名、行号、告警内容。"""
|
|
from sapcli.commands.unit_test import cmd_unit_test
|
|
|
|
client = MagicMock()
|
|
client.run_unit_test.return_value = {
|
|
"summary": {
|
|
"tests": "1", "failures": "1", "errors": "0", "skipped": "0",
|
|
},
|
|
"classes": [
|
|
{
|
|
"name": "ZCL_TEST",
|
|
"methods": [
|
|
{
|
|
"name": "test_fail", "duration": "0.1",
|
|
"alert": "Assertion failed", "line": "42",
|
|
},
|
|
],
|
|
},
|
|
],
|
|
}
|
|
|
|
with patch("builtins.print") as mock_print:
|
|
cmd_unit_test(_args(), client)
|
|
|
|
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
|
|
self.assertIn("FAILED", printed)
|
|
self.assertIn("test_fail", printed)
|
|
self.assertIn("42", printed)
|
|
self.assertIn("Assertion failed", printed)
|
|
self.assertIn("at line 42", printed)
|
|
|
|
def test_failed_without_line_omits_line_info(self):
|
|
"""失败方法无 line 时不打印 at line。"""
|
|
from sapcli.commands.unit_test import cmd_unit_test
|
|
|
|
client = MagicMock()
|
|
client.run_unit_test.return_value = {
|
|
"summary": {},
|
|
"classes": [
|
|
{
|
|
"name": "ZCL_TEST",
|
|
"methods": [{"name": "test_x", "alert": "boom"}],
|
|
},
|
|
],
|
|
}
|
|
|
|
with patch("builtins.print") as mock_print:
|
|
cmd_unit_test(_args(), client)
|
|
|
|
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
|
|
self.assertIn("FAILED", printed)
|
|
self.assertIn("boom", printed)
|
|
self.assertNotIn("at line", printed)
|
|
|
|
def test_class_without_name_falls_back_to_display(self):
|
|
"""class name 为空时回退到 parsed.display_name。"""
|
|
from sapcli.commands.unit_test import cmd_unit_test
|
|
|
|
client = MagicMock()
|
|
client.run_unit_test.return_value = {
|
|
"summary": {},
|
|
"classes": [
|
|
{"name": None, "methods": [{"name": "test1"}]},
|
|
],
|
|
}
|
|
|
|
with patch("builtins.print") as mock_print:
|
|
cmd_unit_test(_args(name="ZCL_FOO"), client)
|
|
|
|
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
|
|
self.assertIn("ZCL_FOO", printed)
|
|
|
|
def test_summary_defaults_when_missing(self):
|
|
"""summary 缺字段时使用默认值(? / 0)。"""
|
|
from sapcli.commands.unit_test import cmd_unit_test
|
|
|
|
client = MagicMock()
|
|
client.run_unit_test.return_value = {
|
|
"summary": {},
|
|
"classes": [{"name": "ZCL", "methods": [{"name": "t1"}]}],
|
|
}
|
|
|
|
with patch("builtins.print") as mock_print:
|
|
cmd_unit_test(_args(), client)
|
|
|
|
printed = " ".join(str(c) for c, _ in mock_print.call_args_list)
|
|
# tests 默认 "?"
|
|
self.assertIn("?", printed)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main(verbosity=2)
|