Converteren tussen JSON en YAML

Deze tool transformeert een YAML-document in JSON en omgekeerd, met behoud van de datastructuur (objecten, arrays, scalaire typen). De conversie JSON naar YAML, of YAML naar JSON, is een veelvoorkomende bewerking in ontwikkeling: men genereert een OpenAPI YAML-bestand vanuit een JSON-spec, converteert de uitvoer van een REST-API naar YAML om te committen in een configuratierepository, vertaalt een Kubernetes YAML-manifest naar JSON om door te geven aan kubectl --dry-run=client -o json, of stemt een GitHub Actions-workflow af op een JSON-schema. Meer in het algemeen is het de brug tussen de wereld van gegevensuitwisseling (JSON) en die van handmatig bewerkbare configuratie (YAML).

JSON en YAML beantwoorden nauw verwante behoeften maar verschillende gebruiksgevallen. De volgende tabel vat de belangrijkste technische verschillen samen, nuttig om tussen beide te kiezen afhankelijk van de context.

JSON dringt zich op zodra een programma met een ander programma spreekt. Zijn typische gebruiksgevallen:

• REST- en GraphQL-API's: aanvraag- en antwoordpayloads.
• Gegevensuitwisseling tussen microservices en berichtenwachtrijen.
• Native JavaScript-code: JSON.parse en JSON.stringify zonder afhankelijkheid.
• Opslag aan browserkant: localStorage, sessionStorage, IndexedDB.
• AJAX-verzoeken en fetch.
• Binaire of stream-georiënteerde varianten: BSON (MongoDB), JSON Lines (logs, ML-datasets), MessagePack.
• Configuratie van JS / TS-tools: package.json, tsconfig.json, composer.json.

YAML dringt zich op zodra een mens regelmatig het bestand bewerkt. Zijn typische gebruiksgevallen:

• Docker Compose (docker-compose.yml) en stack-profielen.
• Kubernetes-manifesten (Deployment, Service, Ingress, Helm charts).
• Ansible-playbooks en inventories.
• CI/CD-pipelines: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• OpenAPI- / Swagger- en AsyncAPI-specificaties.
• Geannoteerde applicatieconfiguratie (Symfony, Spring Boot, Rails) waar commentaren nuttig zijn.
• Bestanden die regelmatig met de hand worden bewerkt, waar beknoptheid en leesbaarheid prevaleren boven parse-snelheid.

YAML is toleranter dan JSON, wat het een krachtig maar verraderlijk formaat maakt. De meest voorkomende valkuilen:

• Inspringing: tabs zijn verboden door de specificatie, alleen spaties zijn geldig. Het mengen van beide of het wijzigen van het aantal spaties in eenzelfde blok breekt de parsing.
• Automatische scalaire coercie: yes, no, on, off, true, false, null, None, ~ worden geparseerd als booleans of als null. Voorbeeldvalkuil: een niet-gequote postcode 01234 wordt het gehele getal 1234, en een landnaam NO (Noorwegen) wordt false. Plaats dubbelzinnige tekenreeksen altijd tussen aanhalingstekens.
• Meerregelige strings: | (block literal) behoudt de regeleinden als zodanig, terwijl > (folded) de regeleinden vervangt door spaties. De chomping-indicatoren - en + passen het gedrag op het laatste einde aan.
• YAML 1.1 vs 1.2: 1.1 (nog steeds zeer verspreid, bijvoorbeeld via PyYAML standaard) behandelt yes/no/on/off als booleans, wat 1.2 heeft verwijderd. Het gedrag verschilt ook bij getallen in basis 8.
• Impliciete datums: 2024-01-15 zonder aanhalingstekens wordt door sommige parsers geïnterpreteerd als een datumobject, niet als een tekenreeks.

Hetzelfde document, uitgedrukt in JSON en vervolgens in YAML. Eenvoudige configuratie van een applicatie met zijn afhankelijkheden en zijn omgeving:

JSON-versie

{
    "name": "cdrn-app",
    "version": "1.14.2",
    "environment": "production",
    "dependencies": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": false
}

Equivalente YAML-versie

# Configuration de l'application
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

De YAML-versie is ongeveer 25% korter in tekens, accepteert een commentaar bovenaan en leest als een lijst van eigenschappen zonder syntactische ruis.

Stappen om uw gegevens te converteren:

1. Plak uw brondocument (JSON of YAML) in het invoerveld.
2. Selecteer de gewenste conversierichting (JSON naar YAML, of YAML naar JSON).
3. Klik op de conversieknop: het opgemaakte resultaat verschijnt in het uitvoergebied.
4. Controleer de weergave en gebruik vervolgens de kopieerknop om het resultaat in uw klembord te krijgen.

De conversie wordt lokaal uitgevoerd in uw browser of via een speciale serverroute afhankelijk van de tooling: geen gevoelige gegevens worden bewaard.