Pydantic validate_call Unpack: 사라진 오타 옵션과 기본값 실행
옵션 값뿐 아니라 요청한 옵션 집합과 실제 수용한 집합을 공유해야 설정 누락을 정상 실행으로 오해하지 않는다.
Pydantic validate_call Unpack: 사라진 오타 옵션과 기본값 실행
함수가 오류 없이 실행되어도 요청한 옵션이 적용되지 않았을 수 있다. 선언하지 않은 keyword를 조용히 제거하면 오타가 기본값 실행으로 바뀌어 호출자는 의도와 다른 결과를 받는다. 요청과 수용, 기본값의 경계를 기록해야 이런 성공처럼 보이는 차이를 확인할 수 있다. [1, 2, 3]
공개 원문이 보여 준 범위
validate_call의 Unpack TypedDict에서 선언하지 않은 keyword가 제거되어 오타 옵션이 기본값으로 실행될 수 있다는 요청이다. extra=forbid와 closed 설정의 기존 거절 경로를 원문이 함께 제시한다. [1]
입력과 출력에서 확인할 관계
호출자와 운영자는 요청한 옵션, 수용한 옵션, 기본값을 적용한 항목을 함께 인계한다. 알 수 없는 키는 거절하거나 경고 정책을 명시적으로 승인한다. requested_key, accepted_key, default_applied를 남기면 실행이 끝났다는 사실을 모든 요청 설정이 반영됐다는 증거로 오해하지 않는다. [1, 3]
승인 기준과 실패 사례
설명용 선언 옵션은 timeout이다. 거절 정책을 선택했다면 timeot 요청은 rejected 상태로 돌아가 호출자가 의도를 고칠 수 있어야 한다. accepted로 처리해 기본값을 사용하면 이 계약을 충족하지 못한다. 모든 ignore 정책이 결함이라는 뜻은 아니지만 무시하기로 정했다면 그 결과와 책임도 호출자에게 명확해야 한다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 NotInSetValidator는 준비한 요청 키 열에서 금지된 오타·폐기 키를 찾는 데 쓸 수 있다. 일반적인 unknown-key 검사는 승인 키 목록과의 차집합도 필요하다. 호출을 거절하거나 경고를 보낼 실행 책임은 API 계층에 남는다. [1, 2, 3]
다른 선택이 필요한 조건
이 요청은 기본 정책 변경 제안이며 모든 현재 ignore 동작을 확정 결함이라고 부르지 않는다. TypedDict extra 금지 설정을 명시하고 호환이 필요한 legacy 옵션은 별도 매핑한다. API가 알려지지 않은 옵션을 의도적으로 무시하도록 문서화됐다면 거절 전환은 호환 변경이다. [1, 3]
적용 조건
requested_key, accepted_key, default_applied 설정 인계표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
TypedDict extra 금지 설정을 명시하고 호환이 필요한 legacy 옵션은 별도 매핑한다.
한계
이 요청은 기본 정책 변경 제안이며 모든 현재 ignore 동작을 확정 결함이라고 부르지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
