TOML naar JSON

Zo worden de types omgezet

De uitvoer wordt altijd opgemaakt met 4 spaties inspringing, dus arrays en objecten beslaan meerdere regels; de tabel hierboven toont de waarden op een regel voor de leesbaarheid. De volgorde van de keys blijft exact zoals in je TOML.

Uitgewerkt voorbeeld

title = "My App"

[server]
host = "localhost"
port = 8080

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

wordt:

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

Ondersteunde TOML en de echte beperkingen

Ondersteund: [tabel]-headers inclusief sectienamen met punten, [[arrays van tabellen]], key = value-paren op een regel, basic strings "..." met de escapes \n, \t en \", literal strings '...', gewone decimale gehele en kommagetallen, true/false, arrays op een regel (nesten mag), commentaarregels met #, en datums die als strings doorgegeven worden.

Niet ondersteund, en wat je in plaats daarvan doet:

• Meerregelige strings (""" of ''') en meerregelige arrays stoppen de parser met een foutmelding. Zet de waarde eerst op een regel.
• Inline-tabellen worden niet uitgevouwen: point = { x = 1, y = 2 } komt eruit als de string "{ x = 1, y = 2 }", niet als object. Herschrijf hem als eigen [point]-sectie. Dependency-regels in Cargo.toml, zoals serde = { version = "1.0" }, zijn het klassieke geval.
• Keys met punten links van het isgelijkteken blijven een platte key: server.host = "a" levert de key "server.host" op, zonder nesting. Gebruik in plaats daarvan een [server]-header. [sectie.namen] met punten in headers nesten wel correct.
• Commentaar achter een waarde wordt niet weggehaald: port = 8080 # main wordt de string "8080 # main". Houd commentaar op eigen regels.
• Getalnotaties buiten gewone decimalen worden niet herkend: 1_000, 0xFF, 5e2, +99, inf en nan komen eruit als strings tussen aanhalingstekens. Schrijf 1000, 255, 500, 99.
• \uXXXX-escapes in basic strings worden niet gedecodeerd. Plak in plaats daarvan het echte teken.

Voor een volledig TOML 1.0-document gebruik je een commandline-converter zoals toml2json, of laad je het bestand met Pythons tomllib en schrijf je van daaruit JSON weg.

Waar dit handig is

• Snel een TOML-fragment inspecteren als JSON tijdens het debuggen.
• Eenvoudige configuratiewaarden doorgeven aan linters, scripts of inventoritools die alleen JSON accepteren.
• JSON-testfixtures genereren uit TOML-notities die makkelijker met de hand te schrijven zijn.
• Kleine, platte configuratiebestanden migreren, wat veel config.toml-bestanden van Hugo zijn.

Opmerkingen over heen en terug

• Commentaar overleeft nooit: JSON kent simpelweg geen commentaarsyntaxis.
• Datums blijven strings; code verderop moet ze weer naar datumobjecten parsen.
• Grote getallen: gehele getallen blijven 64-bits waarden in de JSON-tekst, maar JavaScript-consumers verliezen precisie boven 2^53. Let op timestamps in nanoseconden en numerieke ID’s.
• De volgorde van keys blijft bij deze converter zoals geschreven; andere JSON-tools kunnen keys hersorteren wanneer ze het document opnieuw wegschrijven.

Omgekeerde richting

JSON → TOML is de lastige kant op, want JSON heeft structuren (diepe anonieme nesting, null) die TOML niet heeft of anders behandelt. De meeste heen-en-terugscenario’s vragen handmatig bijwerken aan de TOML-kant.