Convierte un documento YAML (yml) en JSON para ver la estructura que oculta la indentación y el tipo real con el que se interpretó cada valor. Las anclas y los alias se expanden en valores reales, y varios documentos separados por --- se reúnen en un array.
Es especialmente útil para detectar errores clásicos de YAML: un valor que cuelga del padre equivocado por un espacio de menos, o un version: 1.10 que se convierte en silencio en el número 1.1.
YAML, o arrastra el archivo sobre él.Resultado para ver si cada valor quedó como cadena, número o booleano, y cópialo si lo necesitas.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}La clave on: de GitHub Actions se queda como la clave de texto "on", porque esta herramienta parsea con las reglas de YAML 1.2. El bloque definido con el ancla &node se expande en lugar de *node.
yes, on y off se quedan como cadenas, y solo true/True/false pasan a booleanos.~ y los valores vacíos pasan a null; el hexadecimal 0x1F y el octal 0o17 pasan a números.&anchors y los *aliases se resuelven a los valores referenciados.| y plegados > se convierten en cadenas aplicando las reglas de saltos de línea de YAML.--- se convierten en un array JSON; un solo documento se emite como su propio valor.Si el env bajo containers tiene un nivel menos de indentación, se engancha en silencio a otro campo y solo te enteras al aplicar. En JSON, las llaves muestran exactamente a qué objeto pertenece.
Para un script o un bundle de front-end en el que añadir un parser de YAML es excesivo, convierte la configuración una vez y úsala como import config from './config.json'.
Un documento OpenAPI escrito en YAML es más fácil de consultar con JSONPath o jq una vez convertido, por ejemplo para extraer el schema de una ruta concreta.
<<: *defaults): se copian las claves del mapping anclado, y las claves escritas junto a << las sobrescriben. Un parser solo de YAML 1.2 mantendría << como una clave normal, así que los resultados pueden diferir de esas herramientas.2024-01-01 se quedan como cadenas en lugar de convertirse en valores Date..inf y .nan no tienen representación en JSON y pasan a null.on y yes como true, así que los resultados desde Python pueden ser distintos.on de GitHub Actions aparece como "on" en lugar de true?En YAML 1.2 los únicos booleanos son true y false, así que on es una cadena normal, que es también como GitHub Actions lee esa clave. PyYAML de Python sigue la 1.1 y la convierte en una clave True, así que ten cuidado al parsear workflows desde scripts.
version: 1.10 sale como 1.1.Sin comillas, 1.10 es un número en YAML, y 1.10 es igual a 1.1. Para mantener una cadena de versión, ponla entre comillas en el YAML de origen como "1.10".
Cada documento separado por --- se convierte en un elemento del array, en orden, así que un archivo con varios recursos usado con kubectl apply -f da un array de recursos.