Styxis
Company
Knowledge

Pydantic TypeAdapter union: 선택한 분기의 출력 경로를 검증하기

타입 선언만으로 필드 투영이 완료됐다고 믿지 말고 어떤 분기를 선택했고 무엇을 공개했는지 확인해야 한다.

Pydantic TypeAdapter union: 선택한 분기의 출력 경로를 검증하기

union으로 응답 타입을 넓혔을 때 선택한 분기의 공개 필드도 자동으로 지켜진다고 가정하기 쉽다. 그러나 runtime 객체의 속성과 승인한 투영 범위는 다른 정보다. 경고와 함께 출력이 나왔다면 필드 경로를 대사하기 전까지 그 응답을 정상 공개 결과로 취급하지 않는다. [1, 2, 3]

공개 원문이 보여 준 범위

Pydantic TypeAdapter에 단일 타입 대신 union을 전달하면 비-Pydantic 객체의 전체 필드가 직렬화되거나 지원하지 않는 객체는 오류를 내는 보고다. 경고가 있어도 JSON 출력이 존재하는 경우가 포함된다. [1]

입력과 출력에서 확인할 관계

먼저 응답 분기를 검증하고 선택한 뒤 그 분기의 선언 경로와 실제 출력 경로를 대사한다. selected_branch, output_path, allowed_path를 연결해 사용자가 허용한 필드만 전달한다. 직렬화 경고와 함께 JSON이 나왔다고 더 넓은 객체 전체를 승인하지 말아야 한다. 지원하지 않는 객체의 오류도 별도 실행 결과로 보관한다. [1, 3]

승인 기준과 실패 사례

설명용 분기가 허용한 경로는 derived_from_id뿐이다. 추가 경로 수가 0이면 투영 계약을 충족하지만 id와 name까지 출력되어 차집합이 2개가 되면 실패다. 기대 집합은 런타임 객체의 모든 속성이 아니라 선택한 스키마에서 준비한다. 경로 집합이 맞더라도 개별 필드값의 의미까지 확인된 것은 아니므로 값 검사는 별도로 남긴다. [1, 3]

Truthound를 연결하는 검사 경계

Truthound Core 3.3.2의 DistinctValuesEqualSetValidator는 준비한 출력 경로 열의 집합이 선언 집합과 같은지 검사할 수 있다. 경로를 추출할 때 중첩 위치와 branch를 유지하고, 필드값의 의미 검증은 별도 조건으로 남긴다. 분기 선택과 모델 인스턴스 생성은 호출자의 책임이다. [1, 2, 3]

다른 선택이 필요한 조건

모든 union serialization을 결함으로 단정하지 않으며 도메인 객체를 먼저 검증하는 책임은 호출자에게 있다. 모델 인스턴스를 명시적으로 검증·생성한 뒤 해당 구체 타입으로 직렬화한다. 의도한 분기가 객체 전체 필드를 허용하면 추가 경로가 위반이라고 볼 수 없다. [1, 3]

적용 조건

selected_branch, output_path, allowed_path 경로 대사표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.

대안

모델 인스턴스를 명시적으로 검증·생성한 뒤 해당 구체 타입으로 직렬화한다.

한계

  • 모든 union serialization을 결함으로 단정하지 않으며 도메인 객체를 먼저 검증하는 책임은 호출자에게 있다.

근거

사건 확인일
대상 확인일
수정일