Що таке файл TOML?

TOML (Tom’s Obvious Minimal Language) — мінімальний формат файлу конфігурації, який використовує розширення .toml. TOML прагне бути легким для читання, однозначно відображати словники та легко аналізувати різні структури даних. TOML має специфікацію з відкритим кодом, яка отримала внески спільноти. TOML підтримується багатьма мовами програмування, такими як C, C#, Dart, Elixir, Erlang, Go, Java, PHP, Python, Ruby, Swift тощо. Тип MIME для файлів TOML — application/toml.

Формат файлу TOML

Файли TOML в основному складаються з пар ключ/значення, розділів/таблиць, коментарів і мають бути дійсним документом Юнікод із кодуванням UTF-8. TOML підтримує типи даних String, Integer, Float, Boolean, Datetime, Array і Table (хеш-таблиця/словник). TOML — це мова з урахуванням регістру.

Синтаксис

  • Пари ключ-значення: пари ключ-значення розділені знаком рівності (=). Кожна пара повинна бути на новому рядку.
перший = "Том"
last = "Престон-Вернер"
  • Коментарі: коментарі починаються з символу решетки (#).
# Це документ TOML.
  • Рядки: рядки оточені лапками (").
string = "Приклад рядка"
  • Багаторядкові рядки: багаторядкові рядки оточені трьома лапками (""").
[Домашня адреса]
вулиця = """123 Торнадо алея
Люкс 16"""
city = "East Centerville"
стан = "KS"
  • Цілі числа/плаваючі числа
ціле число = 20
float = 20,5
  • Логічні значення: логічні значення завжди пишуться малими літерами.
bool1 = правда
bool2 = false
  • Дата-Час: для DateTime ви можете використовувати дату-час у форматі RFC 3339, як показано в прикладі нижче.
дата_зміщення_час = 1979-05-27 07:32:00Z
місцева_дата_час = 1979-05-27T07:32:00
локальна_дата = 1979-05-27
місцевий_час = 07:32:00
  • Масиви: масиви оточені квадратними дужками з елементами, розділеними комами (,).
кольори = [ "червоний", "жовтий", "зелений" ]
  • Таблиці: таблиці — це набори пар ключ/значення, які визначаються заголовками в новому рядку в квадратних дужках ([]). Таблиця закінчується, коли надається новий заголовок або коли закінчується файл.
[Домашня адреса]
вулиця = """123 Торнадо алея
Люкс 16"""
city = "East Centerville"
стан = "KS"

[адреса офісу]
вулиця = """123 Торнадо алея
Люкс 16"""
city = "East Centerville"
стан = "KS"

Вбудовані таблиці оточені фігурними дужками ({}), причому кожна пара ключ/значення відокремлена комою (,).

name = { first = "Tom", last = "Pitt" }

Посилання

– TOML – Вікіпедія

See Also