TOML a JSON

Cómo se asignan los tipos

La salida siempre se imprime con sangría de 4 espacios, así que los arrays y objetos ocupan varias líneas; la tabla anterior muestra los valores en línea para facilitar la lectura. El orden de las claves se conserva exactamente como aparece en tu TOML.

Ejemplo completo

title = "My App"

[server]
host = "localhost"
port = 8080

[[users]]
name = "alice"
admin = true

se convierte en:

{
    "title": "My App",
    "server": {
        "host": "localhost",
        "port": 8080
    },
    "users": [
        {
            "name": "alice",
            "admin": true
        }
    ]
}

TOML admitido y límites reales

Se admite: cabeceras [tabla] incluidos los nombres de sección con puntos, [[arrays de tablas]], pares clave = valor en una línea, cadenas básicas "..." con escapes \n, \t y \", cadenas literales '...', enteros y decimales en notación simple, true/false, arrays de una línea (con anidación), comentarios # de línea completa y fechas que pasan como cadenas.

No se admite, y qué hacer en su lugar:

• Las cadenas multilínea (""" o ''') y los arrays multilínea detienen el parser con un error. Pon antes el valor en una sola línea.
• Las tablas inline no se expanden: point = { x = 1, y = 2 } sale como la cadena "{ x = 1, y = 2 }", no como objeto. Reescríbela como su propia sección [point]. Las líneas de dependencias de Cargo.toml, como serde = { version = "1.0" }, son el caso clásico.
• Las claves con puntos a la izquierda del igual quedan como una clave plana: server.host = "a" produce la clave "server.host", sin anidar. Usa una cabecera [server] en su lugar. Los [nombres.de.seccion] con puntos en cabeceras sí anidan correctamente.
• Los comentarios en la misma línea no se eliminan: port = 8080 # main se convierte en la cadena "8080 # main". Mantén los comentarios en líneas propias.
• Los formatos numéricos más allá del decimal simple no se reconocen: 1_000, 0xFF, 5e2, +99, inf y nan salen como cadenas entrecomilladas. Escribe 1000, 255, 500, 99.
• Los escapes \uXXXX en cadenas básicas no se decodifican. Pega el carácter real en su lugar.

Para un documento TOML 1.0 completo, usa un conversor de línea de comandos como toml2json, o carga el archivo con tomllib de Python y vuelca JSON desde ahí.

Dónde resulta útil

• Inspección rápida de un fragmento TOML como JSON mientras depuras.
• Pasar valores de configuración sencillos a linters, scripts o herramientas de inventario que solo aceptan JSON.
• Generar fixtures JSON para tests a partir de notas TOML más cómodas de escribir a mano.
• Migrar archivos de configuración pequeños y planos, como son muchos config.toml de Hugo.

Notas sobre la ida y vuelta

• Los comentarios nunca sobreviven: JSON no tiene sintaxis de comentarios.
• Las fechas siguen siendo cadenas; el código posterior tiene que volver a convertirlas en objetos de fecha.
• Números grandes: los enteros se conservan como valores de 64 bits en el texto JSON, pero los consumidores JavaScript pierden precisión por encima de 2^53. Cuidado con timestamps en nanosegundos e IDs numéricos.
• El orden de las claves se mantiene tal como está escrito en este conversor; otras herramientas JSON pueden reordenarlas al reemitir el documento.

Sentido inverso

JSON → TOML es el viaje difícil, porque JSON tiene estructuras (anidación anónima profunda, null) que TOML no tiene o trata de otra forma. La mayoría de los escenarios de ida y vuelta requieren ajustes manuales en el lado TOML.