YAML do JSON

Przykładowa konwersja

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

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

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

JSON (kotwice rozwiązane):

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

Mapowania typów

Rzeczy specyficzne dla YAML, których JSON nie potrafi przedstawić

• Komentarze. JSON nie ma standardowej składni komentarzy. Komentarze są gubione.
• Strumienie wielodokumentowe (separatory ---). JSON to jeden dokument na plik; konwerter emituje tablicę dokumentów, gdy jest ich wiele.
• Kotwice i aliasy. Rozwiązywane i powielane w linii.
• Klucze złożone (klucze mapowania niebędące ciągami). Klucze JSON muszą być ciągami; klucze złożone są zamieniane na ciągi.

Pułapka 1.1 kontra 1.2

• YAML 1.1 parsuje yes, no, on, off, y, n jako wartości logiczne. NO jako kod kraju po cichu staje się false.
• YAML 1.2 ogranicza wartości logiczne do true i false. Bezpieczniejsze, ale wiele parserów (w tym domyślny PyYAML) wciąż używa 1.1.

Konwerter domyślnie stosuje semantykę 1.2 i ostrzega, gdy 1.1 zmieniłoby wynik.

Podróż powrotna z JSON na YAML

JSON na YAML jest zwykle bezstratny (JSON to podzbiór składni YAML 1.2). YAML na JSON jest stratny: komentarze i struktura kluczy scalania znikają. Jeśli planujesz konwersję w obie strony, zachowaj oryginalny YAML w systemie kontroli wersji.