TOML to JSON

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

TOML (Tom's Obvious Minimal Language) es un formato de archivo de configuración diseñado para ser legible por humanos. Se mapea inequívocamente a una tabla hash, admite tablas anidadas, valores tipados y comentarios en línea. Muchas herramientas y frameworks utilizan TOML como formato de configuración principal: los proyectos de Rust dependen de Cargo.toml, el empaquetado de Python usa pyproject.toml, y los sitios estáticos de Hugo se configuran mediante config.toml. Convertir TOML a JSON online permite transformar estos archivos de configuración a un formato que prácticamente cualquier lenguaje de programación, API o pipeline de datos puede consumir de forma nativa.

JSON (JavaScript Object Notation), definido por RFC 8259, es el formato de intercambio de datos más ampliamente compatible. Mientras que TOML prioriza la legibilidad humana con su sintaxis mínima y soporte de comentarios, JSON prioriza la interoperabilidad entre máquinas. Un convertidor de TOML a JSON tiende este puente analizando la entrada TOML según la especificación TOML v1.0.0 y generando un documento JSON estructuralmente equivalente. La conversión preserva todos los datos: cadenas, enteros, flotantes, booleanos, arrays y tablas se asignan directamente a sus equivalentes en JSON.

TOML tiene cuatro tipos nativos de fecha y hora que JSON no puede representar directamente: fecha-hora con zona horaria, fecha-hora local, fecha local y hora local. JSON no tiene tipo de fecha, por lo que estos valores se serializan como cadenas ISO 8601 durante la conversión.

¿Por qué usar un convertidor de TOML a JSON?

Los archivos de configuración escritos en TOML a menudo necesitan alimentar sistemas que solo aceptan JSON. En lugar de reescribir el archivo manualmente o instalar una librería de análisis localmente, un convertidor basado en navegador realiza la transformación en segundos.

Casos de uso de TOML a JSON

Referencia de mapeo de tipos TOML a JSON

Cada tipo de TOML tiene un equivalente directo en JSON, con una excepción: los valores de fecha y hora. La tabla siguiente muestra cómo se convierte cada tipo TOML a JSON. Este mapeo sigue la especificación TOML v1.0.0 y coincide con el comportamiento de los parsers estándar como tomllib (Python), toml-rs (Rust) y @iarna/toml (Node.js).

Los enteros TOML admiten guiones bajos para mayor legibilidad (p. ej., 1_000_000) y literales hexadecimales (0xDEADBEEF), octales (0o755) y binarios (0b11010110). Todos ellos se convierten a números decimales simples en JSON. TOML también admite valores flotantes infinito y NaN, pero no tienen representación en JSON y provocarán un error de conversión en modo estricto.

Ejemplos de código

Ejemplos funcionales de conversión de TOML a JSON en cuatro lenguajes. Cada uno lee un archivo TOML, lo analiza y genera JSON formateado.

import { parse } from '@iarna/toml'
import fs from 'fs'

const toml = fs.readFileSync('config.toml', 'utf8')
const json = parse(toml)
console.log(JSON.stringify(json, null, 2))
// Input:  [server]
//         host = "localhost"
//         port = 8080
// Output: { "server": { "host": "localhost", "port": 8080 } }

import tomllib   # Python 3.11+ (standard library)
import json

with open('config.toml', 'rb') as f:
    data = tomllib.load(f)

print(json.dumps(data, indent=2, default=str))
# Dates become strings: "1979-05-27"
# Arrays of tables become JSON arrays of objects

package main

import (
    "encoding/json"
    "fmt"
    "os"

    "github.com/BurntSushi/toml"
)

func main() {
    var data map[string]any
    _, err := toml.DecodeFile("config.toml", &data)
    if err != nil {
        panic(err)
    }
    out, _ := json.MarshalIndent(data, "", "  ")
    fmt.Println(string(out))
}

# Using yj (YAML/JSON/TOML converter)
cat config.toml | yj -tj

# Using dasel
dasel -f config.toml -r toml -w json

# Using Python one-liner (3.11+)
python3 -c "import tomllib, json, sys; print(json.dumps(tomllib.load(sys.stdin.buffer), indent=2, default=str))" < config.toml

Preguntas frecuentes