Pydantic exclude_none: 필수 nullable 키와 누락 키를 구별하기
필수 여부는 키의 존재 조건이고 nullable은 값의 허용 조건이므로 팀의 인수표도 둘을 분리해야 한다.
Pydantic exclude_none: 필수 nullable 키와 누락 키를 구별하기
nullable 필드는 비어 있는 값을 허용한다는 뜻이지 키 자체를 생략해도 된다는 뜻은 아닐 수 있다. 출력에서 None을 지우는 옵션을 일괄 적용하면 소비자가 필수로 요구하는 키까지 없어질 수 있다. 키 존재와 값의 결측을 별도 상태로 보아야 왕복 계약을 정확히 설명할 수 있다. [1, 2, 3]
공개 원문이 보여 준 범위
exclude_none이 기본값 여부와 무관하게 None 필드를 제외해 필수 nullable 필드의 직렬화 결과를 다시 검증할 수 없다는 기능 요청이다. 현재 동작 설명과 변경 제안을 구분해야 한다. [1]
입력과 출력에서 확인할 관계
생산자와 소비자가 키 생략, 명시적인 null, 실제 값의 사례를 각각 준비한다. 필수 키를 제거할 수 있는 직렬화 옵션은 변경 전에 함께 합의한다. field_name, required, key_present, value_is_null을 분리해 기록하면 값이 비어 있다는 사실과 필드 자체가 전달되지 않았다는 사실을 다른 조건으로 검사할 수 있다. [1, 3]
승인 기준과 실패 사례
설명용 계약에서 x는 필수이지만 null을 허용한다. x:null이 있는 객체는 key_present가 present이므로 존재 조건을 충족한다. x가 없는 객체는 absent이므로 실패한다. null을 임의 값으로 채우면 키 보존과는 다른 문제를 바꾸게 된다. 원시 객체를 표로 합치기 전에 존재 상태를 기록해야 합쳐진 표의 열만 보고 누락을 놓치지 않는다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 ColumnExistsValidator는 필수 키가 실제 열로 보존된 표에서 열 존재를 검사한다. 각 원시 객체의 키 누락을 알아야 한다면 표로 합치기 전에 key_present를 따로 추출해야 한다. 전체 열이 존재하는 것과 모든 행의 원시 키가 존재했던 것은 같지 않다. [1, 2, 3]
다른 선택이 필요한 조건
모든 null을 거절하는 NotNull 검사는 이 계약의 대안이 아니다. 필수 nullable 필드는 유지하는 직렬화 정책을 만들고 응답 스키마를 다시 검증한다. 소비자 계약에서 x가 선택 필드라면 생략은 정상일 수 있다. [1, 3]
적용 조건
원시 객체의 키 존재를 별도로 추출하고 필수 키를 실제 열로 보존한 표를 준비한다. null 값과 열 부재를 구별한다.
대안
필수 nullable 필드는 유지하는 직렬화 정책을 만들고 응답 스키마를 다시 검증한다.
한계
모든 null을 거절하는 NotNull 검사는 이 계약의 대안이 아니다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
