Darmowy konwerter online TOML do INI

Format źródłowy: TOML

TOML oznacza Tom’s Obvious, Minimal Language. Jest to czytelny dla człowieka format konfiguracji zaprojektowany tak, aby było go łatwo pisać i łatwo analizować. TOML jest powszechnie używany przez programistów do ustawień aplikacji, metadanych projektu oraz plików konfiguracyjnych budowania, szczególnie w nowoczesnych ekosystemach oprogramowania, takich jak Rust, narzędzia dla Pythona i inne projekty ukierunkowane na deweloperów.

TOML obsługuje zagnieżdżone tabele, tablice, daty, wartości logiczne, liczby oraz ciągi znaków. Jest ceniony za przejrzystość i ograniczanie niejednoznaczności w porównaniu ze starszymi formatami konfiguracji.

Format docelowy: INI

INI to prosty format pliku konfiguracyjnego, który wykorzystuje sekcje, pary klucz-wartość oraz komentarze. Jest używany od dziesięcioleci w aplikacjach Windows, oprogramowaniu desktopowym i wielu narzędziach działających na wielu platformach. Pliki INI są łatwe do odczytu i ręcznej edycji, co sprawia, że są przydatne do podstawowych ustawień aplikacji oraz do zgodności ze starszymi rozwiązaniami.

Główną zaletą INI jest jego prostota i szerokie wsparcie. Jednak jest mniej wyraziste niż TOML: ma ograniczone wsparcie dla typów danych, nie ma standardowej zagnieżdżonej struktury i niekonsekwentnie obsługuje to samo zachowanie w różnych parserach.

Jak wykonać konwersję

Nie ma idealnej konwersji jeden-do-jednego z TOML na INI, ponieważ TOML potrafi reprezentować bogatsze struktury danych niż INI. Najlepszym podejściem jest spłaszczenie struktury TOML do sekcji INI oraz prostych par klucz-wartość.

1. Przejrzyj plik TOML i zidentyfikuj tabele najwyższego poziomu, tabele zagnieżdżone, tablice oraz wartości inne niż ciągi znaków.
2. Ustal strategię spłaszczania. Zwykle każda tabela TOML staje się sekcją INI, a tabele zagnieżdżone są reprezentowane za pomocą nazw sekcji z kropkami lub połączonych nazw.
3. Konwertuj proste wartości, takie jak ciągi znaków, liczby całkowite, wartości logiczne i liczby zmiennoprzecinkowe, do par klucz-wartość w INI.
4. Ostrożnie obsługuj tablice. INI nie ma uniwersalnej składni tablic, więc tablice mogą wymagać połączenia w ciągi rozdzielone przecinkami albo wielokrotnego użycia kluczy — zależnie od docelowej aplikacji.
5. Przejrzyj funkcje TOML, których nie da się obsłużyć, takie jak tabele wbudowane, wielowierszowe ciągi znaków, daty oraz głęboko zagnieżdżone struktury, a następnie uprość je pod kątem zgodności z INI.
6. Zweryfikuj wynik, otwierając plik INI w docelowej aplikacji lub testując go za pomocą parsera INI.

Jeśli chcesz szybko przekonwertować w przeglądarce, możesz bezpłatnie przekonwertować plik na 101convert.com, bez instalowania żadnego oprogramowania.

Do konwersji ręcznej często wystarczy edytor tekstu taki jak Visual Studio Code, Notepad++ lub Sublime Text dla małych plików. Dla większych lub powtarzalnych konwersji lepsze jest podejście skryptowe. Na przykład możesz użyć Python z parserem TOML i napisać własną logikę, aby generować składnię INI.

Przykładowe mapowanie:

[database]
host = "localhost"
port = 5432

mogłoby stać się:

[database]
host=localhost
port=5432

Jakość, zgodność i ograniczenia

Największym ograniczeniem w tej konwersji jest to, że INI nie potrafi w pełni zachować struktury TOML ani typów danych. Tablice TOML, tabele zagnieżdżone i wartości typowane często trzeba uprościć, co może prowadzić do utraty informacji. Jeśli plik INI ma być używany przez konkretną aplikację, postępuj zgodnie z oczekiwanymi przez nią konwencjami INI, ponieważ nazewnictwo sekcji, powtarzane klucze i formatowanie wartości mogą się różnić.

Dla najlepszych rezultatów, gdy to możliwe, trzymaj plik TOML jako źródło nadrzędne i generuj INI tylko dla zgodności z oprogramowaniem, które tego wymaga. Jeśli konfiguracja jest złożona, rozważ, czy docelowa aplikacja może przyjmować TOML bezpośrednio zamiast konwertować.