Convertire YAML senza incollarlo in un server

Come si verifica quello che promette

Quello che incolli non ha dove andare. La Content-Security-Policy elenca ogni indirizzo che questa pagina può contattare, e nessuno di questi è nostro. Qui non c'è nessun endpoint dove una configurazione incollata possa essere raccolta, e nel codice non c'è niente che ce la manderebbe se ci fosse.

Qui niente va a prendere niente. Non c'è nessun fetch, nessun XMLHttpRequest e nessun sendBeacon da nessuna parte in src/. Tutti e due i parser e tutti e due gli stampatori sono funzioni di questa pagina che prendono una stringa e restituiscono una stringa.

Legge YAML 1.2, quindi la Norvegia resta la Norvegia. In YAML 1.1 no era un booleano, ed è il famoso bug che trasforma il codice della Norvegia in false. Questo legge la 1.2, dove è la stringa che sembra. Nell'altra direzione quelle parole vengono riscritte tra virgolette, perché quello che aprirà il file dopo potrebbe essere ancora un lettore 1.1. tests/js/text-convert.test.js controlla tutte e due le metà.

Una conversione che non può essere onesta si ferma. Un'ancora, un alias o un tag nello YAML chiudono la conversione con un messaggio che dice su quale riga si trovano, invece di un documento JSON che di nascosto vuol dire un'altra cosa. JSON non ha modo di dire “lo stesso nodo due volte”, e scegliere un'interpretazione sarebbe scegliere al posto tuo.

Cosa carica Google, e cosa non gli arriva. Gli script della pubblicità e della misurazione arrivano da Google, e il pulsante delle donazioni da Buy Me a Coffee. A nessuno dei due viene passato un carattere del tuo testo. Ogni riga che lo legge, lo analizza o lo scrive è servita da questa origine ed è elencata nel repository.

Funziona offline. Stacca la rete e lo strumento è identico, perché un passo di rete non c'è mai stato. È la prova più semplice che ci sia.

Verifica tu stesso. Niente di quanto sopra va preso per buono. Questa pagina la genera, dai modelli e dalla configurazione del repository, uno script di build che puoi leggere ed eseguire anche tu, e il risultato finisce sul branch dist: puoi quindi confrontare quello che viene servito con quello che produce una build dei sorgenti.

github.com/A-Box-of-Tools/website

I file da leggere per primi sono config/site.toml per la Content-Security-Policy, src/shared/parse-yaml.js per il lettore che rifiuta un'ancora invece di indovinare cosa volesse dire, e src/convert.js per il motivo per cui una conversione è un parser e uno stampatore, senza niente in mezzo che conosca tutti e due i formati insieme.

Se il software di sicurezza della tua azienda segnala un caricamento. Osserva il momento in cui un file viene scelto nel browser, e non può sapere se la pagina intende inviarlo — quindi avvisa alla scelta. Qui non viene inviato nulla: apri gli strumenti per sviluppatori, vai su Rete e scegli un file. Non c'è nessuna richiesta che lo trasporti, e nessuna richiesta a parte l'anteprima locale della pagina. È la stessa verifica che il tuo reparto IT può fare in mezzo minuto.

1 Scegli la direzione

Rientro La tabulazione è offerta solo per il JSON. Lo YAML è definito in termini di spazi e una tabulazione non è un'indentazione valida al suo interno.

Ordina le chiavi di ogni oggetto In base a come si leggono le chiavi invece che ai loro code point, quindi item2 viene prima di item10.

Converti

Rientro

Ordina le chiavi di ogni oggetto

2 Incollalo

Trascina qui un file oppure clicca per sceglierlo — un file .yaml, .yml o .json

Il tuo YAML vuoto

3 Prenditi il risultato

{reason} (riga {line}, colonna {column}) la fine del testo un a capo una tabulazione «{ch}» Inatteso: {found} dopo la fine del valore Il testo finisce troppo presto Una chiave deve essere una stringa fra virgolette doppie, e questo è {found} Attesi i due punti dopo la chiave, trovato {found} Inatteso: {found} Attesa una virgola o una graffa di chiusura, trovato {found} Attesa una virgola o una quadra di chiusura, trovato {found} Questo oggetto non viene mai chiuso Questo array non viene mai chiuso Questa stringa non viene mai chiusa Dopo \u devono esserci quattro cifre esadecimali \{next} non è un escape che JSON conosca Un carattere di controllo grezzo dentro una stringa — scrivilo come escape Questo non è un numero che JSON permetta Questa riga è rientrata meno del blocco in cui si trova Più di un documento in questo file. Convertili uno alla volta. Questa riga è rientrata più della chiave sopra Qui era atteso «key: value» Gli alias (*name) non sono supportati — JSON non ha modo di dire «lo stesso nodo due volte» I tag (!name) non sono supportati — il tipo andrebbe indovinato Qui una chiave «?» non è supportata «{header}» non è uno scalare a blocco che questo legga C'è del testo dopo la virgoletta di chiusura Le ancore (&name) non sono supportate — JSON non ha modo di dire «lo stesso nodo due volte» Dopo \{next} servono {width} cifre esadecimali \{next} non è un escape che questo legga Questa stringa fra virgolette non viene mai chiusa C'è del testo dopo la fine della collezione in flow La collezione in flow finisce troppo presto Attesa una virgola o una quadra di chiusura in questa sequenza in flow Attesi i due punti dopo una chiave in questo mapping in flow Attesa una virgola o una graffa di chiusura in questo mapping in flow Da YAML a JSON Da JSON a YAML I commenti si perdono, perché JSON non ha dove metterne uno. Ancore, alias e tag fermano la conversione invece di essere indovinati. Non si perde niente: ogni documento JSON è già un documento YAML. Le stringhe vengono messe fra virgolette solo dove lasciarle nude cambierebbe quello che dicono. Il tuo YAML Il tuo JSON Incolla qui lo YAML - oppure trascina sopra un file .yaml, .yml o .json. Incolla qui il JSON - oppure trascina sopra un file .json, .yaml o .yml. {n} B {n} KB {n} MB Sto leggendo il file… Quel file non è stato letto: {reason} Ancora niente. Non è uscito niente. {name} — {lines} righe, {size} Copia Copiato Selezionato — premi Ctrl+C Il tuo testo non è andato da nessuna parte. {total} file caricati. {platform} Qualcosa ha contattato {hosts}, e questo strumento non lo fa mai. {platform} Gli script del sito per la pubblicità, la misurazione e il pulsante delle donazioni sono arrivati da {hosts} host; a nessuno di questi è arrivato neanche un carattere. Gli script del sito per la pubblicità, la misurazione e il pulsante delle donazioni sono arrivati da {hosts} host; a nessuno di questi è arrivato neanche un carattere.

# Da YAML a JSON — e da JSON di nuovo a YAML Tutte e due le direzioni, e ti dice quanto costa ciascuna. Niente di tutto questo finisce incollato nel server di qualcun altro. > Converti YAML in JSON e JSON in YAML nel tuo browser. Legge YAML 1.2, quindi yes e no restano stringhe, e dice esattamente cosa perde ogni direzione. Non viene caricato niente: un file di configurazione non lascia mai il tuo dispositivo. Questa pagina è uno strumento interattivo che funziona interamente nel tuo browser, all'indirizzo https://abox.tools/it/convertire-yaml-in-json/ — nulla di ciò che gli affidi viene caricato. Quanto segue è tutto ciò che la pagina dice dello strumento a parole; per usarlo, apri l'indirizzo. ## Qui non si caricano file YAML e JSON, **mai**. Non c'è nessun server. Convertire è aritmetica su una stringa, fatta qui, in questa pagina. I due parser sono scritti a mano e stanno in `src/` — `shared/parse-yaml.js` e `shared/parse-json.js` — e non c'è nient'altro. Questo strumento non ha nessuna funzione di rete di alcun tipo — niente da scaricare, niente da mandare — e qui conta più che quasi ovunque su questo sito: un file YAML di solito è una configurazione di deploy, e una configurazione di deploy di solito è piena di nomi di host, nomi di bucket e segreti. - ✗ Niente caricamenti - ✗ Nessun account - ✗ Nessun limite di dimensione - ✓ Funziona offline - ✓ Open source ## Come convertire YAML in JSON senza caricarlo 1. **Scegli la direzione.** *Da YAML a JSON* oppure *da JSON a YAML*. La nota sotto il menù dice cosa perde quella direzione prima che tu incolli qualcosa, non dopo. 2. **Incollalo, oppure trascina il file.** Va bene qualunque cosa tu possa selezionare e copiare. Un file trascinato sul selettore viene letto dal tuo browser e messo nella casella — non c'è nessun passo di caricamento da saltare — e un'estensione `.json` o `.yaml` ti imposta la direzione. 3. **Scegli l'indentazione.** Due spazi, quattro, oppure una tabulazione. La tabulazione è offerta solo per il JSON: lo YAML è definito in termini di spazi, e una tabulazione non è un'indentazione valida al suo interno. 4. **Leggi l'errore dove sta l'errore.** Un parser che qui fallisce dice cosa ha trovato e su quale riga e colonna, invece di “token inatteso alla posizione 4193”. Di solito basta per sistemare un file di configurazione senza aprire nient'altro. 5. **Prenditi il risultato.** Copialo, oppure scaricalo come file, con il nome del formato in cui è uscito. ## Anche nella cassetta - [Formattatore XML](https://abox.tools/it/formattare-xml/): XML sistemato per leggerlo o compattato per spedirlo, e convertito in JSON in tutte e due le direzioni. Niente di tutto questo finisce incollato nel server di qualcun altro. - [Confronto testi](https://abox.tools/it/confrontare-testi/): Due testi dentro, ogni differenza segnata, riga per riga e parola per parola. Niente finisce incollato nel server di qualcun altro. - [Codificatore e decodificatore Base64](https://abox.tools/it/codifica-base64/): Base64, codifica percentuale, entità HTML, esadecimale ed escape con barra rovesciata, in entrambi i versi. Niente finisce incollato nel server di qualcun altro. - [Condividere testo e file](https://abox.tools/it/condividere-testo/): La condivisione vive in questa scheda aperta. I lettori la ricevono cifrata, direttamente dal tuo browser, e chiudere la scheda la fa finire: nessun server conserva nulla. ## Domande ### Il mio YAML viene caricato da qualche parte? No. Tutti e due i parser e tutti e due gli stampatori di questa pagina sono funzioni che girano nel tuo browser, sul tuo hardware. Questo strumento non ha nessuna funzione di rete di alcun tipo — non scarica mai niente e non manda mai niente — e la `Content-Security-Policy` della pagina elenca ogni indirizzo che può contattare, e nessuno di questi è nostro. È proprio questo il motivo per usarlo su una configurazione di deploy: sono piene di nomi di host, nomi di bucket e ogni tanto di un segreto che qualcuno voleva spostare, e incollarne una nel convertitore di qualcun altro vuol dire dargliela. ### Cosa si perde convertendo YAML in JSON? I commenti, perché JSON non ha dove metterli. Ancore, alias e tag vengono rifiutati del tutto invece che indovinati — ognuno di loro dice qualcosa che JSON non sa dire, e un convertitore che scegliesse di nascosto un'interpretazione ti darebbe un documento che non è quello che diceva il file. L'altra direzione non perde niente: ogni documento JSON è già un documento YAML. ### Il mio YAML dice no e il JSON è uscito come stringa. Perché? Perché è una stringa, e qui si legge YAML 1.2 invece di 1.1. In YAML 1.1 `yes`, `no`, `on` e `off` erano booleani, ed è il famoso bug che trasforma il codice della Norvegia in `false`. YAML 1.2 ha lasciato perdere, e anche questo: solo `true`, `false`, `null` e `~` vengono letti come qualcosa di diverso dal testo. Nell'altra direzione quelle parole vengono riscritte *tra virgolette*, anche se qui verrebbero lette come testo pure senza, perché quello che aprirà il file dopo magari no. PyYAML usa ancora la 1.1 come impostazione predefinita. Leggere in modo severo e scrivere in modo prudente è l'unica combinazione giusta in tutte e due le direzioni. ### Mantiene l'ordine delle mie chiavi? Sì, in tutte e due le direzioni, ed è più difficile di quanto sembri. Un convertitore costruito su `JSON.parse` sposta di nascosto in testa le chiavi che sembrano interi, quindi `{"10":a,"2":b}` torna come `{"2":b,"10":a}`. I numeri tengono le cifre che hai scritto, quindi un id di conto da venti cifre non perde le ultime tre per colpa di un double. Se invece li *vuoi* ordinati c'è una casella, e ordina in base a come si leggono le chiavi invece che ai loro code point. ### Può convertire più documenti YAML in una volta? No, e lo dice invece di sceglierne uno. Un file con separatori `---` contiene più di un documento, e JSON non ha nessuna forma che voglia dire “più documenti”: un array sarebbe un'affermazione che il file non ha mai fatto. Convertili uno alla volta. ### Perché qui non c'è un formattatore YAML? Perché lo YAML non ha una forma compattata che valga la pena scrivere: la forma corta è lo stile flow, che è illeggibile, e illeggibile è il contrario del motivo per cui si tiene un file in YAML. Sistemare JSON, XML, HTML e CSS è il lavoro del [formattatore JSON](https://abox.tools/it/formattare-json/), e quello sistema anche lo YAML. ### Quanto può essere grande il file? Qui non c'è nessun limite impostato, perché non c'è un server che lo paga. Il tetto vero è il tuo dispositivo: qualche megabyte di YAML va bene, e con un documento molto lungo la pagina aspetta una pausa nella tua digitazione prima di convertire, invece di litigarti la tastiera. ### È gratis, e mi serve un account? È gratis, e non c'è account, non c'è registrazione, non c'è periodo di prova e non c'è limite a quanto incolli. Il sito ha della pubblicità, ed è quella che lo mantiene; agli annunci non arriva niente sul tuo testo. ### Funziona offline? Sì. Carica la pagina una volta, poi stacca internet e continua a funzionare. È anche il modo più semplice per dimostrare che non viene caricato niente: uno strumento che mandasse via la tua configurazione per convertirla si fermerebbe nel momento in cui stacchi la spina. ## Come si verifica quello che promette - **Quello che incolli non ha dove andare.** La Content-Security-Policy elenca ogni indirizzo che questa pagina può contattare, e nessuno di questi è nostro. Qui non c'è nessun endpoint dove una configurazione incollata possa essere raccolta, e nel codice non c'è niente che ce la manderebbe se ci fosse. - **Qui niente va a prendere niente.** Non c'è nessun `fetch`, nessun `XMLHttpRequest` e nessun `sendBeacon` da nessuna parte in `src/`. Tutti e due i parser e tutti e due gli stampatori sono funzioni di questa pagina che prendono una stringa e restituiscono una stringa. - **Legge YAML 1.2, quindi la Norvegia resta la Norvegia.** In YAML 1.1 `no` era un booleano, ed è il famoso bug che trasforma il codice della Norvegia in `false`. Questo legge la 1.2, dove è la stringa che sembra. Nell'altra direzione quelle parole vengono riscritte *tra virgolette*, perché quello che aprirà il file dopo potrebbe essere ancora un lettore 1.1. `tests/js/text-convert.test.js` controlla tutte e due le metà. - **Una conversione che non può essere onesta si ferma.** Un'ancora, un alias o un tag nello YAML chiudono la conversione con un messaggio che dice su quale riga si trovano, invece di un documento JSON che di nascosto vuol dire un'altra cosa. JSON non ha modo di dire “lo stesso nodo due volte”, e scegliere un'interpretazione sarebbe scegliere al posto tuo. - **Cosa carica Google, e cosa non gli arriva.** Gli script della pubblicità e della misurazione arrivano da Google, e il pulsante delle donazioni da Buy Me a Coffee. A nessuno dei due viene passato un carattere del tuo testo. Ogni riga che lo legge, lo analizza o lo scrive è servita da questa origine ed è elencata nel repository. - **Funziona offline.** Stacca la rete e lo strumento è identico, perché un passo di rete non c'è mai stato. È la prova più semplice che ci sia. **Verifica tu stesso.** Niente di quanto sopra va preso per buono. Questa pagina la genera, dai modelli e dalla configurazione del repository, uno script di build che puoi leggere ed eseguire anche tu, e il risultato finisce sul branch `dist`: puoi quindi confrontare quello che viene servito con quello che produce una build dei sorgenti. https://github.com/A-Box-of-Tools/website I file da leggere per primi sono `config/site.toml` per la Content-Security-Policy, `src/shared/parse-yaml.js` per il lettore che rifiuta un'ancora invece di indovinare cosa volesse dire, e `src/convert.js` per il motivo per cui una conversione è un parser e uno stampatore, senza niente in mezzo che conosca tutti e due i formati insieme.

Domande

Il mio YAML viene caricato da qualche parte?

No. Tutti e due i parser e tutti e due gli stampatori di questa pagina sono funzioni che girano nel tuo browser, sul tuo hardware. Questo strumento non ha nessuna funzione di rete di alcun tipo — non scarica mai niente e non manda mai niente — e la Content-Security-Policy della pagina elenca ogni indirizzo che può contattare, e nessuno di questi è nostro. È proprio questo il motivo per usarlo su una configurazione di deploy: sono piene di nomi di host, nomi di bucket e ogni tanto di un segreto che qualcuno voleva spostare, e incollarne una nel convertitore di qualcun altro vuol dire dargliela.

Cosa si perde convertendo YAML in JSON?

I commenti, perché JSON non ha dove metterli. Ancore, alias e tag vengono rifiutati del tutto invece che indovinati — ognuno di loro dice qualcosa che JSON non sa dire, e un convertitore che scegliesse di nascosto un'interpretazione ti darebbe un documento che non è quello che diceva il file. L'altra direzione non perde niente: ogni documento JSON è già un documento YAML.

Il mio YAML dice no e il JSON è uscito come stringa. Perché?

Perché è una stringa, e qui si legge YAML 1.2 invece di 1.1. In YAML 1.1 yes, no, on e off erano booleani, ed è il famoso bug che trasforma il codice della Norvegia in false. YAML 1.2 ha lasciato perdere, e anche questo: solo true, false, null e ~ vengono letti come qualcosa di diverso dal testo. Nell'altra direzione quelle parole vengono riscritte tra virgolette, anche se qui verrebbero lette come testo pure senza, perché quello che aprirà il file dopo magari no. PyYAML usa ancora la 1.1 come impostazione predefinita. Leggere in modo severo e scrivere in modo prudente è l'unica combinazione giusta in tutte e due le direzioni.

Mantiene l'ordine delle mie chiavi?

Sì, in tutte e due le direzioni, ed è più difficile di quanto sembri. Un convertitore costruito su JSON.parse sposta di nascosto in testa le chiavi che sembrano interi, quindi {"10":a,"2":b} torna come {"2":b,"10":a}. I numeri tengono le cifre che hai scritto, quindi un id di conto da venti cifre non perde le ultime tre per colpa di un double. Se invece li vuoi ordinati c'è una casella, e ordina in base a come si leggono le chiavi invece che ai loro code point.

Può convertire più documenti YAML in una volta?

No, e lo dice invece di sceglierne uno. Un file con separatori --- contiene più di un documento, e JSON non ha nessuna forma che voglia dire “più documenti”: un array sarebbe un'affermazione che il file non ha mai fatto. Convertili uno alla volta.

Perché qui non c'è un formattatore YAML?

Perché lo YAML non ha una forma compattata che valga la pena scrivere: la forma corta è lo stile flow, che è illeggibile, e illeggibile è il contrario del motivo per cui si tiene un file in YAML. Sistemare JSON, XML, HTML e CSS è il lavoro del formattatore JSON, e quello sistema anche lo YAML.

Quanto può essere grande il file?

Qui non c'è nessun limite impostato, perché non c'è un server che lo paga. Il tetto vero è il tuo dispositivo: qualche megabyte di YAML va bene, e con un documento molto lungo la pagina aspetta una pausa nella tua digitazione prima di convertire, invece di litigarti la tastiera.

È gratis, e mi serve un account?

È gratis, e non c'è account, non c'è registrazione, non c'è periodo di prova e non c'è limite a quanto incolli. Il sito ha della pubblicità, ed è quella che lo mantiene; agli annunci non arriva niente sul tuo testo.

Funziona offline?

Sì. Carica la pagina una volta, poi stacca internet e continua a funzionare. È anche il modo più semplice per dimostrare che non viene caricato niente: uno strumento che mandasse via la tua configurazione per convertirla si fermerebbe nel momento in cui stacchi la spina.