INI naar XML omzetten

INI is compact en makkelijk met de hand te bewerken, maar mist wat XML wel heeft: geneste structuren, een schema om tegen te valideren, en bredere ondersteuning in oudere enterprise-software. Wie een configuratiesysteem overzet naar zo’n omgeving, komt deze omzetting vaak tegen.

Elke sectie in het INI-bestand wordt een element in de XML, en elke sleutel binnen die sectie wordt een onderliggend element met de waarde als inhoud.

De volgorde van de secties en de sleutels binnen elke sectie blijft precies zoals in het originele bestand — er wordt nergens gesorteerd. Waarden komen ongewijzigd over, als tekst.

Voor een configuratiebestand waar de leesvolgorde van secties ertoe doet — bijvoorbeeld omdat latere secties eerdere overschrijven — is dat van belang, en dat gedrag blijft intact.

INI-bestanden bevatten vaak toelichting achter een `;` of `#`, en die regels worden bij het lezen niet meegenomen. Dat geldt overigens voor elk configuratieformaat op deze site — geen van de lezers houdt een kanaal voor commentaar open.

Staat er belangrijke uitleg in die commentaarregels, kopieer die dan apart voor je omzet, want ze komen niet automatisch terug in de XML.

INI kent maar twee niveaus: secties en sleutels daarbinnen. XML kan in principe dieper nesten, maar deze omzetting voegt geen structuur toe die er niet al was — het resultaat heeft dus ook maar twee niveaus diep, section en key, ook al zou XML meer toelaten.

Wil je een dieper geneste XML-structuur, dan is dat een handmatige stap na de omzetting, niet iets wat uit een plat INI-bestand kan worden afgeleid.

Een sleutelnaam die zelf een `=`-teken bevat, of die begint met `;` of `#` zonder dat het om een echte commentaarregel gaat, kan bij het lezen verkeerd worden geïnterpreteerd — dat is een eigenschap van het INI-formaat zelf, niet van deze omzetting specifiek.

Controleer bij een lastig bestand de XML-uitvoer op ontbrekende sleutels, vooral als de bron handmatig of door oudere software is samengesteld.

INI kent geen typen: een waarde als `8080` of `true` is in het bronbestand gewoon tekst, en dat blijft zo in de XML. Moet een applicatie die waarde als getal of booleaanse waarde inlezen, dan gebeurt die interpretatie aan de kant van de applicatie, niet hier.

Dat is meestal geen probleem, omdat de meeste XML-parsers toch alles als tekst binnenkrijgen en zelf de typering doen.

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

Voor een configuratiebestand met wachtwoorden, sleutels of interne servernamen is dat relevant — er is niets dat een server ooit te zien krijgt.

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

Praktisch voor wie een reeks omgevingsconfiguraties — ontwikkeling, test, productie — in één keer wil overzetten naar XML.