YAML zu JSON

Beispielkonvertierung

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

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

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

JSON (Anker aufgelöst):

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

Typzuordnungen

YAML-spezifische Dinge, die JSON nicht darstellen kann

• Kommentare. JSON hat keine standardisierte Kommentarsyntax. Kommentare werden entfernt.
• Mehrdokumentenströme (--- Trennzeichen). JSON ist ein Dokument pro Datei; der Konverter gibt ein Array von Dokumenten aus, wenn es mehrere gibt.
• Anker und Aliase. Inline aufgelöst und dupliziert.
• Komplexe Schlüssel (nicht-string Mapping-Schlüssel). JSON-Schlüssel müssen Strings sein; komplexe Schlüssel werden in Strings umgewandelt.

Der 1.1 vs 1.2 Fallstrick

• YAML 1.1 interpretiert yes, no, on, off, y, n als Booleans. NO als Ländercode wird stillschweigend zu false.
• YAML 1.2 beschränkt Booleans auf true und false. Sicherer, aber viele Parser (einschließlich PyYAML Standard) verwenden immer noch 1.1.

Der Konverter verwendet standardmäßig die Semantik von 1.2 und warnt, wenn 1.1 das Ergebnis geändert hätte.

Hin- und Rückreise von JSON zurück zu YAML

JSON zu YAML ist normalerweise verlustfrei (JSON ist eine Teilmenge der YAML 1.2 Syntax). YAML zu JSON ist verlustbehaftet: Kommentare und die Struktur von Zusammenführungs-Schlüsseln verschwinden. Wenn du eine Hin- und Rückreise planst, bewahre das ursprüngliche YAML in der Versionskontrolle auf.