Co je soubor TOML?

TOML (Tom’s Obvious Minimal Language) je formát minimálního konfiguračního souboru, který používá příponu .toml. TOML si klade za cíl být snadno čitelný, jednoznačně mapovat do slovníků a snadno analyzovat různé datové struktury. TOML má specifikaci open source, která obdržela příspěvky komunity. TOML je podporováno mnoha programovacími jazyky jako C, C#, Dart, Elixir, Erlang, Go, Java, PHP, Python, Ruby, Swift atd. Typ MIME pro soubory TOML je application/toml.

Formát souboru TOML

Soubory TOML se skládají hlavně z párů klíč/hodnota, oddílů/tabulek, komentářů a musí se jednat o platný dokument Unicode kódovaný UTF-8. TOML podporuje datové typy String, Integer, Float, Boolean, Datetime, Array a Table (hash table/dictionary). TOML je jazyk citlivý na velká a malá písmena.

Syntaxe

  • Páry klíč–hodnota: Páry klíč–hodnota jsou odděleny znaménkem rovná se (=). Každý pár musí být na novém řádku.
první = "Tom"
poslední = "Preston-Werner"
  • Komentáře: Komentáře začínají symbolem hash (#).
# Toto je dokument TOML.
  • Řetězce: Řetězce jsou ohraničeny uvozovkami (").
string = "Příkladový řetězec"
  • Víceřádkové řetězce: Víceřádkové řetězce jsou obklopeny třemi uvozovkami (""").
[domovní adresa]
ulice = """123 Tornádo Alley
Suite 16"""
město = "East Centerville"
stav = "KS"
  • Celá čísla/plovoucí čísla
celé číslo = 20
plovoucí = 20,5
  • Booleans: Logické hodnoty jsou vždy malá písmena.
bool1 = pravda
bool2 = false
  • Datum-čas: Jako datum a čas můžete použít datum a čas ve formátu RFC 3339, jak je uvedeno v příkladu níže.
offset_date_time = 1979-05-27 07:32:00Z
local_date_time = 1979-05-27T07:32:00
místní_datum = 1979-05-27
místní_čas = 07:32:00
  • Pole: Pole jsou ohraničena hranatými závorkami s prvky oddělenými čárkami (,).
barvy = [ "červená", "žlutá", "zelená" ]
  • Tabulky: Tabulky jsou kolekce párů klíč/hodnota, které jsou definovány záhlavím na novém řádku ohraničeném hranatými závorkami ([]). Tabulka končí, když je poskytnuto nové záhlaví nebo když končí soubor.
[domovní adresa]
ulice = """123 Tornádo Alley
Suite 16"""
město = "East Centerville"
stav = "KS"

[adresa kanceláře]
ulice = """123 Tornádo Alley
Suite 16"""
město = "East Centerville"
stav = "KS"

Vložené tabulky jsou ohraničeny složenými závorkami ({}), přičemž každý pár klíč/hodnota je oddělen čárkou (,).

jméno = { první = "Tom", poslední = "Pitt" }

Reference

See Also