JSON naar INI omzetten

INI kent maar twee niveaus: secties en sleutels daarbinnen. JSON kan willekeurig diep nesten, dus voordat er een geldig INI-bestand uit kan komen, wordt elke geneste structuur omgezet naar één sleutel per eindwaarde, met de oorspronkelijke pad-onderdelen aan elkaar geplakt met een punt.

Een JSON-object `{"server": {"host": "example.com"}}` wordt zo een sleutel `server.host` met de waarde `example.com`. Er verandert niets aan de waarde zelf, alleen aan hoe de sleutel wordt opgeschreven.

Een array wordt op dezelfde manier behandeld als een object: elke index wordt onderdeel van de sleutelnaam. Het eerste element van een array `poorten` wordt dus `poorten.0`, het tweede `poorten.1`, en zo verder.

Voor een korte lijst is dat prima leesbaar; voor een lange array levert het een flink aantal aparte sleutels op, wat het INI-bestand minder overzichtelijk maakt dan de oorspronkelijke JSON.

De volgorde waarin de sleutels in de JSON stonden, blijft hetzelfde in de INI-uitvoer — er wordt nergens gesorteerd. Voor een configuratiebestand waar leesvolgorde ertoe doet, is dat van belang.

Bevatte het JSON-object een topniveau van meerdere sleutels zonder gemeenschappelijke sectie, dan komen die als losse regels vóór de eerste sectiekop te staan.

JSON kent getallen, booleans en tekst als aparte typen; INI kent alleen tekst. Een waarde `8080` in de JSON komt dus als de tekenreeks `8080` in de INI terecht, en `true` als de tekenreeks `true`.

Voor de meeste toepassingen maakt dat niets uit, omdat software die een INI-bestand inleest die typering vaak zelf weer afleidt uit de tekst.

JSON heeft geen ingebouwde manier om commentaar op te slaan, dus er is ook niets om over te zetten. Wil je toelichting bij de configuratie, voeg die dan na de omzetting handmatig toe aan de INI met `;` of `#`.

Dat geldt overigens voor elk configuratieformaat hier: geen enkele omzetting op deze site verzint commentaar dat er niet al was.

Is de structuur van je gegevens echt hiërarchisch en wil je die vorm behouden, dan is TOML of YAML een beter doel dan INI — beide kunnen geneste structuren rechtstreeks weergeven zonder alles tot dotted keys terug te brengen.

INI is de juiste keuze wanneer de ontvangende software specifiek dat formaat verwacht, zoals veel oudere Windows- en desktopapplicaties doen.

Het lezen van de JSON en het schrijven van de INI 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, API-sleutels of interne servernamen is dat relevant.

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

Praktisch voor wie een reeks configuraties voor verschillende omgevingen in één keer wil omzetten.