Convertire XML in TOML

Ogni elemento con figli diventa una tabella, scritta come intestazione tra parentesi quadre che nomina il percorso completo con i punti. Un elemento a tre livelli di profondità produce un’unica intestazione.

Dentro ogni tabella, i valori semplici vengono prima e le tabelle annidate seguono, l’unico ordine che TOML permette. Non è una modifica, solo un riordino: nessun valore si sposta a un percorso diverso.

Questa è la parte della conversione che non ha bisogno di riparazione. Due o più elementi fratelli con lo stesso tag diventano un array TOML di tabelle, con l’intestazione a doppia parentesi scritta una volta per elemento.

Il caveat XML familiare resta sotto: una singola occorrenza di un elemento ripetibile non è un array, quindi diventa una tabella semplice. Convertite un file con una voce e lo stesso file con due, e gli output differiscono strutturalmente.

Le chiavi TOML nude permettono solo lettere, cifre, underscore e trattino. Gli attributi arrivano dal parser come chiavi che iniziano con @, il testo proprio di un elemento sotto una chiave chiamata #text.

Sono anche una lista di cose da fare. Una chiave tra virgolette è il convertitore che vi dice che questo nome viene dal meccanismo XML piuttosto che dalla vostra configurazione: rinominatela.

Un documento TOML è esso stesso una tabella, e un documento XML ha esattamente un elemento radice, quindi l’intera configurazione appare un livello più in profondità di quanto vorreste.

Promuovere il contenuto è una modifica meccanica: cancellate la prima intestazione e rimuovete quel segmento da ogni altra intestazione nel file.

TOML non ha valore nullo, e convertire da formati che ne hanno — YAML in particolare — significa chiavi che spariscono silenziosamente quando il loro valore è vuoto. Non può succedere qui, perché XML non ha nemmeno un nullo.

Quindi la garanzia per questa direzione è più forte dei vicini: ogni elemento che aveva un valore nell’XML ha una chiave nel TOML.

TOML mette data e ora nella specifica principale — datetime con offset, datetime locale, data locale e ora locale — e un parser li restituisce come date piuttosto che stringhe.

Un valore XML è testo, quindi una data nel sorgente arriva come stringa tra virgolette e resta tale. Togliere le virgolette a quei valori nell’output è ciò che li trasforma in vere date TOML.

Un elemento contenente più righe — una descrizione, un blocco licenza — diventa una singola stringa TOML di base con escape backslash-n dove erano gli a capo. È corretto ed è illeggibile.

TOML ha una sintassi stringa multilinea con triple virgolette che tiene un tale valore leggibile, e lo scrittore non la usa. Trovate i valori con escape e riscriveteli come blocco a triple virgolette.

Ciò che lo strumento vi dà è ogni valore dall’XML, nella tabella giusta, con il nome giusto nella maggioranza dei casi e uno tra virgolette nel resto. È un buon punto di partenza, non una configurazione finita.

Il lavoro dopo è piccolo e non facoltativo: eliminate la tabella radice, rinominate le chiavi @ e #text, togliete le virgolette alle date, riscrivete i valori multilinea e copiate i commenti dall’originale.