"""ws_init 技能展开 + IN-06 快单元(PACK-03:D-01/D-02/D-03 + IN-06 + 空目录边缘)。
A3 探针实证(2026-11-17,首位用例同款):Windows 原生 Python 的
pathlib.Path.home() 经 ntpath.expanduser 读 USERPROFILE 环境变量优先——
子进程 [sys.executable, -c, "print(Path.home())"] 配 USERPROFILE/HOME 重定向
即改变 home 解析(本机实测输出 == 假 home 路径),无需 monkeypatch
pathlib.Path.home 的备选路线(RESEARCH G-7 备选未启用)。
G-7 防污染:所有用例经 mock.patch.dict(os.environ, USERPROFILE/HOME → fake_home)
重定向用户主目录,真实 ~/.agents/skills/ 零触碰(防写入靠设计保证,非维护者
机器预置四技能副本触发 D-03 跳过的机器状态)。tearDown 调 wsroot.reset_cache()
(坑位 5/8 还原纪律)。
用法:python -m unittest tests.test_ws_init -v
"""
import contextlib
import io
import os
import subprocess
import sys
import tempfile
import unittest
from pathlib import Path
from unittest import mock
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT))
sys.path.insert(0, str(ROOT / "ohos_devloop" / "scripts"))
sys.path.insert(0, str(ROOT / "ohos_devloop"))
import ws_init
import wsroot
SKILLS = ("collab-delegate", "loop-iterate", "openharmony-ci", "pool-status")
class WsInitTest(unittest.TestCase):
def setUp(self):
self._tmp = tempfile.TemporaryDirectory(prefix="ws-init-")
self.tmp = Path(self._tmp.name).resolve()
self.fake_home = self.tmp / "fake-home"
self.fake_home.mkdir()
self._env = mock.patch.dict(
os.environ, {"USERPROFILE": str(self.fake_home), "HOME": str(self.fake_home)})
self._env.start()
wsroot.reset_cache()
def tearDown(self):
wsroot.reset_cache()
self._env.stop()
self._tmp.cleanup()
def _run_main(self, *argv: str) -> tuple[int, str, str]:
"""直调 ws_init.main()(test_rebrand 先例),捕获 rc/stdout/stderr。"""
stdout, stderr = io.StringIO(), io.StringIO()
with mock.patch.object(sys, "argv", ["ws_init.py", *argv]), \
mock.patch.object(ws_init, "tool_version", return_value="0.1.0"), \
contextlib.redirect_stdout(stdout), contextlib.redirect_stderr(stderr):
rc = ws_init.main()
return rc, stdout.getvalue(), stderr.getvalue()
def _assert_tree_equal(self, src: Path, dst: Path) -> None:
"""逐字节基准比较(test_upgrade_safety read_bytes 模式):文件清单与内容全等。"""
src_files = sorted(p.relative_to(src) for p in src.rglob("*") if p.is_file())
dst_files = sorted(p.relative_to(dst) for p in dst.rglob("*") if p.is_file())
self.assertEqual(src_files, dst_files, f"展开文件清单不一致: {src} -> {dst}")
for rel in src_files:
with self.subTest(file=str(rel)):
self.assertEqual((src / rel).read_bytes(), (dst / rel).read_bytes(),
f"展开副本与包内资产逐字节不等: {rel}")
def test_a3_probe_userprofile_redirects_path_home(self):
"""A3 探针(首位):USERPROFILE/HOME 重定向改变子进程 Path.home()(G-7 的地基)。"""
p = subprocess.run(
[sys.executable, "-c", "import pathlib; print(pathlib.Path.home())"],
env={**os.environ, "USERPROFILE": str(self.fake_home), "HOME": str(self.fake_home)},
capture_output=True, text=True, timeout=60)
self.assertEqual(p.returncode, 0, p.stderr)
self.assertTrue(p.stdout.strip().lower().startswith(str(self.fake_home).lower()),
f"Path.home() 未随 USERPROFILE 重定向: {p.stdout!r}"
f"(期望前缀 {str(self.fake_home)!r}——不成立须改走 monkeypatch 备选,RESEARCH G-7)")
def test_default_expansion_copies_all_skills_byte_exact(self):
"""D-01/D-02:init 默认把包内四技能逐字复制到 ~/.agents/skills/(含 openharmony-ci/agents 子树)。"""
ws = self.tmp / "ws"
rc, out, err = self._run_main(str(ws))
self.assertEqual(rc, 0, err)
src_root = ws_init.PKG / "agents" / "skills"
dst_root = self.fake_home / ".agents" / "skills"
for name in SKILLS:
with self.subTest(skill=name):
self.assertTrue((dst_root / name).is_dir(),
f"技能未展开: {dst_root / name}\nstdout={out}\nstderr={err}")
self._assert_tree_equal(src_root / name, dst_root / name)
self.assertTrue((dst_root / "openharmony-ci" / "agents" / "openai.yaml").is_file())
def test_no_skills_flag_skips_expansion_with_note(self):
"""D-02:--no-skills 跳过展开并打印一行说明。"""
ws = self.tmp / "ws"
rc, out, err = self._run_main(str(ws), "--no-skills")
self.assertEqual(rc, 0, err)
for name in SKILLS:
self.assertFalse((self.fake_home / ".agents" / "skills" / name).exists(),
f"--no-skills 下仍出现技能目录: {name}")
self.assertIn("no-skills", out)
def test_existing_skill_dirs_kept_even_with_force(self):
"""D-03:目标侧同名技能目录已存在 → 跳过(--force 重跑仍不覆盖),用户改动原样保留。"""
kept_skill = self.fake_home / ".agents" / "skills" / "collab-delegate"
kept_skill.mkdir(parents=True)
marker_file = kept_skill / "SKILL.md"
marker_file.write_text("# 用户已改副本(D-03 主权)\n", encoding="utf-8")
ws = self.tmp / "ws"
rc, out, err = self._run_main(str(ws))
self.assertEqual(rc, 0, err)
self.assertIn("保留已有 .agents/skills/collab-delegate", out)
self.assertEqual(marker_file.read_text(encoding="utf-8"), "# 用户已改副本(D-03 主权)\n")
for name in SKILLS[1:]:
self.assertTrue((self.fake_home / ".agents" / "skills" / name).is_dir(),
f"未预置技能未展开: {name}")
rc, out, err = self._run_main(str(ws), "--force")
self.assertEqual(rc, 0, err)
self.assertIn("保留已有 .agents/skills/collab-delegate", out)
self.assertEqual(marker_file.read_text(encoding="utf-8"), "# 用户已改副本(D-03 主权)\n")
def test_init_target_existing_file_errors_rc2(self):
"""IN-06:init 目标是已存在文件 → stderr 报错 rc==2(不再裸 traceback NotADirectoryError)。"""
target = self.tmp / "afile"
target.write_text("不是目录\n", encoding="utf-8")
rc, out, err = self._run_main(str(target))
self.assertEqual(rc, 2, f"rc={rc} stdout={out} stderr={err}")
self.assertIn("init 需要目录目标", err)
self.assertIn(str(target), err)
self.assertNotIn("Traceback", err)
def test_init_target_existing_empty_dir_ok(self):
"""空目录不算非空(SMOKE-01 边缘):目标为已存在空目录 → 正常生成 marker/config。"""
ws = self.tmp / "empty-ws"
ws.mkdir()
rc, out, err = self._run_main(str(ws))
self.assertEqual(rc, 0, err)
self.assertTrue((ws / wsroot.MARKER).is_file())
self.assertTrue((ws / "config" / "inventory.yaml").is_file())
if __name__ == "__main__":
unittest.main()