TOML

TOML (zkratka anglického Tom's Obvious, Minimal Language, doslova zhruba Tomův zřejmý, minimální jazyk) je souborový formát určený pro konfigurační soubory.

Jeho cílem je poskytovat snadno parsovatelná asociativní pole, která je zároveň snadné editovat obyčejným textovým editorem a jehož syntaxe bude co nejjednodušší, minimální. Vychází ze základní podoby inicializačních souborů, jejichž syntaxe ovšem není standardizovaná a zcela jednotná. Původně jej vytvořil zakladatel GitHubu Tom Preston-Werner, od jehož křestního jména je odvozen název formátu, ale jeho specifikace je otevřená a knihovny pro jeho zpracování v různých programovacích jazycích vznikají a jsou udržovány nezávisle na původním autorovi.

V základu se formát sestává ze tří základních prvků:

• dvojic jméno-hodnota: jmeno = "hodnota"
• názvů oddílů v hranatých závorkách: [Sekce]
• komentářů uvozených znakem mřížky: #tohle je komentář

Kromě textových řetězců jsou podporovány i další datové typy: integer, float, boolean, typy pro datum a čas a pole.

# Příklad dokumentu ve formátu TOML

title = "Příklad TOMLu"

[database]
server = "192.168.1.1"
ports = [ 8000, 8001, 8002 ]
connection_max = 5000
enabled = true

# Uvnitř polí lze použít odřádkování
hosts = [
  "alpha",
  "omega"
]

[servers]

  # Je možné i odsazovat, ale není to povinné
  [servers.alpha]
  ip = "10.0.0.1"
  dc = "eqdc10"

  [servers.beta]
  ip = "10.0.0.2"
  dc = "eqdc10"