YAML till JSON

Exempelomvandling

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

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

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

JSON (ankare upplösta):

{
  "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
  }
}

Typmappningar

YAML-specifika saker som JSON inte kan representera

• Kommentarer. JSON har ingen standardsyntax för kommentarer. Kommentarer tas bort.
• Flerdokumentströmmar (----avgränsare). JSON är ett dokument per fil; omvandlaren avger en array av dokument när det finns flera.
• Ankare och alias. Upplösta och duplicerade inline.
• Komplexa nycklar (mappningsnycklar som inte är strängar). JSON-nycklar måste vara strängar; komplexa nycklar görs om till strängar.

Fällan 1.1 mot 1.2

• YAML 1.1 tolkar yes, no, on, off, y, n som booleska värden. NO som en landskod blir tyst false.
• YAML 1.2 begränsar booleska värden till true och false. Säkrare men många tolkar (inklusive PyYAML som standard) använder fortfarande 1.1.

Omvandlaren använder 1.2-semantik som standard och varnar när 1.1 skulle ha ändrat resultatet.

Tur och retur från JSON tillbaka till YAML

JSON till YAML är oftast förlustfritt (JSON är en delmängd av YAML 1.2-syntaxen). YAML till JSON är förlustbringande: kommentarer och merge-nyckelstruktur försvinner. Om du planerar att gå tur och retur, bevara den ursprungliga YAML:en i versionshantering.