Conversor JSON a TOML

¿Qué es la conversión de JSON a TOML?

La conversión de JSON a TOML transforma datos de JavaScript Object Notation al lenguaje TOML (Tom's Obvious Minimal Language). JSON utiliza llaves, corchetes y claves entre comillas para representar datos estructurados. TOML emplea una sintaxis plana de clave-valor con encabezados de sección (llamados tablas) que se lee como un archivo INI pero con tipado estricto. TOML fue diseñado específicamente para archivos de configuración donde la legibilidad humana importa más que el intercambio entre máquinas.

TOML se ha convertido en el formato de configuración predeterminado para Rust (Cargo.toml), el empaquetado de Python (pyproject.toml), los sitios estáticos de Hugo, la configuración de despliegue en Netlify y muchas herramientas de línea de comandos. Cuando tus datos de origen existen como JSON — desde una respuesta de API, una configuración exportada o un archivo generado — y tu sistema de destino espera TOML, necesitas un conversor que mapee objetos JSON a tablas TOML, arrays JSON a arrays TOML y preserve cada tipo de dato con precisión.

Convertir JSON a TOML online es la forma más rápida de generar TOML válido a partir de datos JSON existentes. La conversión gestiona el mapeo de tipos automáticamente: las cadenas JSON se convierten en cadenas TOML, los números JSON en enteros o decimales TOML, los booleanos JSON se mapean directamente y los objetos JSON se convierten en tablas TOML. La única excepción es null — TOML no tiene tipo null, por lo que los valores nulos se omiten o se convierten en cadenas vacías según el conversor.

¿Por qué usar este conversor de JSON a TOML?

TOML es lo que esperan los archivos de configuración; JSON es lo que producen las APIs y las herramientas. Este conversor tiende el puente para que puedas mover datos entre los dos formatos sin reescribir nada manualmente.

Casos de uso de JSON a TOML

Comparación entre JSON y TOML

JSON y TOML comparten capacidades pero difieren en sintaxis, compatibilidad de tipos y uso previsto. Esta tabla muestra las diferencias que afectan a la conversión.

Consideraciones en la conversión a TOML

TOML tiene reglas que difieren de JSON de formas que afectan al resultado de la conversión. Estos cuatro problemas generan la mayor confusión.

Ejemplos de código

Convertir JSON a TOML de forma programática requiere una biblioteca de serialización TOML en la mayoría de los lenguajes. Las bibliotecas estándar analizan JSON; la salida TOML necesita un paquete dedicado.

import { stringify } from '@iarna/toml'

const json = '{"title":"My App","database":{"host":"localhost","port":5432}}'
const obj = JSON.parse(json)
const toml = stringify(obj)
console.log(toml)
// → title = "My App"
// →
// → [database]
// → host = "localhost"
// → port = 5432

import json
import tomli_w  # pip install tomli_w

json_str = '{"title": "My App", "database": {"host": "localhost", "port": 5432}}'
data = json.loads(json_str)
toml_str = tomli_w.dumps(data)
print(toml_str)
# → title = "My App"
# →
# → [database]
# → host = "localhost"
# → port = 5432

package main

import (
    "encoding/json"
    "fmt"
    "github.com/pelletier/go-toml/v2"
)

func main() {
    jsonStr := `{"title":"My App","database":{"host":"localhost","port":5432}}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    tomlBytes, _ := toml.Marshal(data)
    fmt.Println(string(tomlBytes))
    // → title = 'My App'
    // →
    // → [database]
    // → host = 'localhost'
    // → port = 5432
}

# Using yj (https://github.com/sclevine/yj)
echo '{"title":"My App","port":3000}' | yj -jt
# → title = "My App"
# → port = 3000

# Using remarshal (pip install remarshal)
echo '{"title":"My App","port":3000}' | remarshal -if json -of toml
# → title = "My App"
# → port = 3000

Preguntas frecuentes