Conversión de datos estructurados entre YAML, JSON y TOML
La gestión de configuraciones y la comunicación entre sistemas requieren a menudo alternar entre distintos formatos de serialización de datos. YAML, JSON y TOML presentan estructuras, sintaxis y propósitos de diseño diferentes. Esta herramienta permite transformar datos estructurados directamente en el navegador, facilitando el cambio de formato de manera inmediata.
El proceso se realiza de forma local: el usuario introduce los datos en el área de entrada, selecciona los formatos de origen y destino, y la herramienta genera la salida correspondiente. Adicionalmente, es posible configurar la sangría del resultado para adaptarla a las guías de estilo del proyecto.
Formatos de entrada y salida admitidos
La herramienta opera con tres de los formatos de serialización más extendidos en el desarrollo de software y la administración de sistemas:
- JSON (JavaScript Object Notation): Ampliamente utilizado en la comunicación de APIs y el intercambio de datos en la web debido a su estructura ligera y su compatibilidad nativa con JavaScript.
- YAML (YAML Ain't Markup Language): Orientado a la legibilidad humana, muy común en la definición de flujos de trabajo de integración y despliegue continuos (CI/CD) y en archivos de configuración complejos.
- TOML (Tom's Obvious Minimal Language): Diseñado para ser un formato de configuración mínimo y fácil de leer, estructurado en tablas claras y tipado inequívoco.
El usuario puede definir el formato de origen mediante el selector de Formato de entrada y el formato final con el selector de Formato de salida. El campo de entrada incluye el texto indicativo "Pega YAML, JSON o TOML...". Para los formatos JSON y YAML, se puede ajustar el parámetro de Sangría seleccionando un valor numérico de 2 o 4 espacios.
Métricas y datos de salida en tiempo real
Una vez realizada la conversión, el resultado se muestra en el campo de salida, cuyo marcador de posición inicial es "La salida convertida aparecerá aquí.". Además del texto convertido, la interfaz calcula y expone metadatos específicos sobre la estructura procesada:
- Entrada: Muestra el recuento total de caracteres del texto de origen.
- Salida: Muestra el recuento de caracteres del texto resultante.
- Raíz: Indica el tipo de elemento que actúa como nodo raíz en la estructura de datos.
- Entradas: Detalla el número total de registros o elementos individuales identificados en el documento.
Reglas de conversión y comportamiento de los formatos
La traducción de datos entre lenguajes de marcado implica la aplicación de reglas estrictas para garantizar la validez del documento resultante:
- Pérdida de comentarios y formato original: Los comentarios y el espaciado del documento de entrada no se conservan en el resultado. El convertidor analiza los valores semánticos y genera un documento nuevo y limpio desde cero.
- Restricciones de la raíz en TOML: El formato TOML exige que la raíz del documento sea una tabla o un objeto con pares clave-valor. No es posible generar un documento TOML válido a partir de un valor único suelto, como una cadena de texto, un número o un array independiente. Si se intenta realizar esta operación, la herramienta mostrará el mensaje "Estos datos no se pueden escribir como TOML válido.".
Gestión de errores y mensajes del sistema
Para asegurar un flujo de trabajo controlado, la herramienta valida la estructura de los datos y el estado de la aplicación, devolviendo mensajes específicos ante cualquier anomalía o acción:
- Si el campo de entrada está vacío al intentar procesar, se muestra "Pega primero algún contenido.".
- Si se selecciona el mismo formato para la entrada y la salida, el sistema indica "Elige dos formatos distintos.".
- El límite técnico de procesamiento está fijado en 2.000.000 de caracteres. Si se supera, la interfaz muestra "La entrada es demasiado grande. Manténla por debajo de
{max}caracteres.". - Si la sintaxis del origen presenta fallos que impiden su lectura, se devuelven los mensajes "Este JSON no se pudo analizar.", "Este YAML no se pudo analizar." o "Este TOML no se pudo analizar." según corresponda.
- Si el proceso excede el tiempo de espera razonable, se muestra "Esta conversión tarda demasiado. Prueba con menos contenido.".
- Ante cualquier otro fallo imprevisto durante la transformación, se indica "No se pudo convertir esta entrada.".
- Al restablecer los campos mediante la opción de limpieza, se confirma con "Entrada y salida borradas.". Al cargar el set de pruebas se muestra "Ejemplo cargado.", al alternar los formatos se indica "Formatos intercambiados." y al exportar el archivo se muestra "Descarga iniciada.".
- Tras finalizar con éxito, la herramienta confirma la acción con el mensaje "Convertido
{from}a{to}. Tamaño de salida:{size}.".
Privacidad y procesamiento local
La seguridad de los datos de configuración es crítica, especialmente cuando contienen variables de entorno o estructuras de infraestructura. El procesamiento de esta herramienta se realiza por completo en el navegador web del usuario. Los datos estructurados en formato YAML, JSON o TOML no se suben a BroBroGo ni a ningún servidor externo, garantizando que la información no salga del entorno local del cliente.
Preguntas frecuentes
¿Qué conversiones admite?
Puedes convertir entre YAML, JSON y TOML en cualquier dirección. Elige los formatos de entrada y salida antes de convertir.
¿Por qué algunos valores no pueden ser TOML?
Un archivo TOML necesita una tabla superior. Una cadena, un número o un array suelto puede pasar a JSON o YAML, pero no a un documento TOML válido.
¿Se conservan los comentarios?
No. El convertidor lee los valores y escribe un documento nuevo y limpio, así que no conserva comentarios ni espaciado original.