Number, boolean, 날짜 — 네이티브 타입 · Markup Quest

JSON 위 TOML 의 가장 큰 이점: 진짜 날짜

Number

정수 — 64-bit signed. 42, -17, 1_000_000 (밑줄 자릿수 그룹화). 16 진/8 진/2 진 리터럴: 0xff, 0o755, 0b1010.
Float — IEEE 754 double. 3.14, 1e6, 1.5e-3. 특수 값: inf, -inf, nan (literal — JSON 이 이건 허용 안 함).

Boolean

소문자로만 써. true 아니면 false 야. True 도 TRUE 도 yes 도 안 돼. 그래서 여기선 Norway 문제가 아예 일어날 수가 없어. 적는 방법이 하나뿐이거든.

날짜와 시간 — 킬러 feature

Offset Date-Time — timezone 든 RFC 3339. 1979-05-27T07:32:00-08:00. 가장 정밀한 형태.
Local Date-Time — timezone 없음. 1979-05-27T07:32:00.
Local Date — 1979-05-27.
Local Time — 07:32:00.

이 날짜 타입들은 파싱하면 곧장 Python 의 datetime, Rust 의 chrono::DateTime, Go 의 time.Time 으로 떨어져. config loader 에 'ISO 8601 문자열을 파싱해서' 같은 코드를 쓸 일이 없어.

원칙: 데이터에 날짜가 있으면 JSON 보다 TOML 을 골라. JSON 은 '문자열로 쓰기로 하자' 는 약속을 두고 파싱을 한 번 더 거치게 만들지만, TOML 은 아무 손질 없이 타입이 잡힌 값을 내줘. 뒤따르는 코드가 짧아지고, 짧아진 만큼 버그도 줄어.

Code

Number — 모든 형태·toml

# 정수
int_dec    = 1_000_000
int_hex    = 0xff
int_oct    = 0o755
int_bin    = 0b1010
int_neg    = -17

# Float
float_basic = 3.14
float_sci   = 6.022e23
float_neg   = -1.5e-3

# 특수 — TOML 이 허용, JSON 안 함
float_inf  = inf
float_ninf = -inf
float_nan  = nan

Boolean + JSON 대비·toml

is_active = true
is_admin  = false

# 이건 다 파스 에러:
# is_active = True
# is_active = TRUE
# is_active = yes
# is_active = 1

날짜 — 네 가지 flavor·toml

offset_dt = 1979-05-27T07:32:00-08:00
utc_dt    = 1979-05-27T07:32:00Z
local_dt  = 1979-05-27T07:32:00
local_d   = 1979-05-27
local_t   = 07:32:00

Python parse — 박스 밖 강타입·python

import tomllib
from datetime import datetime, date, time

data = tomllib.loads('''
started_at = 2026-05-04T01:30:11+09:00
launch_date = 2026-05-15
''')

assert isinstance(data['started_at'], datetime)
assert isinstance(data['launch_date'], date)
# Reviver 없음, string 파싱 없음 — 박스 밖 강타입 값.

Exercise

TOML config 를 하나 써봐. UTC timestamp 하나, 시간대 없는 날짜 하나, 16 진수로 적은 byte mask 하나, 밑줄로 자릿수를 끊은 정수 하나를 넣어. Python tomllib 으로 파싱해서 타입이 datetime, date, int, int 로 제대로 나오는지 확인하고. 그 다음 같은 걸 JSON 으로 써봐. 날짜가 전부 문자열이 되고, 그걸 파싱하는 걸 잊으면 안 되는 상태가 돼.

Number, boolean, 날짜 — 네이티브 타입

JSON 위 TOML 의 가장 큰 이점: 진짜 날짜

Number

Boolean

날짜와 시간 — 킬러 feature

Code

External links

Exercise

Progress

댓글 0