위키득계정 ↗
기술

TOML

TOML기술
명칭
Tom’s Obvious, Minimal Language
주요 용도
설정 파일
기본 표기
키 = 값
흔한 확장자
.toml
TOML은 명확한 키와 값의 대응을 중심으로 하는 설정 파일 형식이다. 문자열과 숫자, 불리언과 배열 등을 표현하며 테이블을 사용해 관련 설정을 묶을 수 있다.

키와 값의 대응

기본 항목은 키와 값을 등호로 연결해 적는다. 같은 모양의 값처럼 보여도 문자열과 숫자, 불리언은 구분된다. 설정을 읽는 프로그램은 이런 자료형과 각 키의 의미를 바탕으로 동작한다.

테이블로 묶기

서로 관련된 항목은 테이블에 묶어 구조를 만들 수 있다. 점으로 연결한 키도 계층을 표현하는 데 쓰인다. 문서를 읽을 때 줄 순서의 인상만 보기보다 각 키가 속한 구조를 확인해야 한다.

명시적인 문법

TOML은 대소문자를 구분하며 문자열과 주석 등에도 정해진 문법이 있다. 같은 키를 여러 번 정의하는 것처럼 허용되지 않는 표현도 있다. 사람이 뜻을 알아볼 수 있는 문장이라고 파서가 유효한 설정으로 받아들이는 것은 아니다.

버전과 프로그램의 조건

형식의 사양 버전과 실제 파서가 지원하는 범위를 함께 확인해야 한다. 또한 문법적으로 유효한 TOML이라도 프로그램이 모르는 키나 잘못된 값은 설정 오류가 될 수 있다. 파일 형식과 프로그램 설정의 규칙은 별개 층위다.

관련 문서

YAML / JSON / 자료형 / 구문 분석 / 해시 테이블 / 소프트웨어