YAML naar JSON

Voorbeeldconversie

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults
  host: prod.example.com
  debug: false

staging:
  <<: *defaults
  host: staging.example.com
  debug: true

JSON (ankers opgelost):

{
  "defaults": {
    "timeout": 30,
    "retries": 3
  },
  "production": {
    "timeout": 30,
    "retries": 3,
    "host": "prod.example.com",
    "debug": false
  },
  "staging": {
    "timeout": 30,
    "retries": 3,
    "host": "staging.example.com",
    "debug": true
  }
}

Typenmappingen

Dingen die specifiek zijn voor YAML kunnen niet worden weergegeven in JSON

• Commentaren: JSON heeft geen standaard syntaxis voor commentaren; deze worden niet ondersteund.
• Multi-documentstromen (scheiders ---). In JSON bestaat elke bestand uit één document; wanneer er meerdere documenten zijn, genereert de converter een array met deze documenten.
• Ankers en alias: opgelost en gedupliceerd in de regel.
• Complexe sleutels (sleutels die geen string zijn). JSON-sleutels moeten strings zijn; complexe sleutels worden omgezet naar strings.

De valkuil tussen versie 1.1 en 1.2

• YAML 1.1 interpreteert yes, no, on, off, y en n als booleaanwaarden; NO wordt automatisch omgezet naar false als landcode.
• YAML 1.2 beperkt booleaanwaarden tot true en false. Hoewel veiliger, gebruiken veel parsers (waaronder de standaardversie van PyYAML) nog steeds versie 1.1.

De converter gebruikt standaard de semantiek van versie 1.2 en waarschuwt wanneer versie 1.1 het resultaat had kunnen veranderen.

Heen en terug van JSON naar YAML

De omzetting van JSON naar YAML is meestal verliesvrij (JSON is een onderdeel van de syntaxis van YAML 1.2). De omzetting van YAML naar JSON is verliesgevend: commentaren en de merge-key-structuur worden verwijderd. Als u de omzetting heen en weer wilt uitvoeren, moet u het originele YAML-bestand bewaren in het versiebeheersysteem.