TOML na JSON

Jak mapują się typy

Wyjście jest zawsze formatowane z wcięciem na 4 spacje, więc tablice i obiekty zajmują kilka linii; powyższa tabela pokazuje wartości w jednej linii dla czytelności. Kolejność kluczy jest zachowywana dokładnie tak, jak występuje w Twoim TOML.

Pełny przykład

title = "My App"

[server]
host = "localhost"
port = 8080

[[users]]
name = "alice"
admin = true

konwertuje się na:

{
    "title": "My App",
    "server": {
        "host": "localhost",
        "port": 8080
    },
    "users": [
        {
            "name": "alice",
            "admin": true
        }
    ]
}

Obsługiwany TOML i prawdziwe ograniczenia

Obsługiwane: nagłówki [tabel] wraz z kropkowanymi nazwami sekcji, [[tablice tabel]], pary klucz = wartość w jednej linii, łańcuchy basic "..." z sekwencjami \n, \t i \", łańcuchy literal '...', proste dziesiętne liczby całkowite i zmiennoprzecinkowe, true/false, jednolinijkowe tablice (zagnieżdżanie dozwolone), komentarze # na całą linię oraz daty przekazywane jako łańcuchy.

Nieobsługiwane, wraz z tym, co zrobić zamiast tego:

• Łańcuchy wielolinijkowe (""" lub ''') i wielolinijkowe tablice zatrzymują parser błędem. Najpierw zapisz wartość w jednej linii.
• Tabele inline nie są rozwijane: point = { x = 1, y = 2 } wychodzi jako łańcuch "{ x = 1, y = 2 }", a nie obiekt. Przepisz ją jako osobną sekcję [point]. Linie zależności w Cargo.toml, jak serde = { version = "1.0" }, to klasyczny przypadek.
• Klucze z kropkami po lewej stronie znaku równości pozostają jednym płaskim kluczem: server.host = "a" daje klucz "server.host", bez zagnieżdżenia. Użyj zamiast tego nagłówka [server]. Kropkowane [nazwy.sekcji] w nagłówkach zagnieżdżają się natomiast poprawnie.
• Komentarze za wartością nie są usuwane: port = 8080 # main staje się łańcuchem "8080 # main". Trzymaj komentarze w osobnych liniach.
• Formaty liczb wykraczające poza proste dziesiętne nie są rozpoznawane: 1_000, 0xFF, 5e2, +99, inf i nan wychodzą jako łańcuchy w cudzysłowach. Zapisz 1000, 255, 500, 99.
• Sekwencje \uXXXX w łańcuchach basic nie są dekodowane. Wklej zamiast nich prawdziwy znak.

Dla pełnego dokumentu TOML 1.0 użyj konwertera z wiersza poleceń, np. toml2json, albo wczytaj plik tomllib z Pythona i stamtąd zrzuć JSON.

Gdzie się to przydaje

• Szybki podgląd fragmentu TOML jako JSON podczas debugowania.
• Przekazanie prostych wartości konfiguracji linterom, skryptom lub narzędziom inwentaryzacyjnym, które przyjmują tylko JSON.
• Generowanie JSON-owych fixture do testów z notatek TOML, które łatwiej pisać ręcznie.
• Migracja małych, płaskich plików konfiguracji, jakimi jest wiele config.toml Hugo.

Uwagi o podróży w obie strony

• Komentarze nigdy nie przeżywają: JSON w ogóle nie ma składni komentarzy.
• Daty pozostają łańcuchami; dalszy kod musi je z powrotem sparsować na obiekty dat.
• Duże liczby: liczby całkowite pozostają w tekście JSON wartościami 64-bitowymi, ale konsumenci w JavaScripcie tracą precyzję powyżej 2^53. Uważaj na nanosekundowe znaczniki czasu i numeryczne identyfikatory.
• Kolejność kluczy jest w tym konwerterze zachowywana jak w oryginale; inne narzędzia JSON mogą przesortować klucze przy ponownym zapisie dokumentu.

Kierunek odwrotny

JSON → TOML to trudniejsza podróż, bo JSON ma struktury (głębokie anonimowe zagnieżdżenie, null), których TOML nie ma albo obsługuje inaczej. Większość scenariuszy w obie strony wymaga ręcznych poprawek po stronie TOML.