Конвертувати між JSON та YAML

Цей інструмент перетворює документ YAML у JSON і навпаки, зберігаючи структуру даних (об'єкти, масиви, скалярні типи). Конвертація JSON у YAML або YAML у JSON є поширеною операцією в розробці: генеруємо файл OpenAPI YAML з JSON-специфікації, конвертуємо вивід REST API у YAML для комміту в репозиторій конфігурацій, перекладаємо маніфест Kubernetes YAML у JSON для передачі в kubectl --dry-run=client -o json або узгоджуємо workflow GitHub Actions зі схемою JSON. Загалом, це міст між світом обміну даними (JSON) і світом конфігурацій, що редагуються вручну (YAML).

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

JSON є незамінним, коли одна програма спілкується з іншою. Типові випадки використання:

• REST і GraphQL API: payload запиту та відповіді.
• Обмін даними між мікросервісами та чергами повідомлень.
• Нативний JavaScript: JSON.parse і JSON.stringify без залежностей.
• Зберігання в браузері: localStorage, sessionStorage, IndexedDB.
• AJAX-запити та fetch.
• Бінарні або потокові варіанти: BSON (MongoDB), JSON Lines (логи, ML-датасети), MessagePack.
• Конфігурація JS/TS інструментів: package.json, tsconfig.json, composer.json.

YAML є незамінним, коли людина регулярно редагує файл. Типові випадки використання:

• Docker Compose (docker-compose.yml) і профілі стека.
• Маніфести Kubernetes (Deployment, Service, Ingress, Helm charts).
• Playbook Ansible та інвентарі.
• CI/CD пайплайни: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Специфікації OpenAPI/Swagger та AsyncAPI.
• Анотована конфігурація застосунків (Symfony, Spring Boot, Rails), де коментарі корисні.
• Файли, що часто редагуються вручну, де лаконічність і читабельність важливіші за швидкість парсингу.

YAML є більш дозвільним, ніж JSON, що робить його потужним, але підступним форматом. Найпоширеніші пастки:

• Відступи: табуляція заборонена специфікацією, допустимі лише пробіли. Змішування або зміна кількості пробілів в одному блоці зламує парсинг.
• Автоматичне приведення скалярів: yes, no, on, off, true, false, null, None, ~ парсяться як булеві або null. Пастка: поштовий індекс 01234 без лапок стає цілим 1234, а назва країни NO (Норвегія) стає false. Завжди беріть у лапки неоднозначні рядки.
• Багаторядкові рядки: | (block literal) зберігає переноси рядків як є, тоді як > (folded) замінює переноси пробілами. Індикатори chomping - і + налаштовують поведінку кінцевого переносу.
• YAML 1.1 проти 1.2: версія 1.1 (ще дуже поширена, наприклад PyYAML за замовчуванням) трактує yes/no/on/off як булеві, що було прибрано у версії 1.2. Поведінка також відрізняється для чисел у базі 8.
• Неявні дати: 2024-01-15 без лапок інтерпретується деякими парсерами як об'єкт дати, а не рядок.

Той самий документ, виражений спочатку у JSON, потім у YAML. Проста конфігурація застосунку з залежностями та середовищем:

Версія JSON

{
"name": "cdrn-app",
"version": "1.14.2",
"environment": "production",
"dependencies": {
    "php": "^8.3",
    "symfony/framework-bundle": "^7.0",
    "doctrine/orm": "^3.0"
},
"features": ["cache", "mailer", "queue"],
"debug": false
}

Еквівалентна версія YAML

# Конфігурація застосунку
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

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

Кроки для конвертації даних:

1. Вставте вихідний документ (JSON або YAML) у поле введення.
2. Виберіть потрібний напрямок конвертації (JSON у YAML або YAML у JSON).
3. Натисніть кнопку конвертації: відформатований результат з'явиться у полі виводу.
4. Перевірте результат, а потім скористайтеся кнопкою копіювання, щоб отримати результат у буфер обміну.

Конвертація виконується локально у браузері або через виділений серверний маршрут залежно від інструменту: жодні конфіденційні дані не зберігаються.