Pydantic 정수 Enum JSON 키: 문자열 왕복과 상태 의미 보존
메모리 안의 키 타입과 JSON wire 키는 다르므로 명시적인 양방향 코드 대응표가 필요하다.
Pydantic 정수 Enum JSON 키: 문자열 왕복과 상태 의미 보존
Enum 키를 가진 사전은 JSON으로 나갈 때 키가 문자열이 된다는 추가 경계를 지난다. 다시 읽은 객체가 생성되지 않거나 기본 상태로 바뀌면 원래 범주별 집계의 의미가 달라질 수 있다. 전송 문자열과 원래 Enum 멤버의 대응을 명시해야 형식 변환과 의미 복원을 구별한다. [1, 2, 3]
공개 원문이 보여 준 범위
정수값을 가진 일반 Enum이나 Literal을 dict 키로 쓰면 JSON에서 문자열이 된 키를 다시 검증하지 못하는 보고다. IntEnum·문자열 Enum·일반 int 등의 대조는 왕복이 된다고 구별했다. [1]
입력과 출력에서 확인할 관계
각 Enum 멤버의 의미와 원래 값, 전송 문자열을 같은 대응표에 기록한다. 변환의 양방향에서 키별 건수가 유지되는지 확인하고 enum_member, wire_key, restored_member, count를 함께 보관한다. 해독 실패 때 임의 기본값을 넣었다면 이를 원래 상태와 구별해야 상태별 합계가 다른 의미로 바뀌지 않는다. [1, 3]
승인 기준과 실패 사례
설명용 mapping은 전송 문자열 200을 OK에 대응시킨다. 복원 결과가 OK이면 의미를 보존하지만 UNKNOWN으로 바꾸면 승인한 대응을 충족하지 못한다. 해독 오류를 조용히 새로운 상태 범주로 만드는 것은 왕복 성공이 아니다. 키가 문자열로 변했다는 형식적 사실과 원래 Enum 의미를 복원했다는 사실을 각각 확인한다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 ColumnPairInSetValidator는 준비한 wire_key와 restored_member 쌍이 승인한 valid_pairs에 속하는지 검사할 수 있다. 키를 문자열로 만든 사실과 Enum 의미를 복원한 사실을 구분한다. null 쌍을 무시하는 설정도 확인해 미복원 키가 검사에서 사라지지 않게 한다. [1, 2, 3]
다른 선택이 필요한 조건
모든 Enum을 IntEnum으로 바꾸면 비교 의미가 달라질 수 있으므로 무조건적 타입 변경을 권하지 않는다. JSON용 문자열 키 스키마를 분리하고 명시적인 decoder를 제공한다. wire 스키마가 원래부터 문자열 Enum이면 해당 비문자 literal 키 문제는 직접 적용되지 않는다. [1, 3]
적용 조건
enum_member, wire_key, restored_member, count 대조표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
JSON용 문자열 키 스키마를 분리하고 명시적인 decoder를 제공한다.
한계
모든 Enum을 IntEnum으로 바꾸면 비교 의미가 달라질 수 있으므로 무조건적 타입 변경을 권하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
