Spostare dati tra CSV, JSON, YAML e XML
I dati raramente rimangono fermi in un unico formato. Un report arriva come foglio di calcolo, un'API vuole JSON, una pipeline di deploy si aspetta YAML e da qualche parte in cantina un servizio legacy parla ancora XML. La maggior parte dell'attrito quotidiano nel lavorare con i dati non riguarda i dati stessi, ma il trasformarli dalla forma che hai in quella che qualcos'altro richiede. Questo è il compito di un convertitore di dati: prendere del testo strutturato in una notazione e riemetterlo in un'altra, senza perdere il significato lungo la strada.
I convertitori di Speedor girano interamente nel tuo browser. Incolli, clicchi, copi il risultato. Niente viene caricato, niente viene registrato e niente lascia il tuo dispositivo. Per chiunque abbia mai esitato prima di incollare un export di clienti su un sito web a caso, questa progettazione solo locale è il punto centrale.
A cosa serve davvero ogni formato
È utile sapere perché questi formati esistono prima di iniziare a passare dall'uno all'altro, perché ognuno è stato creato per un compito diverso.
CSV è la griglia piatta, separata da virgole, che i fogli di calcolo adorano. È tabellare per natura: righe e colonne, niente di nidificato. Aprilo in Excel, Google Sheets o Numbers e funziona e basta. Il problema è che il CSV non ha il concetto di tipi. Il valore 007 potrebbe essere una stringa, un numero o un codice postale, e CSV non te lo dirà.
JSON è la lingua franca del web moderno. Quasi ogni API che chiamerai parla JSON. JSON gestisce nidificazione, array e una manciata di tipi reali (stringhe, numeri, booleani, null), il che lo rende molto più espressivo di una tabella piatta. È compatto, adatto alle macchine e supportato ovunque.
YAML è il cugino più leggibile di JSON. Usa l'indentazione invece delle parentesi, supporta i commenti e tende a essere il formato preferito per i file di configurazione, Docker Compose, i manifest Kubernetes e le pipeline CI. Quando un essere umano deve modificare qualcosa a mano, YAML è di solito più gentile per gli occhi.
XML è il veterano. Verboso, pieno di tag e ancora profondamente radicato nei sistemi enterprise, nei servizi SOAP, nella messaggistica finanziaria e negli standard di documento come RSS. Lo incontrerai meno spesso nei progetti moderni, ma quando ne hai bisogno, ne hai davvero bisogno.
Dove avvengono davvero le conversioni
Gli scenari sono abbastanza concreti una volta che inizi a guardarli. Supponi che il marketing ti consegni un foglio di calcolo di 4.000 contatti e l'API di registrazione accetti solo un array JSON. Esporti il foglio in CSV, lo passi attraverso CSV in JSON e hai un payload pronto per il POST. Nessuno script di collegamento, nessun pandas, nessuna attesa di un ingegnere.
Oppure ricevi un blocco di JSON da quell'API e vuoi inserirlo in un file di configurazione che il tuo servizio legge all'avvio. Convertilo con JSON in YAML e ottieni qualcosa di pulito e commentabile che si integra perfettamente nel tuo repository. Il percorso inverso funziona anche quando uno strumento accetta solo JSON ma la tua configurazione vive in YAML.
E poi c'è l'integrazione che nessuno ama: un sistema partner che accetta solo XML. Costruisci il payload in JSON perché è così che ragiona la tua app, poi converti in XML al confine. La forma rimane la stessa, cambia solo la sintassi.
I trabocchetti da conoscere
La conversione di formato non è sempre senza perdite, e fingere il contrario porta a bug. Alcune cose da tenere a mente:
Il CSV dimentica i tipi. Poiché ogni cella è solo testo, numeri, booleani e date escono tutti come stringhe a meno che il convertitore non tenti di indovinare per te. Se true deve essere un booleano e non la parola "true", controlla l'output prima di inviarlo.
YAML si preoccupa degli spazi bianchi. L'indentazione in YAML non è estetica, è strutturale. Uno spazio fuori posto può cambiare a quale chiave appartiene un valore, e i tab sono vietati del tutto. Dopo qualsiasi conversione da JSON a YAML, vale la pena un'occhiata rapida, o fai girare il risultato di nuovo attraverso un formatter JSON per confermare che la struttura sia sopravvissuta.
XML e JSON non si mappano in modo pulito. JSON ha gli array; XML ha elementi ripetuti. JSON non ha attributi da nessuna parte; XML li ha ovunque. La maggior parte dei convertitori sceglie una convenzione sensata, ma se il tuo XML usa molto gli attributi, il JSON prodotto sembrerà un po' diverso dal JSON scritto a mano. È previsto, non un difetto.
La profondità di nidificazione conta. Il CSV è piatto, quindi il JSON profondamente nidificato non può sempre ridursi in colonne senza appiattire le chiavi (pensa a address.city). Nel percorso inverso, un CSV piatto diventa un array piatto, mai un albero.
Perché l'elaborazione locale è importante qui
Molti dei dati che vorrai convertire non sono tuoi da condividere. Record degli utenti, configurazioni interne, chiavi API sepolte in una risposta, righe finanziarie. Molti convertitori online inviano silenziosamente il tuo testo a un server per svolgere il lavoro. Speedor no. La logica di conversione gira nella scheda del tuo browser, i dati non attraversano mai la rete e chiudere la scheda è tutto il cleanup necessario. È anche più veloce, poiché non c'è round trip di upload, e funziona offline una volta che la pagina è stata caricata. Gratuito, senza registrazione, senza quota.
Domande frequenti
I miei dati vengono caricati da qualche parte quando li converto?
No. Ogni conversione gira localmente nel tuo browser usando JavaScript. I tuoi dati non lasciano mai il dispositivo e non vengono mai inviati a un server, motivo per cui questi strumenti funzionano anche quando sei offline.
Posso convertire CSV in JSON senza scrivere codice?
Sì. Incolla il tuo CSV nel convertitore, clicca su converti e copia l'array JSON risultante. La prima riga viene trattata come intestazioni delle colonne, che diventano le chiavi per ogni oggetto.
Perché il mio JSON convertito mostra i numeri come stringhe?
Il CSV non ha il concetto di tipi di dati, quindi ogni valore inizia come testo. Alcuni convertitori cercano di rilevare automaticamente numeri e booleani, ma in caso di dubbio mantengono i valori come stringhe per evitare di corrompere cose come codici postali o ID con zeri iniziali.
Qual è la differenza tra JSON e YAML?
Rappresentano gli stessi tipi di dati, ma YAML usa l'indentazione invece di parentesi graffe e quadre, consente commenti ed è generalmente più facile da leggere e modificare per le persone. JSON è più compatto ed è il formato predefinito per la maggior parte delle API web.
La conversione tra questi formati è sempre senza perdite?
Di solito, ma non sempre. JSON, YAML e XML si mappano bene l'uno sull'altro nella maggior parte dei casi. Le coppie più difficili sono CSV, che è piatto e senza tipi, e XML, che gestisce attributi ed elementi ripetuti in modo diverso dagli array JSON. Controlla sempre l'output per i dati importanti.
Questi convertitori funzionano su file di grandi dimensioni?
Gestiscono comodamente la maggior parte dei file quotidiani poiché il lavoro avviene sul tuo dispositivo. Le prestazioni dipendono dal tuo hardware piuttosto che da un server, quindi i file molto grandi sono limitati principalmente dalla memoria del tuo browser.