Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
# SPDX-License-Identifier: Apache-2.0
"""`sprite-gen migrate-breathe` — 폐기 사이드카를 옮기는 유일한 경로.
모듈 docstring 이 "무엇을 버렸는지 전부 출력한다" 를 계약으로 걸었으므로, 폐기 키가
하나라도 보고에서 빠지면 그 계약이 깨진다 (validator note 2026-07-25: `hold` 가 목록에
없어 조용히 사라졌다).
"""
import json
import sys
from pathlib import Path
import pytest
ROOT = Path(__file__).resolve().parent.parent.parent
sys.path.insert(0, str(ROOT))
from sprite_gen.curate.curation import RETIRED_BREATHE_KEYS, state_breathe # noqa: E402
from sprite_gen.spec.migrate_breathe import migrate_entry, run # noqa: E402
def _sidecar(tmp_path, breathe):
data = {"version": 1, "kind": "sprite-gen-curation",
"states": {"idle": {"selected": [0, 1], "breathe": breathe}, "jump": {"selected": [0]}}}
(tmp_path / "curation.json").write_text(json.dumps(data), encoding="utf-8")
return tmp_path / "curation.json"
ALL_RETIRED = {"splits": [0.32, 0.55], "amplitude": 2, "subpixel": True, "hold": 3}
def test_breaths_survives_and_the_rest_is_reset():
# 반공허: 폐기 키가 늘었는데 ALL_RETIRED 가 그대로면 아래 보고 단정이 그 키를 못 본다.
assert set(RETIRED_BREATHE_KEYS) <= set(ALL_RETIRED), \
f"ALL_RETIRED 에 없는 폐기 키: {sorted(set(RETIRED_BREATHE_KEYS) - set(ALL_RETIRED))}"
fresh, dropped = migrate_entry({**ALL_RETIRED, "breaths": 5})
assert fresh["breaths"] == 5, "사람이 고른 호흡 횟수는 보존한다"
assert set(fresh) == {"depth", "lag", "breaths"}
assert not any(k in fresh for k in RETIRED_BREATHE_KEYS)
# 버린 것을 전부 출력한다 — 목록에서 빠진 키는 조용히 사라진다.
for key in sorted(RETIRED_BREATHE_KEYS):
assert any(line.startswith(f"{key}=") for line in dropped), \
f"{key} 를 버렸다는 보고가 없다: {dropped}"
def test_dry_run_does_not_touch_the_file(tmp_path, capsys):
path = _sidecar(tmp_path, dict(ALL_RETIRED, breaths=3))
before = path.read_text(encoding="utf-8")
assert run(run_dir=tmp_path) == 0
assert path.read_text(encoding="utf-8") == before, "dry-run 이 파일을 건드렸다"
assert "dry-run" in capsys.readouterr().out
def test_apply_makes_the_sidecar_bakeable(tmp_path):
path = _sidecar(tmp_path, dict(ALL_RETIRED, breaths=3))
with pytest.raises(SystemExit): # 옮기기 전에는 loud reject
state_breathe(json.loads(path.read_text(encoding="utf-8")), "idle")
assert run(run_dir=tmp_path, apply=True) == 0
data = json.loads(path.read_text(encoding="utf-8"))
cfg = state_breathe(data, "idle") # 이제 통과한다
assert cfg["breaths"] == 3 and cfg["rigid_row"] is None
assert data["states"]["jump"] == {"selected": [0]}, "관계없는 상태를 건드렸다"
def test_running_twice_is_idempotent(tmp_path, capsys):
path = _sidecar(tmp_path, dict(ALL_RETIRED, breaths=2))
run(run_dir=tmp_path, apply=True)
once = path.read_text(encoding="utf-8")
capsys.readouterr()
assert run(run_dir=tmp_path, apply=True) == 0
assert path.read_text(encoding="utf-8") == once
assert "옮길 분할선 설정이 없다" in capsys.readouterr().out
def test_a_missing_sidecar_fails_loudly(tmp_path, capsys):
assert run(run_dir=tmp_path) == 1
assert "없다" in capsys.readouterr().out
def test_a_non_integer_breaths_is_reported_not_truncated() -> None:
"""비정수 `breaths` 는 조용히 깎지 않고 **버렸다고 말한다**.
`int(2.7)` 은 조용히 2 다 — 사용자가 적은 값과 다른 값이 산출물에 들어가고 `dropped`
엔 한 줄도 안 남는다. `"3.5"` 문자열만 `ValueError` 로 걸려 보고됐고 실수만 샜다
(validator note 2026-07-26). 굽기(`curation._exact_int`)와 큐레이터 미러가 이미 거부하는
값이라 이 **세 번째 구현**만 규칙을 안 지키고 있었고, 이 모듈 자신의 계약이
"무엇을 버렸는지 전부 출력한다" 다."""
from sprite_gen.spec.migrate_breathe import migrate_entry
# `nan`/`inf` 도 담는다: `json.loads` 는 기본값으로 `NaN` 리터럴을 받으므로 사이드카에서
# 실제로 들어오고, `int(nan)` 은 `ValueError` 를 올려 마이그레이션을 **트레이스백으로
# 죽인다**. 값 목록에 없어서 그 회귀를 그물이 못 봤다 (노을이 실측 2026-07-26 R2).
# "셋" 은 `float()` 자체가 실패하는 `except` 분기를 밟는 유일한 값이다.
for value in (2.7, "3.5", "셋", 1.5, 0.5, float("nan"), float("inf"), float("-inf")):
fresh, dropped = migrate_entry({"splits": [10], "breaths": value})
said = [d for d in dropped if d.startswith("breaths=")]
assert said, f"breaths={value!r} 를 조용히 {fresh['breaths']} 로 바꿨다 — 버린 걸 안 말한다"
assert "정수" in said[0], f"breaths={value!r}: 정수 계약이 아닌 사유로 버렸다 ({said[0]})"
assert fresh["breaths"] == 1, f"breaths={value!r} 가 1 로 되돌아가지 않았다 ({fresh['breaths']})"
# 정수로 표현되는 실수·정수는 그대로 통과한다 (과잉 거부 금지)
for value in (3, 3.0):
fresh, dropped = migrate_entry({"splits": [10], "breaths": value})
assert fresh["breaths"] == 3, f"{value!r} 가 3 으로 안 들어갔다"
assert not [d for d in dropped if d.startswith("breaths=")], \
f"{value!r} 는 멀쩡한 값인데 버렸다고 보고한다"