TOML 수정 도구
손상된 TOML 구문을 자동으로 감지하고 복구합니다
TOML 수정 도구란?
Cargo.toml을 손으로 수정하고 저장한 뒤 cargo build를 돌렸는데, 47번째 줄의 닫히지 않은 문자열 때문에 빌드가 멈춰본 적 있죠? 이 도구가 그런 흔한 문제 — 따옴표 누락, [server.production]처럼 닫히지 않은 헤더, 인라인 테이블의 끝 쉼표 — 를 자동으로 정리해 다시 파서가 받아주는 형태로 돌려줍니다.
Cargo 매니페스트, pyproject.toml, Hugo 설정, Black, Poetry, ruff 등 어떤 TOML이든 동작합니다. 출력은 TOML 1.0 사양을 따르므로 toml-rs, tomllib, go-toml 같은 표준 파서에서 그대로 사용할 수 있습니다.
모든 처리는 브라우저 안에서 끝납니다. 설정 파일이 어디로도 업로드되지 않으니 토큰이나 DSN이 들어 있어도 안심하고 사용할 수 있습니다.
TOML 수정 도구 사용 방법
단계는 세 개. 각각 페이지의 실제 버튼에 대응합니다.
손상된 TOML 붙여넣기 또는 샘플 불러오기
왼쪽 에디터에 잘못된 TOML을 붙여넣으세요. 샘플 TOML을 누르면 도구가 처리하는 오류 유형을 확인할 수 있습니다.
title = My Server
[server.production
port 8443
log_path = "/var/log/app.log"
allowed = ["a", "b",]수정 도구는 TOML 1.0 사양을 기준으로 동작하므로 결과는 호환되는 어떤 파서에서도 작동합니다.
TOML 수정하기!! 클릭
도구 모음의 녹색 TOML 수정하기!! 버튼을 누르세요. 도구가 TOML을 분석해 자동으로 복구합니다. 처리 중에는 "TOML 수정 중..." 표시가 나타납니다.
결과 확인
오른쪽 패널에 복구된 TOML이 나타납니다. 값은 그대로 두고 구조만 정리합니다. 결과를 복사해서 Cargo.toml이나 pyproject.toml에 붙여 넣기만 하면 됩니다.
실제 활용 사례
Cargo.toml 디버깅
의존성을 직접 추가하다 따옴표가 어긋나 cargo check조차 시작되지 않을 때, 매니페스트를 붙여넣어 정리된 버전을 받고 다시 작업을 이어갈 수 있습니다.
pyproject.toml 복구
[tool.black]이나 [tool.ruff]를 수정하다 [build-system] 테이블이 망가지는 흔한 실수에 대응합니다. 헤더를 다시 세우고 잘린 인라인 테이블도 마무리해 줍니다.
Hugo 설정 편집
Hugo의 config.toml은 중첩 테이블이 많아 튜토리얼에서 복사하다 쉽게 깨집니다. 헤더를 정규화해 배포를 막지 않게 해 줍니다.
붙여넣기 사고 복구
Slack이나 GitHub에서 복사한 TOML이 따옴표나 줄바꿈 때문에 동작하지 않을 때, 원래 데이터는 유지한 채로 깔끔하게 정리해 줍니다.
자주 묻는 질문
TOML 데이터가 저장되나요?
아니요. 모든 처리는 브라우저 안에서 이뤄집니다. 파일이 서버로 전송되거나 기록되지 않습니다.
어떤 오류를 수정할 수 있나요?
닫히지 않은 따옴표, 잘못된 테이블 헤더, 닫히지 않은 인라인 테이블, 허용되지 않는 끝 쉼표, 잘못 들어간 스마트 따옴표, 배열 안 들여쓰기 문제 등을 처리합니다.
값은 그대로 유지되나요?
네. 도구는 구조만 손보며 문자열, 숫자, 불리언, 날짜 값은 입력 그대로 출력됩니다.
TOML이 너무 망가졌다면?
구조가 회복 불가능할 만큼 깨졌다면 가능한 부분만 복구합니다. 일반적으로 처음보다 훨씬 유효한 형태로 출력됩니다.
결과가 제 파서에서 동작하나요?
네. TOML 1.0 문법을 따르므로 toml-rs, Python 3.11+의 tomllib, go-toml 등 호환 라이브러리에서 동작합니다.
큰 파일도 가능한가요?
입력 한도는 64 KB입니다. 일반적인 Cargo.toml이나 pyproject.toml은 충분히 들어옵니다.
관련 TOML 도구
수정 외에도 함께 쓸 만한 TOML 도구들입니다: