Convertitore da JSON a TOML

Cos'è la conversione da JSON a TOML?

La conversione da JSON a TOML trasforma i dati da JavaScript Object Notation in Tom's Obvious Minimal Language. JSON usa parentesi graffe, parentesi quadre e chiavi tra virgolette per rappresentare dati strutturati. TOML usa una sintassi piatta chiave-valore con intestazioni di sezione (chiamate tabelle) che si legge come un file INI ma con tipizzazione rigorosa. TOML è stato progettato specificamente per i file di configurazione dove la leggibilità umana conta più dello scambio automatico dei dati.

TOML è diventato il formato di configurazione predefinito per Rust (Cargo.toml), il packaging Python (pyproject.toml), i siti statici Hugo, le impostazioni di deployment Netlify e molti strumenti CLI. Quando i dati di origine esistono come JSON — da una risposta API, una configurazione esportata o un file generato — e il sistema di destinazione si aspetta TOML, serve un convertitore che mappi gli oggetti JSON in tabelle TOML, gli array JSON in array TOML, e preservi ogni tipo di dato con precisione.

Convertire JSON in TOML online è il modo più rapido per generare TOML valido da dati JSON esistenti. La conversione gestisce automaticamente la mappatura dei tipi: le stringhe JSON diventano stringhe TOML, i numeri JSON diventano interi o float TOML, i booleani JSON si mappano direttamente, e gli oggetti JSON diventano tabelle TOML. L'unica eccezione è il null — TOML non ha un tipo null, quindi i valori null vengono omessi o convertiti in stringhe vuote a seconda del convertitore.

Perché usare questo convertitore da JSON a TOML?

TOML è quello che i file di configurazione si aspettano; JSON è quello che producono le API e gli strumenti. Questo convertitore colma il divario per spostare i dati tra i due formati senza riscrittura manuale.

Casi d'uso della conversione JSON in TOML

Confronto JSON vs TOML

JSON e TOML si sovrappongono nelle funzionalità ma differiscono nella sintassi, nel supporto dei tipi e nell'uso previsto. Questa tabella mostra le differenze che influenzano la conversione.

Insidie della conversione TOML

TOML ha regole che differiscono da JSON in modi che influenzano l'output della conversione. Questi quattro problemi causano la maggior parte della confusione.

Esempi di codice

La conversione programmatica da JSON a TOML richiede una libreria di serializzazione TOML nella maggior parte dei linguaggi. Le librerie standard gestiscono il parsing JSON; l'output TOML necessita di un pacchetto dedicato.

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

Domande frequenti