Perché null viene rifiutato invece che omesso?

Perché TOML non ha null, e i due modi di fingerlo sono entrambi sbagliati. Togliere la chiave cambia ciò che il file dice: un’impostazione assente non è un’impostazione messa a nulla. Scrivere una stringa vuota inventa un valore. La conversione si ferma e nomina la chiave: decidi tu.

Perché la mia data è uscita come stringa tra virgolette?

Perché era così quando è arrivata. YAML 1.2 legge `2026-01-01` come stringa; scriverla come data TOML significherebbe indovinare che l’autore pensasse a una data, e sbagliare trasforma un codice prodotto come `2026-01-01` in un timestamp. Una stringa tra virgolette conserva esattamente ciò che c’era.

YAML in TOML — configurazioni convertite

Converti una configurazione YAML in TOML. Le mappe annidate diventano tabelle, pronte per Cargo, pyproject o qualsiasi cosa legga TOML.

Istantaneo Privato Zero cookie

Che cosa fa questo strumento

Le mappe annidate diventano tabelle, gli elenchi di mappe array di tabelle:

db:
  host: db.example.com
  pool:
    size: 10
servers:
  - name: a
  - name: b

[db]
host = "db.example.com"

[db.pool]
size = 10

[[servers]]
name = "a"

[[servers]]
name = "b"

Tre cose che TOML non può reggere

Null. TOML non ha un valore nullo. Togliere la chiave cambierebbe ciò che il file dice; scrivere "" inventerebbe un valore. La conversione si ferma e ti dice quale.

Un elenco alla radice. Un file TOML è una tabella: il primo livello sono coppie chiave/valore, sempre. Un documento YAML con una sequenza alla radice non ha dove metterle. Dai un nome all’elenco e si converte.

Più documenti. --- separa i documenti YAML; TOML non ha separatore né un modo di dire «ed ecco un altro file». Uno per volta.

Le date restano stringhe

2026-01-01 arriva come stringa, perché così la legge YAML 1.2, ed esce come stringa tra virgolette.

TOML ha in effetti un tipo data nativo, e usarlo vorrebbe dire decidere che l’autore pensasse a una data. A volte è così. A volte 2026-01-01 è un codice prodotto, il nome di una cartella, una versione. Sbagliare trasforma testo in timestamp, e non è un cambiamento che si noti prima che qualcosa, più avanti, si metta a ordinare.

Un punto sui grandi interi

Un intero oltre una quindicina di cifre viene arrotondato per strada. La conversione passa per JSON, i cui numeri sono valori in virgola mobile a doppia precisione, ed è lì che le cifre si perdono.

yaml-to-json li tiene esatti: legge le cifre come sono scritte. Il confine che arrotonda è quello condiviso da tutte le conversioni json-to-…, e sarà affrontato lì anziché rattoppato qui. Nel frattempo: se il tuo file porta un identificatore di venti cifre, mettilo tra virgolette nello YAML e passerà come stringa, intatto.

Privato per progettazione

Tutto viene eseguito localmente nel browser con JavaScript. I tuoi dati non vengono mai caricati, quindi lo strumento è sicuro per contenuti sensibili e funziona anche offline.

Domande frequenti

Perché null viene rifiutato invece che omesso?: Perché TOML non ha null, e i due modi di fingerlo sono entrambi sbagliati. Togliere la chiave cambia ciò che il file dice: un’impostazione assente non è un’impostazione messa a nulla. Scrivere una stringa vuota inventa un valore. La conversione si ferma e nomina la chiave: decidi tu.
Perché il mio elenco alla radice non si converte?: Perché un file TOML è una tabella: il primo livello sono sempre coppie chiave/valore. Un documento YAML con una sequenza alla radice non ha a che cosa appenderle. Dai un nome all’elenco — `items:` davanti — e diventa un array di tabelle.
Perché la mia data è uscita come stringa tra virgolette?: Perché era così quando è arrivata. YAML 1.2 legge `2026-01-01` come stringa; scriverla come data TOML significherebbe indovinare che l’autore pensasse a una data, e sbagliare trasforma un codice prodotto come `2026-01-01` in un timestamp. Una stringa tra virgolette conserva esattamente ciò che c’era.