TOML ↔ JSON 변환기

TOML과 JSON은 같은 모양의 설정 데이터를 아주 다른 문법으로 기술하고, 이 변환기는 양방향으로 오갑니다. Cargo.toml이나 pyproject.toml을 붙여 넣으면 린터나 생성기, 스크립트가 기대하는 JSON이 나오고, JSON을 넣으면 러스트와 파이썬 도구들이 실제로 배포하는 형태의 TOML이 나옵니다. 실제 파일에 등장하는 TOML의 요소들을 다룹니다. 테이블 [a.b], 테이블 배열 [[a.b]], 인라인 테이블, 인라인 배열, 기본 문자열과 리터럴 문자열, 정수, 밑줄 구분자가 든 실수, 불리언, 날짜까지 포함합니다.

변환은 대칭이 아니고, 그 비대칭의 정체는 TOML에 없는 null입니다. JSON에는 있고 TOML에는 없습니다. 그쪽의 관례는 키를 아예 생략하는 것입니다. JSON에서 TOML로 갈 때 이 도구는 키를 버리는 대신 빈 문자열을 씁니다. 그래서 구조는 살아남지만 "없음"과 "명시적으로 비어 있음"의 구분은 살아남지 못합니다. 그 차이가 여러분의 스키마에서 의미를 갖는다면, 변환 후가 아니라 변환 전에 해당 키들을 처리하세요.

날짜는 두 형식이 진짜로 어긋나는 또 다른 지점입니다. TOML에는 일급 날짜·시간 타입이 있고, 그중에는 의도적으로 오프셋을 담지 않는 로컬 날짜시간도 있습니다. JSON에는 문자열밖에 없습니다. 이 변환기는 날짜시간을 적힌 그대로 보존하는데, 게으름이 아니라 의도된 선택입니다. 날짜 객체로 파싱했다가 다시 서식화하면 그 빠져 있던 오프셋이 보는 사람의 시간대로 해석되어 버려서, 같은 pyproject.toml을 서울에서 열 때와 리스본에서 열 때 서로 다른 JSON 문서가 나오게 됩니다. 텍스트를 그대로 두면 들어온 값이 그곳에 있던 값 그대로입니다.

작은 메모 둘. TOML의 정수는 명세상 64비트 부호 있는 정수인데 JSON의 수는 대부분의 파서에서 배정도 실수입니다. 그래서 2의 53승을 넘는 값은 자바스크립트에서 왕복을 온전히 견디지 못합니다. 빌드 번호나 스노플레이크 ID가 흔한 희생자입니다. 그리고 a.b = 1과 [a] 아래의 b = 1은 TOML에서 정확히 같은 뜻이므로, 겉보기에 전혀 닮지 않은 두 파일이 동일한 JSON으로 변환될 수 있습니다. diff가 진짜 변경을 찾아냈다고 결론 내리기 전에 기억해 둘 만합니다.