Convertitore online gratuito da TOML a INI

Formato sorgente: TOML

TOML sta per Tom’s Obvious, Minimal Language. È un formato di configurazione leggibile dall’uomo, progettato per essere facile da scrivere e facile da analizzare. TOML è ampiamente usato dagli sviluppatori per impostazioni applicative, metadati di progetto e file di configurazione di build, soprattutto in ecosistemi software moderni come Rust, Python tooling e altri progetti orientati agli sviluppatori.

TOML supporta tabelle annidate, array, date, booleani, numeri e stringhe. È apprezzato per la sua chiarezza e per ridurre l’ambiguità rispetto ai formati di configurazione più vecchi.

Formato di destinazione: INI

INI è un formato di file di configurazione semplice che usa sezioni, coppie chiave-valore e commenti. È usato da decenni nelle applicazioni Windows, nel software desktop e in molti strumenti cross-platform. I file INI sono facili da leggere e modificare manualmente, il che li rende utili per impostazioni di base dell’applicazione e per la compatibilità con sistemi legacy.

Il vantaggio principale di INI è la sua semplicità e il supporto diffuso. Tuttavia, è meno espressivo di TOML: ha un supporto limitato per i tipi di dati, nessuna struttura annidata standard e una gestione incoerente tra i parser.

Come eseguire la conversione

Non esiste una conversione perfetta 1:1 da TOML a INI perché TOML può rappresentare strutture di dati più ricche di INI. L’approccio migliore è appiattire la struttura TOML in sezioni INI e semplici coppie chiave-valore.

1. Ispeziona il file TOML e identifica le tabelle di livello superiore, le tabelle annidate, gli array e i valori non stringa.
2. Decidi una strategia di appiattimento. In genere, ogni tabella TOML diventa una sezione INI e le tabelle annidate sono rappresentate con nomi di sezione separati da punti o combinati.
3. Converti i valori semplici come stringhe, interi, booleani e float in coppie chiave-valore INI.
4. Gestisci attentamente gli array. INI non ha una sintassi universale per gli array, quindi gli array potrebbero dover essere uniti in stringhe separate da virgole o rappresentati con chiavi ripetute, a seconda dell’applicazione di destinazione.
5. Rivedi le funzionalità TOML non supportate come tabelle inline, stringhe multilinea, date e strutture profondamente annidate, quindi semplificale per la compatibilità con INI.
6. Convalida il risultato aprendo il file INI nell’applicazione di destinazione o testandolo con un parser INI.

Se vuoi una conversione rapida basata sul browser, puoi convertire il file su 101convert.com gratuitamente, senza installare alcun software.

Per la conversione manuale, un editor di testo come Visual Studio Code, Notepad++ o Sublime Text è spesso sufficiente per file piccoli. Per conversioni più grandi o ripetibili, è meglio un approccio tramite scripting. Ad esempio, puoi usare Python con un parser TOML e scrivere logica personalizzata per generare la sintassi INI.

Esempio di mappatura:

[database]
host = "localhost"
port = 5432

potrebbe diventare:

[database]
host=localhost
port=5432

Qualità, compatibilità e limitazioni

La limitazione più grande in questa conversione è che INI non può preservare completamente la struttura TOML o i tipi di dati. Gli array TOML, le tabelle annidate e i valori tipizzati spesso devono essere semplificati, il che può causare perdita di informazioni. Se il file INI deve essere usato da una specifica applicazione, segui le convenzioni INI attese da quell’applicazione, perché la denominazione delle sezioni, le chiavi ripetute e la formattazione dei valori possono variare.

Per ottenere i migliori risultati, quando possibile mantieni il file TOML come sorgente autorevole e genera INI solo per la compatibilità con il software che lo richiede. Se la configurazione è complessa, valuta se l’applicazione di destinazione può accettare TOML direttamente invece di convertirlo.