Convertire YAML in XML

Ogni chiave diventa un elemento e il suo valore diventa il contenuto di quell’elemento. Una mappa annidata diventa un elemento annidato, indentato due spazi per livello.

I valori sono scritti come testo, perché è tutto ciò che un elemento XML può contenere. Un numero YAML scritto 1.50 esce come 1.5, perché il parser lo aveva già risolto in un numero.

XML richiede esattamente un elemento più esterno e un documento YAML può avere diverse chiavi di primo livello. La regola: una chiave di primo livello diventa la radice, qualunque cosa contenga, a meno che non sia una lista.

Una singola chiave di primo livello che contiene una lista è il caso che sorprende. Ottiene comunque il wrapper generico, perché usare la chiave come radice ripeterebbe quel tag una volta per elemento.

Una sequenza YAML sotto una chiave emette quella chiave una volta per elemento. Tre comandi build sotto una chiave script diventano tre elementi script in ordine, fratelli tra loro.

Non è l’unico idioma. Molti schemi vogliono un wrapper plurale contenente figli singolari — un elemento dependencies con diversi elementi dependency. Questo scrittore non lo produrrà da una semplice lista.

XML solo-elementi va bene per i dati e sbagliato per la maggior parte degli schemi reali, che mettono identificatori e codici lingua negli attributi. Due nomi di chiave danno controllo.

Una chiave che inizia con @ diventa un attributo sull’elemento contenitore con la @ tolta, e una chiave chiamata #text diventa il testo proprio dell’elemento.

I nomi elemento XML permettono lettere, cifre, underscore, trattino e punto, e non possono iniziare con una cifra. Le chiavi YAML permettono essenzialmente qualsiasi cosa.

Ogni carattere che lo scrittore non può usare diventa un underscore, e un nome che inizia con una cifra viene preceduto da uno. La sostituzione perde informazione e può collidere.

Non c’è dichiarazione XML, quindi il file inizia con il primo tag. Non c’è DOCTYPE, nessuna dichiarazione namespace e nessun riferimento schema.

Per un’integrazione questo è di solito un divario da colmare a mano, ed è piccolo: una riga di dichiarazione, un attributo xmlns sulla radice.

Una chiave YAML senza valore diventa una coppia di elementi vuota. XML non può distinguerla da un elemento che contiene una stringa vuota.

Un blocco scalare multilinea viene scritto con i suoi a capo intatti dentro l’elemento, il che è XML valido — ma se il parser ricevente preserva quello spazio bianco dipende dallo schema.

Due problemi sorgente fermano la conversione piuttosto che degradarla. Un file contenente separatori --- contiene diversi documenti YAML, e un file XML ne contiene uno solo.

Una chiave duplicata nella stessa mappa viene anche rifiutata, con il numero di riga, più severo di certi strumenti YAML e corretto — una chiave duplicata significa che una delle due impostazioni è stata ignorata.