Formater YAML

Jak to działa

Cały projekt YAML opiera się na wcięciach, co sprawia, że jest przyjemny w czytaniu i niezwykle łatwy do zepsucia. Jedna zabłąkana spacja daje komunikat błędu z potoku CI dwadzieścia minut później. To narzędzie analizuje go tutaj i mówi ci od razu.

Walidacja z numerem wiersza

Jeśli dokument się nie przetwarza, dostajesz wiersz i kolumnę, w których to się nie udało, oraz powód podany przez parser. To prawie zawsze przydatniejsze niż sformatowany wynik i to właśnie dlatego większość ludzi otwiera takie narzędzie.

Ponowne formatowanie

Poprawny YAML jest przetwarzany na strukturę danych i zapisywany od nowa, więc wcięcia stają się jednolite, cudzysłowy są ujednolicone, a zbłąkane końcowe białe znaki znikają. Ponieważ przechodzi to przez dane, a nie jest edycją tekstu, wynik jest gwarantowanie poprawny.

Co kosztuje cię przejście przez dane

Komentarze są tracone. Nie są częścią danych, więc parser je odrzuca. Kotwice i aliasy są rozwijane do pełnych wartości, a nie zachowywane. Jeśli komentarze w twoim pliku mają znaczenie, sformatuj kopię i wprowadź poprawki wcięć ręcznie.

Sortowanie kluczy

Porządek alfabetyczny sprawia, że dwa pliki konfiguracyjne naprawdę da się porównać w diffie. Jest też złym wyborem dla pliku, w którym kolejność niesie znaczenie dla człowieka — potok CI czyta się lepiej w kolejności wykonywania niż alfabetycznie.

Wiele dokumentów

Plik zawierający kilka dokumentów oddzielonych przez --- jest obsługiwany, a każdy z nich jest formatowany po kolei.