Exportez un lot de fiches de personnes types — générées côté serveur — en YAML, une sérialisation sensible à l'indentation très utilisée dans les manifestes Kubernetes, les configurations CI et les fixtures modifiées à la main. À la différence de JSON, YAML autorise des scalaires sans guillemets et des commentaires lors d'éditions ultérieures (le dump généré lui-même est une liste propre de mappages).
Fonctionnement
peopleToYaml utilise la fonction stringify du paquet yaml sur le tableau de personnes, produisant une séquence de mappages avec des clés imbriquées pour les champs structurés. Les valeurs nulles suivent les règles d'omission de la bibliothèque. Le résultat est du texte brut que vous pouvez coller dans des fixtures *.yaml ou convertir davantage avec yq.
Quand l'utiliser
- Données d'amorçage façon configuration à côté de valeurs Helm ou de fichiers Compose
- Relecture humaine de fiches types là où les accolades JSON semblent encombrantes
- Comparer des listes de personnes dans Git avec des modifications lisibles ligne par ligne
Limites
Le typage implicite de YAML peut surprendre (no/yes interprétés comme des booléens dans d'autres outils) — préférez les guillemets lors d'une édition manuelle. Les erreurs d'indentation après une édition manuelle cassent les parseurs. La sortie n'est pas compatible JSON avant conversion. La taille du lot est plafonnée côté serveur par les mêmes limites que le sous-outil générateur.
Exemple
Un dump pour une personne ressemble à :
- firstName: Ada
lastName: Lovelace
gender: F
birthDate: 1815-12-10
email: ada@example.com
L'ajout d'une deuxième personne insère un autre élément de liste - … au même niveau d'indentation.