YAML naar JSON omzetten

YAML is prettig om met de hand te schrijven — Kubernetes-manifesten, Docker Compose en CI-configuratie gebruiken het daarom. Veel programmeertalen en API’s verwachten echter JSON, en niet elke bibliotheek leest YAML rechtstreeks in.

Deze omzetting schrijft dezelfde gegevens in de indeling die vrijwel elke taal en elk script zonder extra bibliotheek kan inlezen.

De structuur — geneste objecten, arrays, geneste arrays binnen objecten — komt rechtstreeks over, omdat JSON dezelfde basisvormen kent als YAML, alleen met accolades en aanhalingstekens in plaats van inspringing.

De volgorde van de sleutels blijft eveneens gelijk aan die in het bronbestand.

YAML staat toe dat je met een `#` toelichting bij een instelling zet, en JSON heeft daar geen kanaal voor. Die regels worden bij het lezen niet meegenomen.

Staat er belangrijke uitleg in de YAML, kopieer die dan apart voor je omzet — ze komen niet automatisch terug in het JSON-bestand.

YAML kent een mechanisme om een stuk data eenmaal te definiëren met een anker en het elders in het bestand te hergebruiken met een verwijzing. JSON kent dat niet, dus bij het omzetten wordt elke verwijzing vervangen door de werkelijke waarde waar hij naar wees.

Het resultaat bevat dus geen herhaling-besparende structuur meer, maar de volledige, uitgeschreven gegevens — inhoudelijk hetzelfde, alleen minder compact opgeschreven.

YAML staat toe dat één bestand meerdere documenten bevat, gescheiden door `---`. JSON kent dat concept niet, dus bij een bestand met meerdere documenten wordt het eerste document gebruikt voor de omzetting.

Bevat het bronbestand meerdere van dat soort documenten en heb je ze allemaal nodig, splits het bestand dan eerst op langs de scheidingstekens voordat je omzet.

Getallen, tekst en booleaanse waarden komen zonder aanpassing over, omdat beide formaten dezelfde basistypen delen. Een waarde die in de YAML zonder aanhalingstekens als `true` stond, komt ook als boolean in de JSON terecht, niet als de tekenreeks «true».

Bij twijfel over hoe een specifieke waarde is geïnterpreteerd, is het resultaat direct te controleren — JSON is compact genoeg om in één oogopslag na te lopen.

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

Voor configuratie met omgevingsvariabelen of interne servernamen is dat relevant.

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

Praktisch voor wie een reeks manifesten of configuratiebestanden in één keer wil overzetten naar iets dat een script rechtstreeks kan inlezen.