Convertire TOML in XML

XML richiede esattamente una radice e un documento TOML è una tabella con qualsiasi numero di chiavi. Se il file ha esattamente una chiave di primo livello che contiene una tabella, quella chiave diventa la radice.

Se ci sono diverse chiavi di primo livello, tutto viene avvolto in un root generico. Rinominare quella radice è quasi sempre la prima modifica da fare.

Un blocco [[bin]] ripetuto tre volte è il modo TOML di scrivere una lista di record, e converte in tre elementi bin gemelli, ciascuno con i propri figli. Nessun elemento wrapper, nessun attributo indice.

Una singola occorrenza di un elemento ripetibile non è un array, quindi diventa una tabella semplice con un’intestazione a parentesi singola invece.

TOML è insolito nell’avere quattro tipi temporali, e la conversione li tiene separati invece di collassarli su un unico istante UTC. Un datetime con offset e uno locale sono entrambi xs:dateTime validi.

Una data locale è xs:date. Un’ora locale è xs:time. Ogni valore guadagna una componente millisecondi che non aveva nel manifest — vale la pena saperlo se un’XSLT confronta il testo con un letterale.

TOML permette che una chiave sia quasi qualsiasi cosa se tra virgolette. I nomi elemento XML non possono iniziare con una cifra e non possono contenere uno spazio. Lo scrittore riscrive piuttosto che rifiutare.

Un carattere fuori da lettere, cifre, underscore, trattino e punto diventa un underscore, e un nome che inizia con qualcosa che non è lettera guadagna un underscore iniziale.

Di default ogni chiave TOML diventa un elemento figlio. La convenzione dello scrittore per gli attributi è una chiocciola iniziale sul nome della chiave: dentro una tabella, "@id" = 42 produce id="42".

Il testo dell’elemento accanto agli attributi usa la chiave "#text" allo stesso modo. Entrambi valgono la pena conoscerli perché trasformano un lavoro in due passaggi in uno solo.

Nessuna dichiarazione XML viene scritta, quindi il documento inizia dall’elemento radice. Nessun namespace, nessuna posizione schema, nessuna istruzione di elaborazione.

Un array TOML vuoto è l’altro caso silenzioso: tags = [] non produce alcun elemento, solo una riga vuota dove uno sarebbe andato — difendibile, e sorprenderà comunque uno schema con minOccurs="1".

Entrambi i formati supportano i commenti e né il lettore né lo scrittore li spostano, quindi ogni riga con # che spiega perché una dipendenza è fissata è assente dall’XML.

Trattate l’XML come un artefatto generato, non come una copia. Rigeneratelo ogni volta che il manifest cambia piuttosto che modificarlo sperando che i due restino sincronizzati.

In questa scheda del browser, con JavaScript ordinario. Nessun motore scaricato, nulla caricato, nessun account e nessuna quota giornaliera.

Il limite gratuito è 100 MB, che nessun manifest si avvicinerà mai. Ciò che cambia è l’output: XML ripete ogni nome due volte e aggiunge indentazione, quindi aspettatevi da due a tre volte la dimensione del manifest.