Форматувальник YAML

Як це працює

Увесь задум YAML тримається на відступах, через що його приємно читати й напрочуд легко зламати. Один зайвий пробіл породжує повідомлення про помилку від конвеєра CI за двадцять хвилин. Тут його розбирають одразу й одразу повідомляють про проблему.

Перевірка з номером рядка

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

Переформатування

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

Що вам коштує цей процес

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

Сортування ключів

Алфавітний порядок робить два файли конфігурації справді зіставними у diff. Це також неправильний вибір для файлу, де порядок має значення для людини, яка його читає, — конвеєр CI читається краще в порядку виконання, ніж за алфавітом.

Кілька документів

Файл із кількома документами, розділеними ---, обробляється, і кожен документ форматується по черзі.