Files
吴让宇 c5905a5b1e 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 重写为单源开发流程。
2026-09-11 00:40:15 +08:00

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)