Pydantic strict Literal: 정규화된 값과 원시 숫자 토큰 종류
프로토콜이 원래 숫자 타입을 구별한다면 coercion 이후 값만으로 수신 계약을 검증할 수 없다.
Pydantic strict Literal: 정규화된 값과 원시 숫자 토큰 종류
허용한 숫자값을 얻었다고 해서 원래 입력 토큰의 종류까지 계약에 맞았다는 뜻은 아니다. 프로토콜이 정수 표기와 소수 표기를 구별한다면 변환 뒤 값만 남기는 검증으로는 요구를 설명할 수 없다. 원시 종류를 보존해야 strict라는 옵션 이름에 기대지 않고 실제 수용 정책을 확인할 수 있다. [1, 2, 3]
공개 원문이 보여 준 범위
strict 설정의 정수 Literal이 숫자값이 같은 부동소수점 입력을 수용하고 정수로 변환한다는 보고다. 원문은 StrictInt의 거절과 비교하며 의도한 동작인지 문서 명확화를 요청한다. [1]
입력과 출력에서 확인할 관계
프로토콜 담당자와 모델 담당자는 원시 숫자 토큰 종류를 남기고 허용 값 집합과 별도로 검사한다. raw_numeric_kind, normalized_value, protocol_kind를 비교하면 변환 뒤 값이 맞아 보이더라도 입력 형식이 달랐는지 확인할 수 있다. 원시 파싱 단계에서 이 정보를 잃으면 정규화한 정수만으로는 되찾을 수 없다. [1, 3]
승인 기준과 실패 사례
설명용 프로토콜은 정수 토큰 2를 2.0 및 2e0과 구별한다. 허용 종류는 integer이고 decimal은 이 계약의 반례다. 정규화 결과가 2라고 원래 종류를 덮어쓰지 않는다. 모든 JSON 소비자에게 같은 구별을 강요하는 규칙이 아니라 해당 프로토콜이 명시적으로 요구한 입력 계약이다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 InSetValidator는 전처리에서 보존한 raw_numeric_kind가 허용 집합에 속하는지 검사할 수 있다. 정규화된 숫자 열만 넘기면 원래 토큰 종류를 되찾을 수 없다. 원시 파싱과 값 허용집합 검사를 분리한 뒤 함께 승인한다. [1, 2, 3]
다른 선택이 필요한 조건
JSON 규격 자체가 모든 소비자에게 이 세 표현의 구별을 강제한다는 뜻은 아니며 여기서는 명시적 업무 계약이다. 원시 파싱 단계의 타입 검사를 명시하고 값 검증과 조합한다. 프로토콜이 수학적으로 같은 숫자를 모두 허용한다면 이 엄격한 토큰 구별은 불필요하다. [1, 3]
적용 조건
raw_numeric_kind, normalized_value, protocol_kind 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
원시 파싱 단계의 타입 검사를 명시하고 값 검증과 조합한다.
한계
JSON 규격 자체가 모든 소비자에게 이 세 표현의 구별을 강제한다는 뜻은 아니며 여기서는 명시적 업무 계약이다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
