refactor(5-4): 여러 파일 쓰기 한 잠금 — Store.batch(다시 들어가는 잠금) · 나무 고침 · 합치기 · 되돌림

- Store._LOCK = RLock · Store.batch() = 판 대조부터 마지막 쓰기까지 한 잠금(안에서 Store.write 불러도 됨)
- Precombo_Folders.edit(지우기 Library_Delete.remove 포함) · Library_Same_Router.merge · undo(Library_Delete.undo 포함)를 batch 안에서
- merge 판 대조를 「없는 문서」 검사 앞으로 — 지우기와 겹쳐 진 합치기 = 409(옛 = 사라진 파일에서 터짐 · 화면 500)
- 늦은 쓰기(_refresh_labor 류) · write_template(5-3) · 권한(5-1) 그대로 · San_MatPick.write(sub8) 안 고침 · remove 되돌림 몸 이동은 5-8
- test_858_shelf_golden 동시 쓰기 셋 뒤집음: 앞 것만 됨 · 뒤 것 409 · 파일 앞판 그대로 — 겹침 꼴을 _race 로(앞 것을 쓰기 자리에서 붙잡음 · 잠금을 빼면 셋 다 실패) · 지문 50 갈래 그대로

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 20:46:11 +09:00
co-authored by Claude Opus 5.5
parent 2871796bde
commit 39e0a72931
5 changed files with 75 additions and 61 deletions
+2 -1
View File
@@ -178,7 +178,8 @@ def remove(
at = refs.folder_of(r["층"], r["주인"]) / r["문서종류"] / f"{r['문서']}.json"
files[at] = r
done: list[dict[str, Any]] = []
# ponytail: 여러 파일을 차례로 씀(잠금 없음) — 실패하면 앞서 고친 파일을 앞판 바이트로 되돌림
# ponytail: 부르는 곳(`Precombo_Folders.edit`)의 `store.batch` 안 — 실패하면 앞서 고친 파일을
# 앞판 바이트로 되돌림(되돌림 몸을 `batch` 로 옮기는 것은 5-8)
for path, r in files.items():
raw = path.read_bytes()
try:
+17 -6
View File
@@ -205,6 +205,12 @@ def find(folder: Path, kind: str) -> dict[str, Any]:
# ── 합치기 ────────────────────────────────────────────────────────────
def merge(session: Session, folder: Path, kind: str, body: MergeBody) -> dict[str, Any]:
"""판 대조부터 마지막 쓰기까지 `store.batch` — 같은 층 지우기 · 나무 고침과 겹치면 진 쪽 409."""
with store.batch():
return _merge(session, folder, kind, body)
def _merge(session: Session, folder: Path, kind: str, body: MergeBody) -> dict[str, Any]:
mine = refs.where(folder)
raw = body.남김 or {}
keep_at: refs.Here = (str(raw.get("층") or ""), raw.get("주인") or None)
@@ -216,13 +222,13 @@ def merge(session: Session, folder: Path, kind: str, body: MergeBody) -> dict[st
gone = list(dict.fromkeys(str(k) for k in body.지움))
if not gone or (keep_at == mine and keep["키"] in gone):
raise _bad(400, "지울 문서를 고름 — 남김과 달라야 함")
with store.at(folder):
tree_doc, 판 = pre_folders._read(kind)
if 판 != body.판: # 없는 문서 검사 앞 — 겹쳐 진 쪽(그새 지워짐)은 409
raise _bad(409, {"stale": [pre_folders.file_of(kind)], "판": 판})
have = dict(_docs(mine, kind))
if miss := [k for k in gone if k not in have]:
raise _bad(404, f"이 층에 없는 문서 「{' · '.join(miss)}」")
with store.at(folder):
tree_doc, 판 = pre_folders._read(kind)
if 판 != body.판:
raise _bad(409, {"stale": [pre_folders.file_of(kind)], "판": 판})
marks = same.Same()
mark = marks.finger(kind, keep_doc)
if mark is None or any(marks.finger(kind, have[k]) != mark for k in gone):
@@ -259,7 +265,6 @@ def merge(session: Session, folder: Path, kind: str, body: MergeBody) -> dict[st
places = dict(tree_doc.get("자리") or {})
done, kept = [], []
when = datetime.now().isoformat(timespec="seconds")
# ponytail: 여러 파일을 차례로 씀(잠금 없음) — 동시에 같은 층을 합치면 앞 것이 이김
for key in gone:
if left[key]:
kept.append({"키": key, "쓰는곳": left[key]})
@@ -284,7 +289,13 @@ def merge(session: Session, folder: Path, kind: str, body: MergeBody) -> dict[st
def undo(session: Session, folder: Path, kind: str, key: str) -> dict[str, Any]:
"""`_합친것/<키>` 되돌림 — 문서 · 나무 자리 · 옮긴 참조(아직 남김을 가리키고 쓸 수 있는 곳)."""
"""`_합친것/<키>` 되돌림 — 문서 · 나무 자리 · 옮긴 참조(아직 남김을 가리키고 쓸 수 있는 곳) ·
한 `store.batch`(지움 기록 되돌림 `M02_Library_Delete.undo` 도 이 안)."""
with store.batch():
return _undo(session, folder, kind, key)
def _undo(session: Session, folder: Path, kind: str, key: str) -> dict[str, Any]:
mine = refs.where(folder)
rec_path = folder / GONE / f"{key}.json"
try:
@@ -76,8 +76,14 @@ _BAD_NAME = re.compile(r'[\\/:*?"<>|\x00-\x1f]|\.\.')
# of undefined (reading 'length')") · CAD 쪽도 없으면 새로 채우지만(2026-09-27 sub1 고침)
# 뿌리도 처음부터 채움
_BLANK_LAYER = {"id": "기본", "name": "기본", "isVisible": True, "isLocked": False}
# ponytail: 저장은 한 번에 하나(프로세스 안 잠금) · 서버를 여럿 띄우면 파일 잠금으로
_LOCK = threading.Lock()
# ponytail: 저장은 한 번에 하나(프로세스 안 잠금 · 다시 들어감) · 서버를 여럿 띄우면 파일 잠금으로
_LOCK = threading.RLock()
def batch() -> threading.RLock:
"""여러 파일 쓰기 한 묶음(858 5-4) — 판 대조부터 마지막 쓰기까지 한 잠금 · 안에서 `write` ·
`delete` 를 불러도 됨(다시 들어가는 잠금) · 겹친 쪽은 잠금 뒤 판 대조에서 409."""
return _LOCK
class StoreError(Exception):
+7 -1
View File
@@ -181,7 +181,13 @@ def edit(
body: dict[str, Any], kind: str = "precombo", session: dict[str, Any] | None = None
) -> dict[str, Any]:
"""지금 층 자리 파일을 고쳐 씀(지우기면 문서 파일째 · 쓰는 곳 = `deleting.remove` · 몸 `확인`) →
새 나무 + 알림(지우기 = `기록` 되돌림 키) · 판 다르면 409."""
새 나무 + 알림(지우기 = `기록` 되돌림 키) · 판 다르면 409 · 판 대조부터 쓰기까지
`store.batch`."""
with store.batch():
return _edit(body, kind, session)
def _edit(body: dict[str, Any], kind: str, session: dict[str, Any] | None) -> dict[str, Any]:
doc, 판 = _read(kind)
if 판 != str(body.get("판") or ""):
raise store.StoreError(409, {"stale": [file_of(kind)], "판": 판})
+41 -51
View File
@@ -7,9 +7,8 @@
다르면 갈래 이름 + 지금 답 + 다시 뜨는 법으로 실패(건너뛰지 않음). 다시 뜸 =
`SHELF_858_WRITE=1 ./venv/Scripts/python.exe -m pytest resources/tester/test_858_shelf_golden.py`
(뜻한 바뀜일 때만 · 커밋 글에 까닭). 답 통째 전후 대조 = `SHELF_858_DUMP=tmp/<파일>.json`.
② 동시 쓰기 — 잠금 없는 나무 고침 · 나무 지우기 · 합치기를 같은 판으로 겹쳐 부름. 지금 사실을
그대로 단언(나무 = 둘 다 됨 · 뒤 것이 이김 · 지우기 + 합치기 = 앞 것이 이기고 뒤 것은 터짐) —
「5-4 에서 뒤집을 단언」 표시 줄은 5-4 가 바꿈.
② 동시 쓰기 — 나무 고침 · 나무 지우기 · 합치기를 같은 판으로 겹쳐 부름. 한 잠금(`store.batch` ·
5-4) 안에서 판 대조 → 앞 것만 이기고 뒤 것은 409 · 파일은 앞 것이 쓴 그대로(반쯤 써짐 없음).
"""
from __future__ import annotations
@@ -354,45 +353,36 @@ def test_서고_길_답_지문(shelf, world):
)
# ── ② 동시 쓰기 — 잠금 없는 여러 파일 쓰기(설계 858 1-4 「잠금 없는 쓰기」 · 5-4 몫) ─────────
def _two(first, second, meet: list[tuple[Any, str]], late: tuple[Any, str]):
"""둘을 같이 돌림 — 둘 다 판 대조를 지난 뒤 `meet` 함수 앞에서 만나고, 그 뒤 `second` 쪽
`late` 함수를 늦춤 → (먼저 답 · 나중 답 — 예외면 예외)."""
gate = threading.Barrier(2, timeout=10)
slow = threading.local()
saved = [(late[0], late[1], getattr(*late))] + [(o, n, None) for o, n in meet]
# ── ② 동시 쓰기 — 여러 파일 쓰기 한 잠금(설계 858 1-4 「잠금 없는 쓰기」 · 5-4) ─────────
def _race(win, lose, inside: tuple[Any, str]):
"""`win` 을 먼저 돌려 `inside`(판 대조 뒤 · 쓰기 앞) 안에서 붙잡아 둔 사이 `lose` 를 돌림 →
(win 답 · lose 답 — 예외면 예외). 잠금이 없으면 `lose` 도 옛 판으로 대조를 지나 둘 다 됨."""
entered = threading.Event()
held = threading.local()
real = getattr(*inside)
def later(*a, _real=saved[0][2], **k):
if getattr(slow, "on", False):
def hold(*a, **k):
if getattr(held, "on", False):
entered.set()
threading.Event().wait(0.3)
return _real(*a, **k)
return real(*a, **k)
setattr(*late, later) # 안쪽 = 늦춤 · 바깥 = 만남(같은 함수면 만난 뒤 늦춤)
for i, (owner, name, _) in enumerate(saved[1:], 1):
inner = getattr(owner, name)
saved[i] = (owner, name, inner)
def wait(*a, _inner=inner, **k):
gate.wait()
return _inner(*a, **k)
setattr(owner, name, wait)
def run(fn, is_late):
slow.on = is_late
def run(fn, is_win):
held.on = is_win
try:
return fn()
except Exception as error: # 지금 사실(터짐)도 답으로
except Exception as error: # 진 쪽 409 도 답으로
return error
setattr(*inside, hold)
try:
with ThreadPoolExecutor(2) as pool:
a = pool.submit(run, first, False)
b = pool.submit(run, second, True)
a = pool.submit(run, win, True)
assert entered.wait(10), "앞 것이 쓰기 자리에 못 닿음"
b = pool.submit(run, lose, False)
return a.result(), b.result()
finally:
for owner, name, real in reversed(saved):
setattr(owner, name, real)
setattr(*inside, real)
def _sk(me: Path, name: str, price: int, again: bool = False) -> str:
@@ -415,37 +405,40 @@ def _folders(me: Path) -> list[list[str]]:
return pre_folders.view("sangeun")["폴더"]
def test_동시_나무_고침_둘_다_됨_뒤_것이_이김(world):
def _lost(answer) -> bool:
return isinstance(answer, store.StoreError) and answer.status == 409
def test_동시_나무_고침_앞_것만_됨_뒤_것은_409(world):
me = world["personal"]
with store.at(me):
판 = pre_folders.view("sangeun")["판"]
first, second = _two(
first, second = _race(
_edit(me, {"op": "add-folder", "경로": [], "이름": "가", "판": 판}),
_edit(me, {"op": "add-folder", "경로": [], "이름": "나", "판": 판}),
[(pre_folders, "apply_many")],
(pre_folders, "atomic_write_json"),
(pre_folders, "apply_many"),
)
assert first["알림"]["경로"] == ["가"] and second["알림"]["경로"] == ["나"] # 둘 다 됨
assert _folders(me) == [["나"]] # 5-4 에서 뒤집을 단언 — 지금은 뒤 것이 이김(앞 「가」 사라짐)
assert first["알림"]["경로"] == ["가"] and _lost(second)
assert _folders(me) == [["가"]] # 앞 것만 — 뒤 「나」 는 판이 달라 안 씀
def test_동시_나무_지우기와_고침_둘_다_됨_뒤_것이_이김(world):
def test_동시_나무_고침과_지우기_앞_것만_됨_뒤_지우기는_409(world):
me = world["personal"]
gone = _sk(me, "지울것", 1000)
with store.at(me):
판 = pre_folders.view("sangeun")["판"]
first, second = _two(
first, second = _race(
_edit(me, {"op": "add-folder", "경로": [], "이름": "가", "판": 판}),
_edit(me, {"op": "delete", "대상": [{"키": gone}], "판": 판}),
[(pre_folders, "apply_many")],
(pre_folders, "atomic_write_json"),
(pre_folders, "apply_many"),
)
assert first["알림"]["경로"] == ["가"] and second["알림"]["기록"] # 둘 다 됨
assert not (me / "sangeun" / f"{gone}.json").exists()
assert _folders(me) == [] # 5-4 에서 뒤집을 단언 — 지금은 뒤 것(지우기)이 이김(「가」 사라짐)
assert first["알림"]["경로"] == ["가"] and _lost(second)
assert (me / "sangeun" / f"{gone}.json").is_file() # 지우기 = 안 됨 · 문서 그대로
assert _folders(me) == [["가"]]
assert not (me / same_router.GONE).exists() or not list((me / same_router.GONE).glob("*.json"))
def test_동시_지우기와_합치기_앞_것이_이기고_뒤_것은_터짐(world):
def test_동시_지우기와_합치기_앞_것만_됨_뒤_합치기는_409(world):
me = world["personal"]
gone = _sk(me, "겹침", 1000)
keep = _sk(me, "겹침", 1000, again=True)
@@ -454,16 +447,13 @@ def test_동시_지우기와_합치기_앞_것이_이기고_뒤_것은_터짐(wo
body = same_router.MergeBody(
남김={"층": "personal", "주인": "7/42", "키": keep}, 지움=[gone], 판=판
)
first, second = _two(
first, second = _race(
_edit(me, {"op": "delete", "대상": [{"키": gone}], "판": 판}),
lambda: same_router.merge(dict(USER), me, "sangeun", body),
[(pre_folders, "apply_many"), (same_router, "_user_index")],
(same_router, "_user_index"),
(pre_folders, "apply_many"),
)
assert first["알림"]["기록"] == gone # 지우기 = 됨(기록 키 = 그 문서)
# 5-4 에서 뒤집을 단언 — 지금은 뒤 합치기가 판 · 지문 대조를 지난 뒤 사라진 파일에서 터짐
# (화면 = 500) · 5-4 뒤 = 409 · 파일 앞판 그대로
assert isinstance(second, FileNotFoundError)
assert _lost(second) # 뒤 합치기 = 판이 달라 409(옛 = 사라진 파일에서 터짐 · 화면 500)
assert not (me / "sangeun" / f"{gone}.json").exists()
assert (me / "sangeun" / f"{keep}.json").is_file()
assert [p.stem for p in (me / same_router.GONE).glob("*.json")] == [gone] # 지우기 기록만