Pydantic Decimal JSON Schema: 1E-7 출력과 지수 표기 계약
값의 정확성 요구와 허용 문자열 표기법을 분리하면 소비자에게 불필요한 값 수정 대신 호환 선택을 제공할 수 있다.
Pydantic Decimal JSON Schema: 1E-7 출력과 지수 표기 계약
정확한 Decimal 값도 생산자와 소비자가 서로 다른 문자열 문법을 사용하면 교환에 실패할 수 있다. 지수 표기를 출력하는 serializer와 이를 허용하지 않는 스키마가 함께 있으면 계산을 다시 해도 문제가 해결되지 않는다. 표현을 확장할지 출력 형식을 제한할지 양쪽이 먼저 합의해야 한다. [1, 2, 3]
공개 원문이 보여 준 범위
Pydantic Decimal serializer가 작은 값을 1E-7로 출력하지만 serialization JSON Schema의 정규식에는 지수 표기가 없어 스스로 만든 출력을 거절하는 보고다. 원문은 스키마 확장과 고정소수점 직렬화라는 대안을 제시한다. [1]
입력과 출력에서 확인할 관계
생산자와 소비자가 지수 표기를 허용할지 먼저 합의한다. 작은 값, 큰 값, 부호가 있는 값을 그 문법으로 왕복 시험하고 decimal_text, notation_policy, schema_acceptance를 기록한다. 이렇게 해야 표현 방식의 불일치를 산술 오류로 잘못 설명하지 않고 어느 쪽의 계약을 바꿔야 하는지 결정할 수 있다. [1, 3]
승인 기준과 실패 사례
설명용 계약은 지수 표기를 허용하므로 1E-7은 accepted 상태가 되어야 한다. rejected가 나오면 선택한 문법을 지키지 못한 것이며 Decimal 값 자체가 틀렸다는 증거는 아니다. 고정소수점만 허용하는 소비자라면 생산자도 그 표현을 명시적으로 지원해야 한다. 문자열을 조용히 고치는 대신 양쪽의 표현 정책을 함께 맞춘다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 RegexValidator는 승인한 지수 표기 문법으로 원래 Decimal 문자열을 검사하는 데 쓸 수 있다. 검사 패턴이 실제 업무 문법과 일치하는지 먼저 확인하고 숫자 계산의 정확성은 별도로 검증한다. 출력 문자열을 조용히 바꾸는 대신 생산자와 소비자의 표현 계약을 함께 수정한다. [1, 2, 3]
다른 선택이 필요한 조건
정규식 일치는 Decimal 연산·반올림 정확성을 증명하지 않는다. 소비자 계약이 고정소수점을 요구하면 생산자가 명시적으로 고정소수점 문자열을 직렬화한다. 소비자가 의도적으로 지수 표기를 금지했다면 스키마를 넓히는 대신 생산자 표현을 맞춰야 한다. [1, 3]
적용 조건
승인된 지수 표기 문법을 정하고 원본 Decimal 문자열에 RegexValidator를 적용한다. 결과 상태를 별도 대조표에 기록한다.
대안
소비자 계약이 고정소수점을 요구하면 생산자가 명시적으로 고정소수점 문자열을 직렬화한다.
한계
정규식 일치는 Decimal 연산·반올림 정확성을 증명하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
