Traduce documentos TOML a YAML con ordenacion de claves y control de indentacion opcionales.
Traduce documentos TOML a YAML con ordenacion de claves y control de indentacion opcionales. Traduce documentos TOML a YAML con ordenacion de claves y control de indentacion opcionales.
Salida
Contexto
Por que moverse entre TOML y YAML
Ambos formatos apuntan a archivos de configuracion editados por humanos, pero el ecosistema que los rodea es distinto. TOML es el estandar para empaquetado en Python (pyproject.toml), Rust (Cargo.toml), workflows de GitHub y muchas herramientas CLI. YAML es el estandar para Kubernetes, Ansible, Docker Compose, GitHub Actions (la sintaxis antigua) y muchos sistemas CI.
A veces necesitas expresar la misma configuracion en ambos formatos: reutilizar un fragmento de pyproject.toml dentro de un playbook de Ansible, o transcribir un ConfigMap de Kubernetes en un bloque de dependencias de Cargo.toml. Un conversor de TOML a YAML mantiene la traduccion mecanica.
Que sobrevive a la conversion
Mapeos, secuencias, escalares (cadenas, enteros, flotantes, booleanos, fechas ISO), tablas en linea y claves punteadas se traducen limpiamente. Las cadenas multilinea se emiten como escalares de bloque YAML, preservando la disposicion visual elegida por el autor original del TOML.
Que no sobrevive
Las etiquetas YAML (!!str, !!int, etc.) solo se emiten cuando el tipo subyacente difiere de la inferencia por defecto de YAML. En la practica la eleccion del parser coincide con lo que la mayoria de los lectores esperan. Los anclas YAML no se producen por defecto porque cada valor TOML es completamente autocontenido; si quieres sub-arboles compartidos, introducelos a mano.
Consejos de flujo de trabajo
Tras la conversion, pasa el YAML por un linter (yamllint, kubeconform) antes de hacer commit. El conversor traduce sintaxis, no estilo: no puede saber si pretendias snake_case o kebab-case, ni si querias 2 o 4 espacios de indentacion. Las convenciones de tu proyecto deciden eso.
Preguntas frecuentes
El conversor soporta matrices de tablas TOML?
Si. Las cabeceras [[name]] se convierten en elementos de secuencia YAML bajo la clave name, preservando el orden de las tablas.
La salida YAML conserva mis comentarios TOML?
No. Los comentarios TOML son eliminados por el parser. Agrega los comentarios a mano en la salida YAML si los necesitas.
Como se representan las fechas TOML en YAML?
Las fechas y datetimes se vuelven cadenas YAML con la misma representacion ISO. La mayoria de los consumidores YAML las parsean con la biblioteca de fechas de su lenguaje.
Que pasa con las tablas en linea de TOML?
Se vuelven mapeos YAML anidados en una sola linea. Algunas guias de estilo exigen estilo de bloque para legibilidad; convierte manualmente si tu linter se queja.
Por que la salida usa comillas dobles alrededor de las cadenas?
Las cadenas YAML con comillas simples prohíben secuencias de escape y los escalares planos YAML tienen palabras reservadas; las comillas dobles son la opcion mas segura para往返 de texto arbitrario.
Mi TOML se sube?
No. El parseo ocurre en local mediante smol-toml y la emision YAML via js-yaml. Nada se envia a un servidor.