Convertissez du YAML en JSON !

Saisissez du YAML pour le convertir en JSON ! Compatible avec yml, Kubernetes, docker-compose.
YAML
Résultat
 

Convertissez du YAML en JSON !

Convertissez un document YAML (yml) en JSON pour voir la structure que l'indentation masque et le type réel sous lequel chaque valeur a été analysée. Les ancres et alias sont développés en valeurs réelles, et les documents multiples séparés par --- sont rassemblés dans un tableau.

C'est particulièrement pratique pour repérer les erreurs YAML classiques : une valeur rattachée au mauvais parent à cause d'un espace manquant, ou version: 1.10 qui devient silencieusement le nombre 1.1.

Mode d'emploi

  1. Collez un docker-compose.yml, un manifeste Kubernetes ou un fichier de workflow dans le champ YAML, ou déposez-y le fichier.
  2. Les erreurs de syntaxe apparaissent dans le résultat avec numéros de ligne et de colonne ; vérifiez d'abord l'indentation à cet endroit.
  3. Lisez le JSON sous Résultat pour voir si chaque valeur est devenue une chaîne, un nombre ou un booléen, et copiez-le si besoin.

Exemple

Entrée (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
Sortie (JSON)
{
  "name": "ci",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "defaults": {
    "runs-on": "ubuntu-latest",
    "timeout-minutes": 10
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "timeout-minutes": 10
    }
  }
}

La clé on: de GitHub Actions reste la clé chaîne "on", car cet outil analyse selon les règles de YAML 1.2. Le bloc défini avec l'ancre &node est développé à la place de *node.

Fonctionnalités prises en charge

  • Analyse selon le schéma core de YAML 1.2 : yes, on et off restent des chaînes, et seuls true/True/false deviennent des booléens.
  • ~ et les valeurs vides deviennent null ; l'hexadécimal 0x1F et l'octal 0o17 deviennent des nombres.
  • Les ancres &anchors et alias *aliases sont résolus vers les valeurs référencées.
  • Les scalaires de bloc littéraux | et repliés > sont transformés en chaînes en appliquant les règles de sauts de ligne de YAML.
  • Plusieurs documents séparés par --- deviennent un tableau JSON ; un document unique est produit sous sa propre valeur.
  • Une clé qui apparaît deux fois dans le même mapping est signalée comme une erreur.

Cas d'utilisation

Vérifier l'indentation d'un manifeste Kubernetes

Si env sous containers est indenté d'un niveau de trop peu, il se rattache silencieusement à un autre champ et vous ne le découvrez qu'au moment de l'apply. En JSON, les accolades montrent exactement à quel objet il appartient.

Utiliser une config depuis le code

Pour un script ou un bundle front-end où ajouter un parseur YAML serait excessif, convertissez la config une fois et utilisez-la via import config from './config.json'.

Examiner une spec OpenAPI

Un document OpenAPI écrit en YAML est plus facile à interroger avec JSONPath ou jq une fois converti, par exemple pour extraire le schéma d'un chemin précis.

Remarques et limites

  • Les clés de fusion (<<: *defaults) sont appliquées : les clés du mapping ancré sont recopiées, et celles écrites à côté de << les remplacent. Un parseur strictement YAML 1.2 garderait << comme clé ordinaire : les résultats peuvent donc différer de ces outils.
  • Les dates et heures comme 2024-01-01 restent des chaînes au lieu de devenir des valeurs Date.
  • .inf et .nan n'ont pas de représentation JSON et deviennent null.
  • Les commentaires ne peuvent pas être transportés en JSON et sont supprimés.
  • PyYAML (YAML 1.1) lit on et yes comme true : les résultats obtenus en Python peuvent donc différer.

FAQ

Pourquoi le on de GitHub Actions apparaît-il comme "on" au lieu de true ?

En YAML 1.2, les seuls booléens sont true et false : on est donc une chaîne ordinaire, et c'est aussi ainsi que GitHub Actions lit la clé. PyYAML en Python suit la 1.1 et en fait une clé True : attention quand vous analysez des workflows depuis des scripts.

version: 1.10 sort en 1.1.

Sans guillemets, 1.10 est un nombre en YAML, et 1.10 est égal à 1.1. Pour garder une chaîne de version, mettez-la entre guillemets dans le YAML source : "1.10".

Que se passe-t-il avec un fichier contenant plusieurs documents ?

Chaque document séparé par --- devient un élément du tableau, dans l'ordre : un fichier multi-ressources utilisé avec kubectl apply -f donne donc un tableau de ressources.