남의 설정을 안 지우고 내 규칙만 갈아끼우기
에이전트 규칙을 여러 대상에 배포할 때, 파일 전체를 덮으면 개인 설정이 죽는다. 마커 사이만 바꾸면 된다.
멱등 재실행 재작성 0건 · 테스트 6/6
에이전트 규칙을 한 곳에서 관리하고 여러 대상에 뿌리려는 순간 문제가 생긴다. 대상 파일에는 이미 그 자리의 개인 설정이 들어 있다. 배포한다고 파일을 통째로 덮으면 그게 날아간다.
해법은 오래된 것이다. 파일 전체를 소유하지 말고, 마커 사이만 소유한다.
# 내가 직접 쓴 규칙 — 배포가 안 건드림
<!-- managed:core-rules:begin -->
... 여기만 교체된다 ...
<!-- managed:core-rules:end -->
# 이것도 안 건드림
세 가지만 지키면 된다
첫째, 멱등. 두 번 돌려도 같아야 한다. 소스와 블록 내용이 같으면 파일을 아예 안 쓴다. “이미 최신”이라고만 말한다. 이게 없으면 배포 스크립트를 돌릴 때마다 파일 mtime이 바뀌고, git이 매번 변경으로 잡고, 결국 사람이 스크립트를 안 돌리게 된다.
둘째, 마커가 깨졌으면 멈춘다. begin이 두 개거나, end가 없거나, end가 begin보다 앞에 있으면 — 추측해서 고치지 않는다. 종료 코드를 따로 주고 사람에게 넘긴다.
여기서 추측하면 최악이다. begin이 두 개일 때 “첫 번째부터 마지막 end까지”로 잡으면 그 사이의 개인 설정을 통째로 먹는다. 정확히 이 도구가 막으려던 사고다.
if len(begins) != 1 or len(ends) != 1:
print(f"ABORT: malformed markers — "
f"begin={len(begins)}, end={len(ends)}. Fix manually.",
file=sys.stderr)
sys.exit(2)
셋째, 제거도 같은 규칙으로. 블록을 걷어낼 때 파일을 지우지 않는다. 블록만 빼고 나머지는 그대로 둔다.
실제로 겪은 것
윈도우에서 한 번 넘어졌다. 출력 문자열에 em dash(—)를 썼는데 콘솔 코드페이지가
CP949라 이렇게 터졌다.
UnicodeEncodeError: 'cp949' codec can't encode character
'—' in position 158: illegal multibyte sequence
파일 입출력은 전부 encoding="utf-8"로 명시해뒀는데, stdout은 빠뜨렸다.
파일만 챙기고 콘솔을 안 챙긴 것이다.
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
sys.stderr.reconfigure(encoding="utf-8", errors="replace")
웃긴 건 이게 “성공했습니다” 메시지를 찍다가 죽었다는 점이다. 실제 배포는 이미 끝난 뒤였다. 성공 경로가 실패 경로보다 늦게 발견되는 종류의 버그다.
검증
시나리오 여섯 개로 확인했다.
| 시나리오 | 기대 | 결과 |
|---|---|---|
| 블록 없는 파일에 신규 삽입 | 끝에 추가, 기존 내용 보존 | PASS |
| 같은 소스로 재실행 | 파일 미변경 | PASS |
| 소스 변경 후 배포 | 블록만 교체 | PASS |
| 드리프트 검사 | 다르면 exit 1 | PASS |
| 제거 | 블록만 삭제, 나머지 보존 | PASS |
| begin 2개 · end 1개 | exit 2, 파일 미변경 | PASS |
마지막 줄이 제일 중요하다. 실패해야 할 때 제대로 실패하는지를 안 재보면, 나머지 다섯 개가 통과해도 이 도구는 신뢰할 수 없다.
안 한 것
블록을 여러 개 두는 건 지원하되, 블록끼리 겹치는 경우는 검사하지 않는다.
managed:a:begin 안에 managed:b:begin을 넣는 상황은 만들 이유가 없어서
막지도 허용하지도 않고 그냥 놔뒀다. 필요해지면 그때 붙인다.