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" }

Bibliografia

See Also