Formatter YAML
Sprawdzaj poprawność i porządkuj YAML za pomocą tego formattera YAML. Wklej konfigurację, manifesty Kubernetes, potoki CI lub metadane na początku pliku, a narzędzie przeanalizuje dokument, wykryje błędy składni i ujednolici odstępy po dwukropkach i myślnikach list oraz wewnątrz kolekcji przepływowych, takich jak [a, b] i { x: 1 }. Wcięcia, komentarze, cudzysłowy i skalary blokowe pozostaną bez zmian, dzięki czemu inżynierowie DevOps i deweloperzy bezpiecznie uzyskają czytelniejsze pliki.
Najczęściej zadawane pytania
Co zmienia formatter YAML?
Ujednolica odstępy: jedna spacja po dwukropku mapowania, jedna spacja po myślniku listy, spacja po przecinkach w sekwencjach przepływowych oraz spacje wewnątrz nawiasów klamrowych mapowań przepływowych. Wielokrotne spacje przed komentarzem są redukowane do jednej.
Czy zmienia wcięcia w moim YAML?
Nie, zachowuje wpisane wcięcia, ponieważ w YAML określają one strukturę. Zagnieżdżony blok z wcięciem wynoszącym cztery spacje pozostaje z wcięciem czterech spacji.
Czy narzędzie sprawdza poprawność dokumentu?
Tak, dokument jest najpierw analizowany, a błędy są zgłaszane wraz z komunikatem i numerem wiersza, na przykład gdy po dwukropku w mapowaniu przepływowym nie ma spacji. Popraw wskazany wiersz i ponownie sformatuj dokument.
Czy komentarze są zachowywane?
Tak, komentarze w osobnych wierszach i komentarze na końcu wiersza są zachowywane. Między wartością a znakiem # w komentarzu na końcu wiersza pozostaje jedna spacja.
Co się dzieje ze skalarami blokowymi?
Skalary blokowe dosłowne i składane, wprowadzane za pomocą | lub >, są kopiowane dokładnie, włącznie z odstępami wewnątrz ich wierszy. Każdy wiersz wcięty głębiej niż klucz należy do skalara i pozostaje bez zmian.
Czy ciągi znaków ujęte w cudzysłowy są zmieniane?
Nie, ciągi znaków ujęte w apostrofy lub cudzysłowy oraz zawarte w nich spacje są zachowywane. Cudzysłowy nigdy nie są dodawane ani usuwane, więc wartości zachowują swój typ.
Czy zakończenia wierszy są zmieniane?
Tak, zakończenia wierszy Windows CRLF i używane dawniej na komputerach Mac CR są zamieniane na LF. Parsery YAML traktują je tak samo, więc dane się nie zmieniają.
Czy narzędzie może formatować kilka dokumentów w jednym pliku?
Nie, dane wejściowe zawierające kilka dokumentów rozdzielonych przez --- są odrzucane z komunikatem „Obsługa wielu dokumentów nie jest dostępna”. Sformatuj każdy dokument osobno, a następnie połącz je ponownie.
Dlaczego wynik jest ujęty w blok kodu yaml?
Wynik jest zwracany jako blok kodu Markdown oznaczony jako yaml, więc jest wyświetlany z podświetlaniem składni w Markdown. Skopiuj wiersze między znacznikami bloku do pliku .yaml lub .yml.
Jak duży może być mój plik?
Do 5 MB na jedno uruchomienie; większe dane wejściowe są odrzucane z komunikatem. Puste dane wejściowe zwracają pusty wynik, a wynik jest zgodny z opcją YAML w narzędziu Code Formatter.