Exporta un lote de registros de persona de ejemplo —generados en el servidor— como YAML, una serialización sensible a la sangría muy usada en manifiestos de Kubernetes, configuraciones de CI y fixtures editados a mano. A diferencia de JSON, YAML permite escalares sin comillas y comentarios en ediciones posteriores (el volcado generado en sí es una lista limpia de mapeos).
Cómo funciona
peopleToYaml usa la función stringify del paquete yaml sobre el array de personas, produciendo una secuencia de mapeos con claves anidadas para los campos estructurados. Los valores nulos siguen las reglas de omisión de la librería. El resultado es texto plano que puedes pegar en fixtures *.yaml o convertir con yq.
Cuándo usarlo
- Datos de siembra al estilo de configuración junto a valores de Helm o archivos Compose
- Revisión humana de registros de ejemplo donde las llaves de JSON resultan molestas
- Comparar listas de personas en Git con cambios legibles orientados a líneas
Limitaciones
El tipado implícito de YAML puede sorprender (no/yes como booleanos en otras herramientas): prefiere entrecomillar al editar a mano. Los errores de sangría tras ediciones manuales rompen los parsers. La salida no es compatible con JSON hasta convertirla. El tamaño del lote está limitado en el servidor por los mismos límites que el subtool generador.
Ejemplo
Un volcado de una sola persona se parece a:
- firstName: Ada
lastName: Lovelace
gender: F
birthDate: 1815-12-10
email: ada@example.com
Añadir una segunda persona agrega otro elemento de lista - … en el mismo nivel de sangría.