From 39e0a72931e8145effcff216fa2a59aec2c14a0c Mon Sep 17 00:00:00 2001 From: umsangdon Date: Tue, 17 Nov 2026 20:46:11 +0900 Subject: [PATCH] =?UTF-8?q?refactor(5-4):=20=EC=97=AC=EB=9F=AC=20=ED=8C=8C?= =?UTF-8?q?=EC=9D=BC=20=EC=93=B0=EA=B8=B0=20=ED=95=9C=20=EC=9E=A0=EA=B8=88?= =?UTF-8?q?=20=E2=80=94=20Store.batch(=EB=8B=A4=EC=8B=9C=20=EB=93=A4?= =?UTF-8?q?=EC=96=B4=EA=B0=80=EB=8A=94=20=EC=9E=A0=EA=B8=88)=20=C2=B7=20?= =?UTF-8?q?=EB=82=98=EB=AC=B4=20=EA=B3=A0=EC=B9=A8=20=C2=B7=20=ED=95=A9?= =?UTF-8?q?=EC=B9=98=EA=B8=B0=20=C2=B7=20=EB=90=98=EB=8F=8C=EB=A6=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- M02_MasterTemplete/M02_Library_Delete.py | 3 +- M02_MasterTemplete/M02_Library_Same_Router.py | 23 +++-- .../M02_MasterTemplete_Store.py | 10 +- M02_MasterTemplete/M02_Precombo_Folders.py | 8 +- resources/tester/test_858_shelf_golden.py | 92 +++++++++---------- 5 files changed, 75 insertions(+), 61 deletions(-) diff --git a/M02_MasterTemplete/M02_Library_Delete.py b/M02_MasterTemplete/M02_Library_Delete.py index 4e8a678b3..47c2f7ccf 100644 --- a/M02_MasterTemplete/M02_Library_Delete.py +++ b/M02_MasterTemplete/M02_Library_Delete.py @@ -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: diff --git a/M02_MasterTemplete/M02_Library_Same_Router.py b/M02_MasterTemplete/M02_Library_Same_Router.py index 362261e12..36dafde1f 100644 --- a/M02_MasterTemplete/M02_Library_Same_Router.py +++ b/M02_MasterTemplete/M02_Library_Same_Router.py @@ -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: diff --git a/M02_MasterTemplete/M02_MasterTemplete_Store.py b/M02_MasterTemplete/M02_MasterTemplete_Store.py index aa1f42a59..e80ba2f86 100644 --- a/M02_MasterTemplete/M02_MasterTemplete_Store.py +++ b/M02_MasterTemplete/M02_MasterTemplete_Store.py @@ -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): diff --git a/M02_MasterTemplete/M02_Precombo_Folders.py b/M02_MasterTemplete/M02_Precombo_Folders.py index b7bb98c53..92ec85a11 100644 --- a/M02_MasterTemplete/M02_Precombo_Folders.py +++ b/M02_MasterTemplete/M02_Precombo_Folders.py @@ -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)], "판": 판}) diff --git a/resources/tester/test_858_shelf_golden.py b/resources/tester/test_858_shelf_golden.py index 64f489d2c..d1ff49a0e 100644 --- a/resources/tester/test_858_shelf_golden.py +++ b/resources/tester/test_858_shelf_golden.py @@ -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] # 지우기 기록만