Truthound · 전체 콘텐츠 · 22/24
공개 사건을 근거로 데이터 계약·검사 입력·한계를 설명하는 Truthound Core 검증 실무 자료
480 편
Pydantic bytes JSON Schema: validation 형식과 실제 입력 해독 맞추기
API 문서의 입력·출력 방향을 구분해야 클라이언트와 서버가 서로 다른 바이트 표현을 기대하는 일을 막을 수 있다.
Pydantic alias와 extra 충돌: 검증값과 JSON 출력의 우선권
추가 입력을 허용하는 선택이 검증된 값의 우선권까지 바꾸지 않도록 충돌 처리 계약이 필요하다.
PapaParse Vite production worker: data와 meta.fields의 역할 검사
새 worker 경로는 배포 번들의 반환 envelope까지 검사하는 작은 시험으로 승인해야 한다.
PapaParse unparse의 첫 행 헤더 추론: 뒤늦은 선택 필드 보존
CSV 내보내기 실험은 첫 행의 대표성보다 명시된 전체 필드 계약을 기준으로 설계해야 한다.
pandas Unicode 숫자 구분자: 숫자로 바뀐 값보다 원시 토큰을 확인하기
국제화 설정은 표시 옵션에 그치지 않으므로 원시 토큰과 해독에 사용한 실제 구분자를 보존해야 한다.
pandas SPSS에서 Parquet로 이전: attrs 삭제 전에 보존할 메타데이터
메타데이터를 지우는 우회는 보존 성공과 다르므로 값 데이터와 설명 메타데이터의 이전 계약을 각각 남겨야 한다.
pandas 병렬 CSV의 결측 마스크: 줄어든 결측률을 승인하기 전에
처리 속도 변경 전후의 결측 추세를 비교하려면 동일 원시 토큰에 대한 결측 판정의 연속성을 먼저 확인해야 한다.
pandas ODS covered 셀 읽기: 빈 병합 자리와 저장된 계산값 구별
화면상의 병합 여부와 값 존재 여부를 분리해야 작성자가 계산한 관측을 임의 결측으로 분류하지 않는다.
pandas object uint64의 JSON 출력: 큰 식별자가 음수로 바뀌는 경계
식별자 보존은 값 범위뿐 아니라 원천의 부호와 정확한 십진 표현을 교환 경계에서 대조해야 한다.
pandas 중첩 HTML 표 읽기: 머리글이 관측 행으로 들어오는 경우
DOM의 머리글과 본문 경계를 수집 계약에 남겨야 누적 수집량 증가를 실제 관측 증가로 오해하지 않는다.
pandas CSV·Excel MultiIndex: 열 튜플과 계층 이름을 따로 보존하기
값의 배열이 같더라도 열 계층의 이름은 이용자가 해석하는 축의 의미이므로 별도 승인해야 한다.
pandas calamine과 pyarrow 혼합 열: 수량과 코드의 타입 정책
혼합 타입을 정제 오류로 단정하기 전에 해당 열이 수량인지 속성값 목록인지 합의해야 한다.
pandas read_json의 큰 정수 오류: 계산값과 식별자 보존 계약 나누기
큰 정수가 식별자·정확한 계수·시각 중 무엇인지 먼저 정해야 파싱 성공을 위해 의미를 줄이는 선택을 피할 수 있다.
pandas json_normalize의 결측 목록 원소: 삭제 전 원본 위치 보존
실패를 피하려고 빈 항목을 삭제하기 전에 그 항목이 관측 누락인지 단순 포장인지 결정해야 한다.
pandas json_normalize의 정수 키: max_level과 출력 경로의 차이
출력 열 이름을 표준화할 때 원천 키의 타입까지 덮어쓰면 역사 자료의 재처리 경로를 잃을 수 있다.
pandas read_excel usecols: 선택 밖 중복 이름과 헤더 접미사
열 이름만 되돌리기보다 사용자가 선택한 시트 좌표와 업무 의미를 보존하는 매핑을 제공해야 한다.
pandas Excel 날짜 인덱스: backend 변경과 to_period의 의미 보존
날짜의 의미와 컨테이너가 제공하는 연산을 구분하면 사용자가 멀쩡한 날짜를 재입력하는 부담을 피할 수 있다.
pandas 병렬 CSV converter: 스레드 종속 조회와 결과 재현성
변환 결과의 장기 재현에는 파일뿐 아니라 converter가 참조한 조회표와 실행 조건도 필요하다.
pandas Categorical 날짜의 JSON epoch: date_unit 계약 보존
열을 범주형으로 압축해도 외부 교환 단위가 바뀌어서는 안 되며 단위 계약은 값과 함께 검증해야 한다.
pandas CSV 헤더의 BOM: 보관 파일과 표준 열 이름을 대사하는 방법
원시 바이트와 정규화한 헤더를 함께 보관해야 다음 수집기에서 생긴 이름 차이를 원천 스키마 개정과 구별할 수 있다.
