JSON YAML 변환기

이 도구에 대하여

두 형식의 관계

JSON과 YAML은 같은 종류의 데이터, 즉 매핑, 목록, 문자열, 숫자, 불리언, null을 표현합니다. YAML 1.2는 JSON이 자신의 부분집합이 되도록 만들어졌고, 여기에 사람이 직접 편집하는 파일에 필요한 것들을 더합니다. 주석, 괄호 대신 들여쓰기, 여러 줄 문자열, 한 파일 안의 여러 문서, 값을 재사용하기 위한 앵커와 별칭이 그것입니다.

JSON에서 YAML로 바꿀 때는 모든 값이 유지되며, 예외는 하나뿐입니다. YAML 매핑은 키를 반복할 수 없으므로, 같은 객체에 두 번 나오는 키는 마지막 값만 남습니다. YAML에서 JSON으로 바꿀 때는 데이터만 남습니다. 주석은 사라지고, 별칭과 << 병합 키는 가리키는 값으로 대체되며, !Ref 같은 사용자 정의 태그는 제거되고 값만 남으며, 1이나 true처럼 문자열이 아닌 키는 텍스트가 됩니다.

알아 두면 좋은 YAML의 함정

노르웨이 문제. YAML 1.1에서는 따옴표 없는 yes, no, on, off가 불리언이므로, no가 들어 있는 국가 코드 목록에 false가 섞이게 됩니다. YAML 1.2에서는 true와 false만 남았습니다. 이 도구의 파서는 문서가 %YAML 1.1 지시문으로 시작하지 않는 한 YAML 1.2를 따르므로 no를 문자열 "no"로 읽습니다. 아직 쓰이는 파서 중 상당수가 1.1 규칙을 적용하기 때문에, 이 도구는 YAML을 쓸 때 이런 문자열을 따옴표로 감쌉니다.

버전 번호. 따옴표 없는 1.10은 부동소수점 숫자이고, 숫자로는 1.1입니다. 버전 번호, 우편번호처럼 숫자로 보이기만 하는 값을 텍스트로 유지하려면 따옴표로 감싸야 합니다: version: "1.10".

이 도구의 변환 방식

마지막으로 수정한 쪽이 원본이 되고, 다른 쪽은 원본을 바탕으로 다시 작성됩니다. 원본을 파싱할 수 없으면 그 아래에 오류가 표시되고, 다른 쪽에는 마지막으로 성공한 변환 결과가 남습니다. 들여쓰기 옵션은 생성되는 쪽에 적용됩니다. JSON 들여쓰기를 바꾸면 직접 입력한 JSON도 다시 들여쓰지만, 직접 입력한 YAML은 다시 쓰면 주석이 사라지므로 절대 다시 쓰지 않습니다.

키는 원본의 순서를 유지하며, JavaScript 객체라면 맨 앞으로 옮겨 버릴 숫자로 된 키도 마찬가지입니다. 2의 53제곱보다 큰 정수는 양방향 모두 자릿수 그대로 복사됩니다. ---로 구분된 여러 문서가 들어 있는 YAML 파일은 JSON 배열이 되며, 페이지에 그 사실이 표시됩니다. 한 YAML 매핑에서 두 번 쓰인 키는 오류로 보고됩니다. YAML의 읽기와 쓰기는 브라우저에서 실행되는 오픈 소스 yaml 패키지가 처리합니다.