TOML 정렬·검사

TOML Formatter & Validator

TOML을 정렬하고 검사하며 테이블 순서와 인라인 표기 방식을 통일합니다.

TOML 파일의 간격을 정리합니다. `key = value`, 헤더 공백, 배열 줄바꿈까지 맞추고, 그러는 김에 TOML 1.0 규격에 맞는지도 확인합니다. 파일 위로 리더 두 개가 지나갑니다. 하나는 표기 규칙을 알고 주석을 지키고, 다른 하나는 의미 규칙을 알고 JSON 보기를 만듭니다.

🔒 브라우저 안에서만 처리tomlformatvalidateconfig

출력

인라인 테이블

배열 줄바꿈 기준

테이블 안의 키 정렬키/값 줄만 알파벳순으로 옮깁니다. 주석과 빈 줄은 제자리에 남습니다.

테이블 헤더 정렬같은 층위의 [테이블]을 이름순으로 옮기되 하위 테이블은 함께 갑니다. [[배열]]의 요소 순서는 값이므로 건드리지 않습니다.

TOML 입력

.toml 파일 놓기

이 탭 안에서만 읽습니다. 어디에도 올라가지 않습니다.

정렬된 TOML

# pyproject.toml — the spacing and the line breaks can be as uneven as you like
[project]
name = "todododo-tools"
version = "0.4.1"
requires-python = ">=3.11"
dependencies = [
  "httpx>=0.27",
  "pydantic>=2", # validation
  "rich",
]
authors = [{ name = "Kim Jiwon", email = "jiwon@example.com" }]

[project.optional-dependencies]
dev = ["pytest", "ruff"]

[tool.ruff]
line-length = 100
select = ["E", "F", "I"]

[[tool.tasks]]
name = "test"
cmd = "pytest -q"
when = 2024-06-01T09:00:00+09:00

[[tool.tasks]]
name = "lint"
cmd = '''ruff check .'''

테이블

키/값

주석

검사

통과

무엇을 바꾸고 무엇을 두는지

· key = value의 띄어쓰기, 헤더의 [ a . b ] 같은 공백, 배열·인라인 테이블 안의 간격을 통일하고 헤더 앞에 빈 줄을 하나 둡니다.
· 짧은 배열은 한 줄로, 기준 폭을 넘거나 안에 주석이 있는 배열은 요소마다 한 줄로 씁니다. 마지막 요소 뒤에는 쉼표를 붙입니다.
· 문자열·숫자·날짜는 쓴 그대로 둡니다. 1_000을 1000으로, 0xff를 255로 바꾸는 것은 정렬이 아니라 편집입니다.
· 따옴표가 필요 없는 키("name")는 따옴표를 벗기고, 필요한 키("127.0.0.1")는 리터럴 따옴표로 씁니다.
· 앞자리 0, 잘못 놓인 밑줄, True, 여러 줄에 걸친 인라인 테이블, 중복 키, 두 번 정의한 테이블은 TOML 1.0 규격(toml.io)에 따라 거부합니다.

JSON이나 YAML로 바꾸려면 JSON ⇄ TOML 변환기를 쓰세요.

사용 방법

파일을 붙여넣습니다
`Cargo.toml`, `pyproject.toml`, `netlify.toml` 같은 것들입니다. 간격이 제각각인 게 정상입니다. 그걸 고치려는 거니까요.
배열 줄바꿈 폭을 정합니다
짧은 배열은 한 줄에 그대로 있고, 폭을 넘거나 안에 주석이 있는 배열은 요소마다 한 줄로 쓰고 끝에 쉼표를 붙입니다. 그 쉼표가 나중의 diff를 한 줄로 유지해 줍니다.
도움이 될 때만 정렬합니다
키 정렬은 키/값 줄만 옮기고 주석과 빈 줄은 제자리에 둡니다. 테이블 정렬은 같은 층위의 헤더를 이름순으로 옮기고 하위 테이블을 함께 데려갑니다. 테이블 배열의 순서는 데이터이므로 건드리지 않습니다.

자주 묻는 질문

`1_000`을 왜 `1000`으로 안 바꾸나요?

그건 정렬이 아니라 편집이기 때문입니다. 숫자의 밑줄, 16진수 리터럴, 날짜를 쓴 방식은 모두 작성자가 고른 것입니다. 포매터는 공백과 인용만 바꾸고 값은 쓴 그대로 둡니다.

다른 파서는 받는 파일인데 여기서는 거절합니다.

TOML 1.0이 금지하지만 관대한 리더가 봐주는 것들 중 하나일 가능성이 큽니다. 앞자리 0, 잘못 놓인 밑줄, 대문자로 시작하는 `True`, 여러 줄에 걸친 인라인 테이블, 중복 키, 두 번 정의한 테이블 같은 것들입니다. 오류가 어느 것인지 줄 번호와 함께 알려 줍니다.