Loading…

O nas Online Formatowarka TOML

Bałagan w konfiguracjach `pyproject.toml`, `Cargo.toml` lub `poetry`? Wklej swój TOML lub upuść plik, a nasza formatowarka znormalizuje białe znaki, uporządkuje tablice i tabele wbudowane oraz zapewni spójne odstępy między sekcjami. Idealne dla Pythona, Rusta, Go, generatorów stron statycznych i każdego projektu korzystającego z TOML do konfiguracji.

Kluczowe Funkcje Formatowarki TOML

  • **Jednoklikowy upiększacza** dla plików konfiguracyjnych i fragmentów TOML
  • **Konfigurowalny rozmiar wcięcia** od 1 do 8 spacji za pomocą suwaka *Rozmiar Wcięcia*
  • **Przełącznik stylu wcięcia** – wybierz między spacjami a tabulatorami do wcięć
  • **Kontrola zawijania / Długości Linii** aby utrzymać długie tablice i tabele w linii w wybranej szerokości kolumny
  • Obsługuje pliki `.toml` takie jak `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` i inne
  • Parser TOML oparty na Prettier, który rozumie daty, tablice, zagnieżdżone tabele i tabele w linii
  • Stabilne, idempotentne formatowanie – ponowne uruchomienie na tym samym pliku nie spowoduje dryfu formatowania
  • Jednoklikowe kopiowanie sformatowanego wyniku, gotowe do edytora lub commita

🛠️ Jak Sformatować Pliki TOML Online for toml-formatter

1

1. Wklej lub Prześlij Swój TOML

📥 Wklej TOML do edytora lub przeciągnij i upuść plik `.toml` taki jak `pyproject.toml` lub `Cargo.toml`. Narzędzie parsuje zawartość jako TOML, a nie ogólny INI/JSON.

2

2. Wybierz Ustawienia Wcięć i Zawijania

⚙️ Użyj suwaka **Rozmiar Wcięcia** aby wybrać liczbę spacji na poziom wcięcia i przełącz **Styl Wcięcia** na tabulatory jeśli twój projekt je preferuje. Dostosuj **Zawijanie / Długość Linii** aby kontrolować, kiedy długie tablice lub tabele w linii powinny się zawijać (lub ustaw na `0` aby skutecznie wyłączyć zawijanie).

3

3. Kliknij „Formatuj”

🚀 Naciśnij przycisk **Formatuj**. Formatowarka przeorganizuje tablice, wyczyści odstępy wokół `=` i przecinków, znormalizuje odstępy tabel i wymusi spójne łamanie linii zachowując twoje dane.

4

4. Przejrzyj, Skopiuj lub Zapisz

🔍 Porównaj oryginalny i sformatowany TOML. Kiedy jesteś zadowolony, skopiuj wynik z powrotem do edytora lub zapisz jako nowy plik `.toml` w twoim projekcie.

Specyfikacje Techniczne

Obsługiwane Funkcje TOML

Formatowarka jest zbudowana dla rzeczywistych konfiguracji projektów i rozumie nowoczesne konstrukcje TOML.

FunkcjaObsługaPrzykłady / Uwagi
Tabele i podtabele✅ Pełna[tool.poetry], [project], [database.replica]
Tablice✅ PełnaTablice w linii i tablice tabel
Tabele w linii✅ Pełneserwery = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Daty i czasy✅ Pełne2025-09-23T10:20:30Z i lokalne formaty dat
Komentarze✅ Zachowane# komentarze pozostają blisko opisywanych ustawień
Łańcuchy wieloliniowe✅ PełnePotrójnie cytowane łańcuchy TOML dla długich bloków tekstu

Opcje Formatowania (Mapowane na Kontrolki Narzędzia)

Te opcje są bezpośrednio dostępne w interfejsie użytkownika i podłączone do podstawowej wtyczki Prettier TOML:

OpcjaKontrolka UIZakres / WartościDomyślne
Rozmiar wcięciaSuwak Rozmiaru Wcięcia1–8 spacji2 spacje
Styl wcięciaWybór Stylu WcięciaSpacje / TabulacjeSpacje
Długość liniiZawijanie / Długość Linii0–120 kolumn (0 = praktycznie bez zawijania)80 kolumn
Koniec liniiKoniec linii (wewnętrznie)LF / CRLFLF w wyjściu przeglądarki

Wejście i Ograniczenia

Narzędzie jest zoptymalizowane dla małych i średnich plików TOML, powszechnie spotykanych w repozytoriach aplikacji.

ParametrWartość / ZachowanieUwagi
Rozszerzenia plików.tomlDowolny plik konfiguracyjny oparty na TOML
Typy MIMEapplication/toml, text/x-tomlUżywane do wykrywania plików w strefie upuszczania
Maksymalny rozmiar pliku~5 MBWiększe pliki mogą działać wolniej i lepiej jest je obsługiwać w CI
Maksymalna liczba znaków≈ 2 000 000Twardy limit w środowisku uruchomieniowym formatowania, aby uniknąć zawieszania przeglądarki

Walidacja i Obsługa Błędów

Jeśli twój plik nie jest poprawnym TOML (np. brakuje `=` lub niezgodne cudzysłowy), formatowanie zwykle zwróci czytelny błąd zamiast sformatowanego wyniku. Popraw wskazaną linię i uruchom formatowanie ponownie.

Alternatywy Wiersza Poleceń dla Formatowania TOML

Podoba ci się wynik i chcesz ten sam styl w CI lub hakach pre-commit? Oto opcje przyjazne dla CLI:

Wieloplatformowe (Node.js / Prettier)

Zainstaluj Prettier i wtyczkę TOML

npm install --save-dev prettier prettier-plugin-toml

Dodaje Prettier i parser TOML do twojego projektu.

Sformatuj plik TOML za pomocą Prettier

npx prettier --parser toml --write pyproject.toml

Przepisuje `pyproject.toml` na miejscu, używając reguł TOML Prettier.

Linux / macOS / Windows (Taplo CLI)

Sformatuj TOML za pomocą Taplo

taplo fmt pyproject.toml

Kolejny popularny formatter CLI dla plików TOML.

Sprawdź formatowanie w CI

taplo fmt --check .

Przerwij budowę, jeśli pliki TOML nie są poprawnie sformatowane.

Użyj tego narzędzia online do szybkich edycji i eksperymentów, a następnie wymuś ten sam styl za pomocą Prettier lub Taplo w swoich potokach CI.

Typowe Zastosowania Formattera TOML

Pakowanie Pythona (`pyproject.toml`)

Utrzymuj metadane projektu Python i konfigurację narzędzi w czystości i łatwe do przeglądania.

  • Wyrównaj sekcje `[project]`, `[tool.poetry]` i `[tool.black]`.
  • Normalizuj tablice zależności i specyfikatory wersji.
  • Ułatw czytanie różnic w konfiguracji w pull requestach.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Projekty Rusta (`Cargo.toml`)

Uporządkuj manifesty pakietów Rusta w obszarach roboczych i mikrousługach.

  • Utrzymuj sekcje `[dependencies]` i `[dev-dependencies]` posortowane i konsekwentnie rozmieszczone.
  • Normalizuj tabele wbudowane używane dla złożonych flag funkcji.
  • Ujednolicaj formatowanie w wielu skrzyniach w obszarze roboczym.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

Strony Statyczne i Narzędzia (Hugo, Zola itp.)

Czyści TOML używany dla generatorów stron statycznych i różnych narzędzi.

  • Formatuj `config.toml` dla Hugo lub innych generatorów stron statycznych.
  • Utrzymuj bloki konfiguracji wielojęzycznej czytelne.
  • Normalizuj długie listy, takie jak wpisy menu i taksonomie.

❓ Frequently Asked Questions

❓Czym jest formatowacz TOML?

Formatowacz TOML automatycznie przekształca Twoje pliki TOML, aby stosowały się do spójnego stylu: poprawia wcięcia, wyrównuje tablice i tabele wbudowane, normalizuje spacje wokół `=` i przecinków, zachowując dane, jednocześnie ułatwiając ich czytanie i przeglądanie.

📏Jak wybrać rozmiar i styl wcięcia?

Jeśli Twój zespół nie ma preferencji, **2 spacje** to dobry domyślny wybór. Dopasuj styl już używany w Twoim repozytorium: jeśli pliki są głównie wcięte spacjami, kontynuuj ich używanie; jeśli tabulatory są standardem zespołu, zmień **Styl wcięcia** na Tabulatory, aby nowe zmiany były zgodne z istniejącym kodem.

🧪Czy formatowacz sprawdza składnię TOML?

Podstawowy parser odrzuci nieprawidłowy TOML (na przykład brakujące `=` lub niedopasowane cudzysłowy). W takim przypadku narzędzie wyświetla komunikat błędu zamiast sformatowanego wyniku, abyś mógł naprawić problem i spróbować ponownie.

🔁Czy uruchomienie formatowacza może zmienić działanie mojej konfiguracji?

Formatowacz jest zaprojektowany tak, aby **zachowywać semantykę**: zmienia tylko białe znaki i układ, a nie klucze, wartości czy strukturę tabel. O ile oryginalny plik jest prawidłowym TOML, znaczenie Twojej konfiguracji powinno pozostać niezmienione.

🔒Czy bezpiecznie jest formatować poufne pliki konfiguracyjne?

Jak w przypadku każdego narzędzia online, unikaj wklejania wyjątkowo wrażliwych materiałów, takich jak tajemnice produkcyjne. Dla wysoce poufnych konfiguracji używaj lokalnego formatowacza TOML (jak Prettier lub Taplo) w swoim prywatnym środowisku programistycznym.

Pro Tips

Best Practice

Przechowuj ładnie sformatowany `pyproject.toml` lub `Cargo.toml` w głównej gałęzi, a następnie wymuszaj ten sam styl w CI za pomocą Prettier lub Taplo.

Best Practice

Formatuj TOML przed zatwierdzeniem dużych zmian w zależnościach lub konfiguracji, aby Twoje różnice w Git skupiały się na **rzeczywistych zmianach**, a nie na szumie białych znaków.

Best Practice

Podczas refaktoryzacji konfiguracji, najpierw sformatuj plik, zatwierdź, a następnie zmień wartości. Ułatwia to przeglądanie tego, co naprawdę się zmieniło.

Best Practice

Używaj tej samej **wielkości wcięcia** i **długości zawijania** we wszystkich plikach TOML, aby nawigacja między projektami i przeglądy kodu były spójne.

Additional Resources

Specyfikacja TOML v1.0.0
Documentation
Wtyczka Prettier dla TOML
Documentation
Taplo – Zestaw narzędzi TOML
Documentation

Other Tools