fast-csv headers 설정: 열 이름 변경과 실제 값 매핑 구별
필드 선택과 출력 제목 변경을 분리해 설명해야 서로 다른 팀이 같은 headers 옵션에 다른 의미를 부여하지 않는다.
fast-csv headers 설정: 열 이름 변경과 실제 값 매핑 구별
CSV의 첫 줄이 원하는 제목으로 나왔다고 원래 객체 값도 그 열로 옮겨졌다고 볼 수는 없다. headers 목록이 키 선택에 쓰이는지 표시 이름 변경에 쓰이는지에 따라 내보내기 계약이 달라진다. 제목과 실제 행 값을 함께 확인해야 겉모양이 정상인 빈 파일을 인계하지 않는다. [1, 2, 3]
공개 원문이 보여 준 범위
fast-csv에 원래 객체 키와 다른 headers 목록을 주었더니 머리글만 있고 값이 빈 출력이 나왔다는 사용 질문이다. 이 보고만으로 라이브러리 결함이나 이름 변경 지원을 확정할 수 없다. [1]
입력과 출력에서 확인할 관계
내보내기 담당자는 원천 키에서 출력 제목으로 가는 명시적 mapping을 만든다. 소비자는 머리글뿐 아니라 필수 행 값도 함께 승인한다. source_key, output_header, source_value, exported_value를 비교하면 첫 줄이 보기 좋게 나왔다는 이유로 값이 비어 있는 파일을 전달하지 않을 수 있다. [1, 3]
승인 기준과 실패 사례
설명용 원천 Name=John을 출력 제목 Name1에 연결한다. 내보낸 값이 John이면 매핑을 보존하지만 빈 문자열이면 제목만 바뀌었을 뿐 내보내기가 완성되지 않았다. 기대값은 headers 옵션이 자동으로 이름을 바꿔 줄 것이라는 가정이 아니라 승인한 키 매핑에서 가져온다. 빈 문자열과 null도 별도 조건으로 다루어야 한다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 RowLevelValidator는 준비한 행의 source_value와 exported_value를 사용자 row_validator로 검사할 수 있다. 빈 문자열과 null을 각각 다루는 조건을 명시해야 하며 NotNull 검사 하나로 둘을 동일하게 잡는다고 설명하지 않는다. 실제 CSV 키 매핑은 내보내기 코드가 수행한다. [1, 2, 3]
다른 선택이 필요한 조건
빈 문자열은 null과 다르므로 빈 문자열 검사 또는 전처리 정책을 별도로 명시해야 한다. 객체 키를 사전에 매핑하거나 라이브러리의 명시 transform 경로를 검증한다. 헤더가 실제 키 선택 옵션이고 해당 키가 없으면 빈값은 문서화된 동작일 수 있다. [1, 3]
적용 조건
원본 객체 키와 출력 제목의 명시 매핑을 준비하고 빈 문자열과 null을 모두 검사하는 row_validator를 정의한다.
대안
객체 키를 사전에 매핑하거나 라이브러리의 명시 transform 경로를 검증한다.
한계
빈 문자열은 null과 다르므로 빈 문자열 검사 또는 전처리 정책을 별도로 명시해야 한다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
