TOML ⇄ JSON 변환
Rust/Python 설정 · 양방향 변환
TOML 변환
준비됨
ABOUT
TOML ⇄ JSON 변환 소개
TOML과 JSON 형식 간 변환, Rust·Python 프로젝트 설정 파일 편집에 편리.
Rust Cargo, Python Poetry, Hugo 설정 — TOML은 정적 타입·스크립트 언어 생태계에서 점점 흔해집니다. 로컬 상호 변환으로 cargo, python -c 없이 pyproject.toml 구조를 검토할 수 있습니다.
DEEP DIVE
TOML ⇄ JSON 변환 자세히 알아보기
TOML(Tom's Obvious Minimal Language)은 Rust Cargo, Python Poetry/pyproject.toml, Hugo 설정 등으로 널리 쓰입니다. JSON보다 읽기 쉽지만 JavaScript는 기본 미지원. JSONSort는 TOML ↔ JSON 로컬 양방향 변환을 제공하며 Python tomllib나 Rust toml crate 설치가 필요 없습니다.
변환 시 테이블([section])과 키-값 구조를 유지: TOML table → JSON 객체, array of table → JSON 객체 배열. Rust/Python 프로젝트 설정 구조를 빠르게 확인하기 적합.
TOML table과 dotted key는 JSON에서 모두 중첩 객체로 매핑. [[array of tables]]는 JSON 객체 배열. 변환 후 트리 뷰로 [dependencies] 등 section 전개가 올바른지 확인하고, dotted key와 table 충돌로 덮어쓰기를 피하세요.
FEATURES
핵심 기능
TOML → JSON
TOML 설정 파일을 JSON 객체로 파싱.
JSON → TOML
JSON에서 형식에 맞는 TOML 텍스트 생성.
Table 지원
[section]과 [[array of tables]]를 올바르게 처리.
타입 보존
문자열, 정수, 부동소수점, 불리언, 날짜·시간을 올바르게 매핑.
파일 가져오기
.toml 파일 드래그로 가져와 파싱.
로컬 변환
Cargo.toml 등에 비공개 crate 소스 설정이 있을 수 있어 로컬이 더 안전.
날짜·시간
TOML offset datetime → ISO 8601 JSON 문자열.
정수/부동소수점
TOML 정수와 부동소수점 구분, JSON에서 타입 올바르게 보존.
HOW TO USE
사용 방법
-
1
TOML 또는 JSON 붙여넣기
-
2
변환 방향 선택
-
3
결과 복사 및 내보내기
-
4
변환 실패 시 오류 메시지 확인, 소스 파일 구문 수정 후 재시도
-
5
포맷터로 결과 정리, 또는 하류 스크립트용으로 내보내기
WORKFLOW
일반적인 워크플로
데이터 가져오기부터 결과 내보내기까지의 전체 흐름. 팀에서 TOML ⇄ JSON 변환 사용법을 통일.
TOML 가져오기
Cargo.toml / pyproject.toml 붙여넣기 또는 파일 드래그.
JSON 확인
트리 뷰로 table과 array of tables 구조 확인.
편집(선택)
JSON 측 수정 후 TOML로 되돌려 PR 제출.
파이프라인 연동
TOML 미지원 내부 도구에 JSON 복사.
USE CASES
적용 시나리오
Rust 개발
Cargo.toml → JSON 후 트리 뷰로 의존성 구조 탐색.
Python 개발
pyproject.toml → JSON, CI 스크립트 읽기에 편리.
DevOps
TOML 설정과 JSON 설정 관리 도구 체인 통일.
기술 문서 작성
문서 TOML 예시 옆에 JSON 동등 형태 제공.
Rust 생태계
Cargo.toml workspace 멤버·features → JSON, CI 매트릭스용.
정적 사이트
Hugo config.toml → JSON, headless CMS 설정 동기화.
TIPS
사용 팁
- Cargo.toml 변환 후 [dependencies] 아래 crate 버전 키 확인.
- TOML 날짜·시간 타입은 JSON에서 보통 ISO 8601 문자열로 변환.
- JSON → TOML 시 깊은 중첩 객체는 dotted key 또는 subtable로 변환.
- YAML 도구와 비교: Rust는 TOML, K8s는 YAML — 프로젝트에 맞게 선택.
- 변환 실패 시 TOML 중복 키·닫히지 않은 문자열 확인.
- 변환 결과는 포맷터로 정리하면 Git diff 검토에 편리.
- Cargo workspace.dependencies → JSON 후 경로 추출로 버전 확인.
- JSON → TOML 후 dotted key와 [table]을 같은 계층에 혼용하지 마세요.
- 변환 실패 시 TOML 중복 키·닫히지 않은 문자열 확인.
- YAML 도구와 비교: 프로젝트 생태계에 맞는 소스 형식 선택, JSON을 중간 다리로.
LOCAL VS ONLINE
로컬 vs 온라인 도구
JSONSort는 순수 프론트엔드 아키텍처를 고수합니다. 아래 비교가 개발 데이터 처리에 로컬 도구가 적합한 이유를 보여줍니다.
TROUBLESHOOTING
흔한 오해 및 문제 해결
실제 사용에서 자주 발생하는 문제와 권장 대처법. 시행착오 시간을 줄입니다.
중복 키 오류
권장:TOML은 중복 정의 불가. dotted key와 table 충돌 확인.
TOML 되돌릴 때 순서 변경
권장:기능상 동등. 순서 의존 시 수동 조정.
날짜 형식 오류
권장:TOML datetime에 타임존 포함 확인. JSON 측은 ISO 문자열.
특수 문자 키
권장:점 포함 키는 따옴표로 감싸기 "key.with.dots".
FAQ
자주 묻는 질문
Cargo.toml을 지원하나요?
표준 TOML 1.0 구문 지원. Cargo 특유 의미(workspace 등)는 구조대로 변환.
JSON → TOML 시 정보 손실이 있나요?
JSON이 표현 가능한 구조는 모두 TOML로 변환 가능. TOML 주석은 JSON 방향에서 손실.
YAML 도구와 차이점은?
TOML과 YAML 구문이 다름. 소스 파일 형식에 맞는 도구 선택.
inline table을 지원하나요?
{ key = "value" } 형태 지원, JSON 중첩 객체로 변환.
주석이 사라지면?
TOML 주석은 JSON에 들어갈 수 없음. .toml 원본을 주석 출처로 보관.
데이터가 서버에 업로드되나?
아니요. JSONSort 모든 도구는 브라우저 로컬에서 동작하며 입력 내용은 백엔드 서버로 전송되지 않습니다.
가입이나 설치가 필요한가?
필요 없습니다. 페이지를 열면 바로 사용 가능, 계정·클라이언트 다운로드 불필요, PWA 오프라인 캐시 지원.
얼마나 큰 파일을 지원하나?
브라우저 메모리에 따라 다르지만 보통 수 MB급 데이터를 원활히 처리합니다. 초대형 파일은 먼저 분할하거나 병합·정리 도구를 사용하세요.