Peach: Local-first video metadata scraper and media manager.
from __future__ import annotations
import importlib.util
import json
import subprocess
import sys
import tempfile
import unittest
from datetime import datetime, timedelta, timezone
from pathlib import Path
SCRIPT = Path(__file__).resolve().parents[1] / "scripts" / "job_status.py"
SPEC = importlib.util.spec_from_file_location("peach_job_status", SCRIPT)
assert SPEC and SPEC.loader
MODULE = importlib.util.module_from_spec(SPEC)
SPEC.loader.exec_module(MODULE)
class JobStatusTests(unittest.TestCase):
def test_hooks_name_an_explicit_interpreter(self) -> None:
"""hook 不许用裸 `python`。
这台机器上裸 `python` 曾解析到 Microsoft Store 的 MSIX 别名:路径存在、
执行报 FileNotFoundError,而 hook 的失败没人盯着看。写成项目内的
`.venv` 解释器,缺了就是缺了,不会解析到另一个 Python。
`uv` 是唯一另一个允许出现的命令。它不是 `python`,顶不到那个别名上;而它那
一条的整条命令由 `tests/test_release_due.py` 原样执行一遍,PATH 上没有它就是
测试红,不是 hook 静默。走 `uv` 是因为那条 hook 要在 Windows 和 macOS 上都
跑,而 hook 配置不支持按平台分支。"""
settings = json.loads(
(SCRIPT.parents[1] / ".claude" / "settings.json").read_text(encoding="utf-8")
)
commands = {
hook["command"]
for event in settings["hooks"].values()
for matcher in event
for hook in matcher["hooks"]
}
self.assertEqual(commands,
{"${CLAUDE_PROJECT_DIR}/.venv/Scripts/python.exe", "uv"})
# 每条都带 `-X utf8`:这几个脚本打的都是中文,而 Windows 上解释器的输出端
# 默认落在 gbk,读的一端按 UTF-8 解,屏幕上就只剩命令名和数字认得出来。
for event in settings["hooks"].values():
for matcher in event:
for hook in matcher["hooks"]:
args = hook.get("args", [])
self.assertIn("-X", args, hook)
self.assertEqual(args[args.index("-X") + 1], "utf8", hook)
result = subprocess.run(
[sys.executable, str(SCRIPT), "--help"],
cwd=SCRIPT.parents[1],
capture_output=True,
text=True,
encoding="utf-8",
errors="replace",
check=False,
)
self.assertEqual(result.returncode, 0, result.stderr)
def test_hook_event_is_sanitized_and_atomic(self) -> None:
with tempfile.TemporaryDirectory() as root:
state = Path(root) / "state" / "handoff.json"
MODULE.record_hook_event(state, {
"hook_event_name": "StopFailure",
"transcript_path": "secret transcript",
"access_token": "never persist me",
})
saved = json.loads(state.read_text(encoding="utf-8"))
self.assertEqual(saved["agent"], "claude")
self.assertEqual(saved["event"], "StopFailure")
self.assertEqual(saved["outcome"], "failed")
self.assertNotIn("access_token", saved)
self.assertNotIn("transcript_path", saved)
self.assertFalse(list(state.parent.glob("*.tmp")))
def test_rendered_times_are_local_while_stored_times_stay_utc(self) -> None:
"""时间按本地时区渲染,存进 state 的仍是 UTC。"""
moment = datetime.fromisoformat(MODULE._local("2026-08-29T02:51:51+00:00"))
self.assertEqual(
moment, datetime(2026, 8, 29, 2, 51, 51, tzinfo=timezone.utc),
"换算只能改变显示的时区,不能改变它指的时刻",
)
self.assertEqual(
moment.utcoffset(), datetime.now().astimezone().utcoffset(),
"渲染出的时间要带本机时区偏移",
)
self.assertEqual(MODULE._local("说不清"), "说不清", "解析不了就原样显示")
with tempfile.TemporaryDirectory() as root:
state = Path(root) / "state" / "handoff.json"
MODULE.record_hook_event(state, {"hook_event_name": "Stop"})
stored = json.loads(state.read_text(encoding="utf-8"))["at"]
self.assertEqual(
datetime.fromisoformat(stored).utcoffset(),
timedelta(0),
"存储一律 UTC,这一半不能跟着显示口径走",
)
def test_the_generated_block_lands_outside_the_repository(self) -> None:
"""自动区块使用配置中的 Peach 数据目录,保存在仓库外。"""
from peach.config import STATE_DIR
self.assertEqual(MODULE.DOC, STATE_DIR / "job-status.md")
self.assertEqual(MODULE.STATE, STATE_DIR / "agent-handoff.json")
repo = SCRIPT.parents[1]
self.assertNotIn(repo, MODULE.DOC.parents, "自动产物不能落在仓库里")
def test_write_back_creates_the_document_when_it_is_missing(self) -> None:
with tempfile.TemporaryDirectory() as root:
doc = Path(root) / "state" / "job-status.md"
self.assertEqual(MODULE.write_back(doc, [MODULE.START, "fresh", MODULE.END]),
"新建了区块")
self.assertEqual(MODULE.write_back(doc, [MODULE.START, "again", MODULE.END]),
"替换了已有区块")
text = doc.read_text(encoding="utf-8")
self.assertTrue(text.startswith("# 批处理进度(自动生成)"), text[:40])
self.assertIn("again", text)
self.assertNotIn("fresh", text)
def test_write_back_replaces_only_managed_block(self) -> None:
with tempfile.TemporaryDirectory() as root:
tmp_path = Path(root)
doc = tmp_path / "STATUS.md"
doc.write_text("before\n\n<!-- job-status:start -->\nold\n<!-- job-status:end -->\n\nafter\n", encoding="utf-8")
block = [MODULE.START, "fresh", MODULE.END]
self.assertEqual(MODULE.write_back(doc, block), "替换了已有区块")
self.assertEqual(doc.read_text(encoding="utf-8"), "before\n\n<!-- job-status:start -->\nfresh\n<!-- job-status:end -->\n\nafter\n")
self.assertFalse(list(tmp_path.glob("*.tmp")))