eomsangdonandClaude Opus 5.5
cde4d7fab2
- common_util_derived_store — 열쇠 · 읽기 · 원자 쓰기 · 종류마다 최근 2벌 · 결과 옆 열쇠 · 파일 지문 - B04 전처리 · 도엽 3D 면이 도우미의 file_stamp · key_matches 를 씀 - 유토 배분 — 메모리 다음 _derived/haul/<열쇠>.json(같은 _plan_key) · 재시작 뒤 첫 열기도 셈 없음 · 저장소 못 찾아도 셈 - 시험 test_343_4_derived 11건 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014utrjfoW831Vc5wJUd13kL
79 lines
2.9 KiB
Python
79 lines
2.9 KiB
Python
"""파생 저장본 — 입력 지문 열쇠 + 결과 한 쌍(343 · 341 부록 4 2-1).
|
|
|
|
자리 = 프로젝트 `_derived/<종류>/<열쇠>.json` · 작업본에서 다시 셀 수 있는 값만(정본 아님) ·
|
|
통째로 지워도 다시 셈으로 돌아옴 · 종류마다 최근 `KEEP` 벌(꺼내면 최근으로).
|
|
결과 옆 열쇠(`<이름>.key.json` — 결과가 곧 산출물인 도엽 3D 면 등)는 `key_matches` · `file_stamp`.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import hashlib
|
|
import json
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
from common_util.common_util_json import atomic_write_json
|
|
|
|
DERIVED_DIR = "_derived"
|
|
KEEP = 2
|
|
|
|
|
|
def derived_key(*parts: Any) -> str:
|
|
"""입력 지문 — 작은 입력은 내용 그대로 · 파일은 `file_stamp` 를 넣는다."""
|
|
body = json.dumps(parts, sort_keys=True, ensure_ascii=False, default=str)
|
|
return hashlib.sha1(body.encode("utf-8")).hexdigest()
|
|
|
|
|
|
def file_stamp(path: Path | None) -> str | None:
|
|
"""파일 지문 = 수정시각 ns : 크기. 없으면 None."""
|
|
try:
|
|
stat = path.stat() if path is not None else None
|
|
except OSError:
|
|
return None
|
|
return f"{stat.st_mtime_ns}:{stat.st_size}" if stat else None
|
|
|
|
|
|
def key_matches(key_path: Path, key: Any) -> bool:
|
|
"""결과 옆 열쇠 파일이 지금 입력과 같은지."""
|
|
try:
|
|
return json.loads(key_path.read_text(encoding="utf-8")) == key
|
|
except (OSError, ValueError):
|
|
return False
|
|
|
|
|
|
def derived_dir(project_root: Path, kind: str) -> Path:
|
|
return Path(project_root) / DERIVED_DIR / kind
|
|
|
|
|
|
def read_derived(project_root: Path, kind: str, key: str) -> dict[str, Any] | None:
|
|
"""저장본 `{"value": …}` — 없거나 못 읽으면 None(값이 null 이어도 맞음과 구별)."""
|
|
path = derived_dir(project_root, kind) / f"{key}.json"
|
|
try:
|
|
data = json.loads(path.read_text(encoding="utf-8"))
|
|
except (OSError, ValueError):
|
|
return None
|
|
if not isinstance(data, dict) or data.get("key") != key or "value" not in data:
|
|
return None
|
|
try:
|
|
path.touch() # 최근에 쓴 것 = 정리 때 남김
|
|
except OSError:
|
|
pass
|
|
return data
|
|
|
|
|
|
def write_derived(project_root: Path, kind: str, key: str, value: Any, keep: int = KEEP) -> None:
|
|
"""원자 쓰기 뒤 같은 종류 옛 열쇠를 정리한다."""
|
|
atomic_write_json(derived_dir(project_root, kind) / f"{key}.json", {"key": key, "value": value})
|
|
prune_derived(project_root, kind, keep)
|
|
|
|
|
|
def prune_derived(project_root: Path, kind: str, keep: int = KEEP) -> int:
|
|
"""종류 하나를 최근 `keep` 벌만 남기고 지운다. 지운 수."""
|
|
folder = derived_dir(project_root, kind)
|
|
files = sorted(
|
|
((path.stat().st_mtime_ns, path) for path in folder.glob("*.json")), reverse=True
|
|
)
|
|
for _, path in files[keep:]:
|
|
path.unlink(missing_ok=True)
|
|
return max(0, len(files) - keep)
|