Format pliku TOML
Czym jest plik TOML?
TOML (Tom’s Obvious Minimal Language) to minimalny format pliku konfiguracyjnego, który używa rozszerzenia .toml. TOML ma być łatwy do odczytania, jednoznacznie odwzorowywany na słowniki i łatwy do analizowania różnych struktur danych. TOML ma specyfikację open source, która otrzymała wkład społeczności. TOML jest obsługiwany przez wiele języków programowania, takich jak C, C#, Dart, Elixir, Erlang, Go, Java, PHP, Python, Ruby, Swift itp. Typ MIME dla plików TOML to application/toml.
Format pliku TOML
Pliki TOML składają się głównie z par klucz/wartość, sekcji/tabel, komentarzy i muszą być prawidłowym dokumentem Unicode zakodowanym w UTF-8. TOML obsługuje typy danych String, Integer, Float, Boolean, Datetime, Array i Table(hash table/dictionary). TOML jest językiem rozróżniającym wielkość liter.
Składnia
- Pary klucz-wartość: pary klucz-wartość są oddzielone znakiem równości (=). Każda para musi znajdować się w nowej linii.
pierwszy = „Tomek”
last = „Preston-Werner”
- Komentarze: komentarze zaczynają się od symbolu krzyżyka (#).
# To jest dokument TOML.
- Stringi: Ciągi są ujęte w cudzysłowy (").
ciąg = "Przykładowy ciąg"
- Ciągi wielowierszowe: Ciągi wielowierszowe są ujęte w trzy cudzysłowy (""").
[adres domowy]
street = """Aleja Tornado 123
Apartament 16"""
miasto = „Wschodnie centrum miasta”
stan = "KS"
- Liczby całkowite/liczby zmiennoprzecinkowe
liczba całkowita = 20
liczba zmiennoprzecinkowa = 20,5
- Booleany: Booleany są zawsze pisane małymi literami.
bool1 = prawda
bool2 = fałsz
- Data-godzina: w przypadku daty i godziny można użyć daty i godziny w formacie RFC 3339, jak pokazano w poniższym przykładzie.
offset_date_time = 1979-05-27 07:32:00Z
lokalna_data_czas = 1979-05-27T07:32:00
lokalna_data = 1979-05-27
czas_lokalny = 07:32:00
- Tablice: Tablice są ujęte w nawiasy kwadratowe z elementami oddzielonymi przecinkami (,).
kolory = [ "czerwony", "żółty", "zielony" ]
- Tabele: tabele to kolekcje par klucz/wartość, które są zdefiniowane przez nagłówki w nowym wierszu otoczone nawiasami kwadratowymi ([]). Tabela kończy się po podaniu nowego nagłówka lub po zakończeniu pliku.
[adres domowy]
street = """Aleja Tornado 123
Apartament 16"""
miasto = „Wschodnie centrum miasta”
stan = "KS"
[adres biura]
street = """Aleja Tornado 123
Apartament 16"""
miasto = „Wschodnie centrum miasta”
stan = "KS"
Tabele wbudowane są otoczone nawiasami klamrowymi ({}), a każda para klucz/wartość jest oddzielona przecinkiem (,).
imię = { pierwsze = "Tomek", ostatnie = "Pitt" }