Форматирование YAML
Вставьте YAML. Получите его в аккуратном виде или узнайте, в какой именно строке ошибка.
- Работает в вашем браузере — текст никуда не отправляется
- Без регистрации и квот, пользуйтесь бесплатно сколько угодно
Как это работает
Весь замысел YAML строится на отступах, из-за чего его приятно читать и необычайно легко сломать. Один лишний пробел — и через двадцать минут вы получаете сообщение об ошибке из конвейера CI. Здесь он разбирается сразу, и вы узнаёте о проблеме немедленно.
Проверка с номером строки
Если документ не разбирается, вы получаете строку и столбец, где произошёл сбой, и причину от самого парсера. Это почти всегда полезнее отформатированного результата, и именно за этим большинство людей открывает такой инструмент.
Переформатирование
Корректный YAML разбирается в структуру данных и записывается заново с нуля, поэтому отступы становятся единообразными, кавычки нормализуются, а лишние пробелы в конце строк исчезают. Поскольку результат проходит через данные, а не правится как текст, он гарантированно корректен.
Чем приходится платить за прохождение через данные
Комментарии теряются. Они не входят в данные, поэтому парсер их отбрасывает. Якоря и алиасы заменяются полными значениями, а не сохраняются. Если комментарии в файле важны, форматируйте копию и вносите исправления отступов вручную.
Сортировка ключей
Алфавитный порядок делает два файла конфигурации по-настоящему сравнимыми в diff. Но он же — неверный выбор для файла, где порядок несёт смысл для читателя: конвейер CI читается лучше в порядке выполнения, чем по алфавиту.
Несколько документов
Файл с несколькими документами, разделёнными ---, обрабатывается, и каждый форматируется по очереди.
Форматирование YAML: вопросы и ответы
Почему пропали мои комментарии?
При форматировании YAML разбирается в данные и записывается заново, а комментарии не являются частью данных. Если комментарии нужно сохранить, форматируйте копию.
Показывает ли он, где ошибка?
Да, с номером строки и столбца и собственным объяснением парсера.
Загружается ли мой YAML на сервер?
Нет. Он разбирается в браузере, а это важно, учитывая, как часто в YAML хранятся секреты и детали инфраструктуры.
Обрабатывает ли он несколько документов в одном файле?
Да, документы, разделённые строкой ---, форматируются по отдельности.
Стоит ли сортировать ключи?
Полезно для сравнения двух файлов конфигурации. Бесполезно, когда порядок важен для читателя.