TOML in JSON

Cos'è la conversione da TOML a JSON?

TOML (Tom's Obvious Minimal Language) è un formato di file di configurazione progettato per essere leggibile dagli esseri umani. Si mappa in modo non ambiguo su una tabella hash, supporta tabelle annidate, valori tipizzati e commenti inline. Molti strumenti e framework usano TOML come formato di configurazione principale: i progetti Rust si affidano a Cargo.toml, il packaging Python usa pyproject.toml e i siti statici Hugo si configurano tramite config.toml. Convertire TOML in JSON online consente di trasformare questi file di configurazione in un formato che praticamente ogni linguaggio di programmazione, API e pipeline di dati può consumare nativamente.

JSON (JavaScript Object Notation), definito dall'RFC 8259, è il formato di scambio dati più ampiamente supportato. Mentre TOML privilegia la leggibilità umana con la sua sintassi minimale e il supporto ai commenti, JSON privilegia l'interoperabilità tra macchine. Un convertitore da TOML a JSON colma questo divario analizzando l'input TOML secondo la specifica TOML v1.0.0 ed emettendo un documento JSON strutturalmente equivalente. La conversione preserva tutti i dati: stringhe, interi, float, booleani, array e tabelle si mappano direttamente sui loro corrispettivi JSON.

TOML ha quattro tipi nativi di data/ora che JSON non può rappresentare direttamente: date-time con offset, date-time locali, date locali e ore locali. JSON non ha un tipo data, quindi questi valori vengono serializzati come stringhe ISO 8601 durante la conversione.

Perché usare un convertitore da TOML a JSON?

I file di configurazione scritti in TOML spesso devono alimentare sistemi che accettano solo JSON. Invece di riscrivere il file manualmente o installare una libreria parser in locale, un convertitore basato su browser gestisce la trasformazione in pochi secondi.

Casi d'uso di TOML in JSON

Riferimento alla mappatura dei tipi da TOML a JSON

Ogni tipo TOML ha un equivalente JSON diretto, con un'eccezione: i valori di data e ora. La tabella seguente mostra come ogni tipo TOML viene convertito in JSON. Questa mappatura segue la specifica TOML v1.0.0 e corrisponde al comportamento dei parser standard come tomllib (Python), toml-rs (Rust) e @iarna/toml (Node.js).

Gli interi TOML supportano gli underscore per la leggibilità (ad es. 1_000_000) e i letterali esadecimali (0xDEADBEEF), ottali (0o755) e binari (0b11010110). Tutti questi vengono convertiti in numeri decimali semplici in JSON. TOML supporta anche i valori float infinito e NaN, ma questi non hanno rappresentazione JSON e causeranno un errore di conversione in modalità strict.

Esempi di Codice

Esempi funzionanti di conversione da TOML a JSON in quattro linguaggi. Ognuno legge un file TOML, lo analizza e restituisce JSON formattato.

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

Domande Frequenti