Intro

TOML (Tom’s Obvious, Minimal Language) is a file format similar to JSON or YAML designed to be human-readable and simple to parse for machines.

What it looks like

  • Key-value pairs

    port = 8080
    debug = true
  • Sections (tables)

    [database]
    host = "localhost"
    port = 5432
  • Nested structure via dotted keys or tables

    robot.motion.speed = 1.5
# This is a TOML document
 
title = "TOML Example"
 
[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00-08:00
 
[database]
enabled = true
ports = [ 8000, 8001, 8002 ]
data = [ ["delta", "phi"], [3.14] ]
temp_targets = { cpu = 79.5, case = 72.0 }
 
[servers]
 
[servers.alpha]
ip = "10.0.0.1"
role = "frontend"
 
[servers.beta]
ip = "10.0.0.2"
role = "backend"