Przejdź do treści

Formatter YAML

Walidacja i reformatowanie YAML z jasnym wskazaniem błędów wiersza i kolumny.

Wejście
Wynik

Formatter YAML

YAML pojawia się wszędzie — od manifestów Kubernetes, przez przepływy pracy GitHub Actions, po pliki konfiguracyjne aplikacji — i jest bezlitosny wobec białych znaków: jedna źle wyrównana spacja psuje cały dokument. To narzędzie sprawdza składnię dokumentu YAML i drukuje go konsekwentnie, dzięki czemu możesz złapać uszkodzony potok lub plik konfiguracyjny zanim zostanie uruchomiony.

Wklej dokument i jest natychmiast analizowany. Prawidłowe dane wejściowe są zwracane w przeformatowanej formie z wybraną szerokością wcięcia; nieprawidłowe dane wejściowe zwracają dokładny wiersz i kolumnę problemu wraz z tym, czego parser tam się spodziewał, więc nie będziesz zgadywać, który z czterdziestu wierszy ma błądzącego tabulatora. Dwie kontrole uruchamiają się automatycznie na każdym prawidłowym dokumencie: ostrzeżenie, jeśli jakiś wiersz używa znaku tabulatora do wcięcia, ponieważ specyfikacja YAML zakazuje tabulatorów, chociaż wiele edytorów domyślnie je wstawia, i liczba zduplikowanych kluczy w tej samej mapie, co YAML pozwala, ale zwykle oznacza, że wygrywa ostatnia i pozostałe były martwym ładunkiem.

Opcje kontrolują zarówno kształt jak i białe znaki. Sortuj klucze alfabetycznie, aby uzyskać deterministyczny, porównywalny dokument — przydatne, gdy wygenerowana konfiguracja stale produkuje hałaśliwe diffy git bez przyczyny funkcjonalnej. Zwinięcie krótkich list zmienia sekwencję skalarną jak trzywierszową listę tagów na jeden wiersz w stylu przepływu, taki jak tags: [a, b, c]; pozostaw go wyłączony, a wszelkie wbudowane listy przepływu na wejściu zostaną rozwinięte z powrotem do jednego elementu na wiersz, co jest zwykle łatwiejsze do przeglądu i scalenia. Usuń komentarze usuwa zarówno komentarze pełnowierszowe, jak i końcowe hash-komentarze w wersji przeznaczonej do minifikacji lub udostępniania bez notatek, podczas gdy ich pozostawienie wyłączonym zachowuje komentarze dokumentu dokładnie tak, jak są napisane.

Formatowanie odbywa się całkowicie w Twojej przeglądarce. YAML, który wkleisz, nigdy nie jest przesyłany, logowany ani wysyłany nigdzie — jest analizowany, reformatowany i wyświetlany lokalnie, a znika w momencie zamknięcia lub przeładowania strony.

Częste pytania

Czy mój YAML jest gdzieś przesyłany?
Nie. Analiza i formatowanie odbywają się całkowicie w silniku JavaScript Twojej przeglądarki. Nic, co wkleiasz, nie jest wysyłane na serwer, nie jest rejestrowane ani przechowywane poza Twoim urządzeniem.
Co oznacza wiersz i kolumna w błędzie?
Wskazują na dokładne miejsce w dokumencie, w którym parser przestał rozumieć, licząc od góry i lewej strony wklejonego tekstu. Wskazuje również, czego oczekiwał, na przykład konsystentne wcięcie lub wartość po dwukropku.
Dlaczego ostrzega przed tabulatorami?
Specyfikacja YAML zakazuje używania znaków tabulatora do wcięcia — dozwolone są tylko spacje. Dokument ze wcięciem tabulatora może być analizowany niespójnie lub całkowicie nie powieść się w innej implementacji YAML, dlatego narzędzie to flaguje, nawet jeśli Twoje dane wejściowe tutaj się analizują.
Co się dzieje ze zduplikowanymi kluczami?
YAML pozwala powtarzać klucz w tej samej mapie, a większość parserów po cichu zachowuje tylko ostatnią wartość. Narzędzie tego nie odrzuca, ale liczy duplikaty i oznacza dotknięty wiersz, abyś mógł zdecydować, czy było to zamierzone.
Czy może naprawić dla mnie nieprawidłowy YAML?
Nie — informuje dokładnie, gdzie analiza się nie powiodła, abyś mógł naprawić źródło. Automatyczne zgadywanie poprawy uszkodzonego wcięcia ryzykowałoby zmianę znaczenia dokumentu.