Formater TOML
Formatuj pliki konfiguracyjne TOML, takie jak Cargo.toml, pyproject.toml i inne ustawienia aplikacji za pomocą wtyczki Prettier TOML. Formater ujednolica odstępy wokół znaków równości, tabel inline i tablic, oddziela tabele pustym wierszem, zachowuje wszystkie komentarze i zgłasza błędy składni, podając wiersz i kolumnę, dzięki czemu programiści mogą bezpiecznie uporządkować konfigurację przed jej zatwierdzeniem.
Najczęściej zadawane pytania
Jaki silnik formatuje TOML?
Narzędzie używa Prettier 3 z prettier-plugin-toml 4.1 na serwerze. Odczytuje dokumenty TOML 1.0 i drukuje je w jednym spójnym stylu.
Co zmienia się w wyniku?
Wokół znaku równości między kluczami a wartościami pojawia się jedna spacja, a tablice inline i zwykłe tablice mają równomierne odstępy. Nadmiarowe puste wiersze są usuwane, a każdy nagłówek tabeli oddziela od poprzedniej sekcji pusty wiersz.
Czy komentarze są zachowywane?
Tak. Komentarze w osobnych wierszach i komentarze na końcu wiersza po wartościach pozostają na swoim miejscu, dzięki czemu opisane pliki konfiguracyjne zachowują swoje notatki.
Czy klucze lub tabele będą sortowane?
Nie. Klucze, tabele i tablice tabel zachowują pierwotną kolejność, co ma znaczenie w plikach czytanych od góry do dołu.
Czy cudzysłowy w ciągach znaków mogą się zmienić?
Ciągi znaków w apostrofach mogą zostać zapisane w cudzysłowach, jeśli ich wartość nie zawiera ukośnika odwrotnego ani cudzysłowu, więc sama wartość pozostaje bez zmian. Ciągi wymagające dosłownego cytowania zachowują apostrofy.
Jak obsługiwane są długie tablice?
Tablice mieszczące się w szerokości wydruku pozostają w jednym wierszu. Tablice z przecinkiem na końcu lub przekraczające tę szerokość są drukowane po jednym elemencie w wierszu.
Co się dzieje w przypadku nieprawidłowego TOML?
Formatowanie zostaje przerwane, a narzędzie wyświetla komunikat parsera z wierszem i kolumną, na przykład informację o braku wartości po znaku równości. Zduplikowane klucze i inne nieprawidłowe TOML są zgłaszane w ten sam sposób.
Czy mogę zmienić wcięcia?
Tak. Wybierz 2 lub 4 spacje albo tabulatory dla zagnieżdżonych tablic oraz szerokość wydruku od 40 do 200 znaków; domyślnie wynosi ona 80.
Jaki może być rozmiar pliku?
Do 1 MB tekstu na żądanie, czyli znacznie więcej niż w typowych plikach konfiguracyjnych. Formatowanie kończy się po 10 sekundach.
Czy moja konfiguracja jest przechowywana?
Nie. Pliki konfiguracyjne mogą zawierać sekrety, dlatego ich treść jest przetwarzana wyłącznie w pamięci i nigdy nie jest zapisywana ani rejestrowana.