YAML

Формати серіалізації даних

Серіалізація даних — це процес перетворення структурованих даних у формат, придатний для зберігання або передачі з можливістю подальшого відновлення. Різні формати по-різному балансують між зручністю читання людиною, машинним розбором, виразністю та розміром файлу.

JSON, YAML, TOML та XML — чотири домінуючі текстові формати серіалізації у розробці програмного забезпечення. Кожен має переваги, що роблять його найкращим вибором у конкретних контекстах — розуміння цих компромісів дозволяє обирати правильний формат для кожного завдання.

JSON і YAML поруч

JSON і YAML представляють одну й ту саму модель даних. YAML є суворим надмножиною JSON — будь-який коректний JSON-документ є водночас коректним YAML. Нижче наведено однакову конфігурацію, виражену в обох форматах:

{
  "server": {
    "host": "localhost",
    "port": 8080,
    "debug": true
  },
  "database": {
    "url": "postgres://localhost/mydb",
    "pool": 10
  }
}

server:
  host: localhost
  port: 8080
  debug: true
database:
  url: postgres://localhost/mydb
  pool: 10

YAML використовує відступи замість фігурних дужок і квадратних дужок та опускає лапки у більшості рядкових значень. Це робить його компактнішим і зручнішим для читання у файлах, що редагуються людиною, але вносить чутливість до відступів.

Порівняння форматів

Підводні камені YAML

YAML є потужним, але має добре відомі граничні випадки, які несподівано ловлять розробників. Ось найпоширеніші з них:

Унікальні можливості YAML

Коментарі

YAML підтримує коментарі за допомогою символу #. Це одна з найбільших практичних переваг над JSON для конфіг-файлів — ви можете документувати налаштування прямо в рядку. Коментарі можуть розташовуватися на окремому рядку або після значення.

Якорі та псевдоніми

YAML дозволяє визначити вузол один раз за допомогою &ім'я-якоря та повторно використовувати його будь-де за допомогою *ім'я-якоря. Це усуває повторення у складних конфігураціях. Kubernetes та Docker Compose активно використовують якорі для спільних визначень сервісів.

Багаторядкові рядки

YAML підтримує блокові скалярні значення у двох режимах: літеральний блок (|) зберігає переноси рядків точно так, як написано, — корисно для скриптів і шаблонів. Складений блок (>) об'єднує довгі рядки в один, — корисно для довгих текстових описів.

Коли потрібна конвертація

Часті запитання