Zwischen JSON und YAML konvertieren

Dieses Tool wandelt ein YAML-Dokument in JSON und umgekehrt um, wobei die Datenstruktur (Objekte, Arrays, skalare Typen) erhalten bleibt. Die Konvertierung von JSON nach YAML oder YAML nach JSON ist im Entwicklungsalltag eine häufige Operation: Man generiert eine YAML-OpenAPI-Datei aus einer JSON-Spezifikation, konvertiert die Ausgabe einer REST-API in YAML, um sie in ein Konfigurations-Repository einzuchecken, übersetzt ein Kubernetes-YAML-Manifest in JSON, um es an kubectl --dry-run=client -o json zu übergeben, oder gleicht einen GitHub-Actions-Workflow mit einem JSON-Schema ab. Allgemeiner ist es die Brücke zwischen der Welt des Datenaustauschs (JSON) und der von Hand editierbaren Konfiguration (YAML).

JSON und YAML decken ähnliche Bedürfnisse, aber unterschiedliche Anwendungsfälle ab. Die folgende Tabelle fasst die wichtigsten technischen Unterschiede zusammen, die bei der Wahl zwischen beiden je nach Kontext helfen.

JSON setzt sich durch, sobald ein Programm mit einem anderen Programm spricht. Seine typischen Anwendungsfälle:

• REST- und GraphQL-APIs: Anfrage- und Antwort-Payloads.
• Datenaustausch zwischen Microservices und Message-Queues.
• Nativer JavaScript-Code: JSON.parse und JSON.stringify ohne Abhängigkeit.
• Speicherung im Browser: localStorage, sessionStorage, IndexedDB.
• AJAX-Anfragen und fetch.
• Binäre oder Stream-orientierte Varianten: BSON (MongoDB), JSON Lines (Logs, ML-Datensätze), MessagePack.
• Konfiguration von JS-/TS-Tools: package.json, tsconfig.json, composer.json.

YAML setzt sich durch, sobald ein Mensch die Datei regelmäßig bearbeitet. Seine typischen Anwendungsfälle:

• Docker Compose (docker-compose.yml) und Stack-Profile.
• Kubernetes-Manifeste (Deployment, Service, Ingress, Helm Charts).
• Ansible-Playbooks und Inventare.
• CI/CD-Pipelines: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• OpenAPI-/Swagger- und AsyncAPI-Spezifikationen.
• Annotierte Anwendungskonfiguration (Symfony, Spring Boot, Rails), wo Kommentare nützlich sind.
• Häufig von Hand bearbeitete Dateien, bei denen Knappheit und Lesbarkeit vor Parsing-Geschwindigkeit gehen.

YAML ist freizügiger als JSON, was es zu einem mächtigen, aber tückischen Format macht. Die häufigsten Stolperfallen:

• Einrückung: Tabulatoren sind durch die Spezifikation verboten, nur Leerzeichen sind gültig. Beide zu mischen oder die Anzahl der Leerzeichen in einem Block zu ändern, zerstört das Parsing.
• Automatische Skalar-Coercion: yes, no, on, off, true, false, null, None, ~ werden als Booleans oder null geparst. Tückisches Beispiel: Eine nicht quotierte Postleitzahl 01234 wird zur ganzen Zahl 1234, und ein Ländername NO (Norwegen) wird zu false. Setzen Sie mehrdeutige Zeichenketten immer in Anführungszeichen.
• Mehrzeilige Strings: | (block literal) bewahrt die Zeilenumbrüche, während > (folded) die Zeilenumbrüche durch Leerzeichen ersetzt. Die Chomping-Indikatoren - und + passen das Verhalten am Ende-Umbruch an.
• YAML 1.1 vs. 1.2: Die 1.1 (noch sehr verbreitet, zum Beispiel über PyYAML standardmäßig) behandelt yes/no/on/off als Booleans, was die 1.2 entfernt hat. Auch das Verhalten bei oktalen Zahlen unterscheidet sich.
• Implizite Datumsangaben: 2024-01-15 ohne Anführungszeichen wird von einigen Parsern als Datumsobjekt interpretiert, nicht als Zeichenkette.

Dasselbe Dokument, ausgedrückt in JSON und dann in YAML. Einfache Konfiguration einer Anwendung mit ihren Abhängigkeiten und ihrer Umgebung:

JSON-Version

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

Äquivalente YAML-Version

# 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

Die YAML-Version ist in Zeichen etwa 25 % kürzer, akzeptiert einen Kommentar am Anfang und liest sich wie eine Liste von Eigenschaften ohne syntaktisches Rauschen.

Schritte zum Konvertieren Ihrer Daten:

1. Fügen Sie Ihr Quelldokument (JSON oder YAML) in das Eingabefeld ein.
2. Wählen Sie die gewünschte Konvertierungsrichtung (JSON nach YAML oder YAML nach JSON).
3. Klicken Sie auf die Konvertierungsschaltfläche: Das formatierte Ergebnis erscheint im Ausgabebereich.
4. Prüfen Sie die Ausgabe und verwenden Sie dann die Kopierschaltfläche, um das Ergebnis in Ihre Zwischenablage zu übernehmen.

Die Konvertierung erfolgt je nach Tooling lokal in Ihrem Browser oder über eine dedizierte Serverroute: Es werden keine sensiblen Daten gespeichert.