JSON naar TOML omzetten

JSON is compact voor machines maar minder prettig om met de hand te bewerken: haakjes, komma’s en aanhalingstekens overal. TOML is bedoeld om door mensen geschreven en gelezen te worden, met secties tussen vierkante haken in plaats van geneste accolades.

Rust-projecten met Cargo.toml en veel moderne Python-tooling met pyproject.toml gebruiken het als standaard configuratieformaat, wat vaak de reden is dat een JSON-bestand hierheen moet.

De geneste structuur van de JSON blijft intact — een object in een object wordt een sectie in een sectie, in plaats van te worden platgeslagen tot één regel per waarde zoals bij een omzetting naar INI gebeurt.

De volgorde van de sleutels blijft ook gelijk aan die in het bronbestand, en de waarden zelf — tekst, getallen, booleans, arrays — komen zonder aanpassing over, omdat TOML dezelfde basistypen kent als JSON.

Een array in de JSON wordt een array in de TOML, met dezelfde volgorde van elementen. TOML ondersteunt arrays van tabellen voor een lijst van objecten, en die vorm wordt gebruikt wanneer de JSON een array van objecten bevat.

Dat is leesbaarder dan de genummerde sleutels die bij een omzetting naar INI zouden ontstaan, en het is precies waarom TOML de voorkeur verdient boven INI zodra de gegevens werkelijk geneste structuren bevatten.

JSON heeft geen ingebouwde manier om commentaar vast te leggen, dus er is niets om over te zetten. TOML ondersteunt commentaar met een `#`, maar die wordt hier niet automatisch toegevoegd.

Wil je toelichting bij bepaalde instellingen, voeg die dan na de omzetting handmatig toe — de gegenereerde TOML is een schone start, geen documentatie.

TOML kent een eigen datumtype dat rechtstreeks als datum wordt herkend, zonder aanhalingstekens. Stond een datum in de JSON als gewone tekenreeks — wat in JSON de enige optie is — dan komt die ook als tekenreeks in de TOML terecht, niet als TOML’s eigen datumtype.

Verwacht de ontvangende software een echt datumveld, controleer dat dan na de omzetting en pas het zo nodig handmatig aan.

Het lezen van de JSON en het schrijven van de TOML gebeurt in deze browsertab. Er wordt niets naar een server gestuurd, wat te controleren is via het netwerktabblad tijdens het omzetten.

Voor configuratie met wachtwoorden of interne instellingen is dat relevant.

Tot honderd JSON-bestanden tegelijk neerzetten kan; elk bestand wordt onafhankelijk verwerkt en het resultaat komt terug als één ZIP.

Praktisch voor wie een project met meerdere configuratiebestanden in één keer overzet naar TOML.