Convertire CSV in tabella di testo allineata

Analizza correttamente i campi tra virgolette — virgole, punti e virgola e interruzioni di riga dentro le virgolette —, calcola la larghezza di ogni colonna, riempie ogni cella affinché le colonne risultino allineate e traccia una linea separatrice sotto l'intestazione. Quando una riga ha un numero di campi diverso dall'intestazione, la chiamata fallisce con un errore chiaro invece di produrre una tabella storta, a meno che Lei non attivi l'opzione lenient per riempire le righe corte con celle vuote.

Perché convertire un CSV in una tabella a larghezza fissa

Il CSV è il formato in cui viaggiano i dati, ma è un formato pessimo da leggere. Una colonna con valori lunghi spinge il campo successivo molto a destra in una riga e non in un'altra, e l'occhio perde l'allineamento dopo due righe. I fogli di calcolo risolvono il problema nascondendo del tutto il testo, che è esattamente ciò che Lei non vuole quando la destinazione è un log di terminale, un commento di pull request, un'e-mail in testo semplice o documentazione in Markdown.

Un convertitore da csv a tabella di testo mantiene i dati come testo — copiabile, confrontabile con diff, ricercabile con grep — restituendo l'unica cosa che il foglio di calcolo offriva: colonne allineate. Incolli l'esportazione e ottenga un blocco in cui ogni campo occupa la stessa posizione in tutte le righe, con una riga di trattini sotto l'intestazione.

Essendo testo semplice, il risultato sopravvive a qualsiasi incollaggio in qualsiasi strumento, chat o revisione di codice senza perdere la formattazione, e si legge allo stesso modo sullo schermo di un telefono e su un monitor panoramico.

Come funzionano l'analisi e l'allineamento

L'analizzatore segue le convenzioni dell'RFC 4180: un campo tra virgolette doppie può contenere il delimitatore, interruzioni di riga e virgolette letterali scritte come due virgolette doppie, e le righe vuote vengono ignorate. Questo conta nella pratica perché le esportazioni reali mettono tra virgolette i campi proprio quando contengono qualcosa di interessante: un indirizzo con una virgola, una nota con un punto e virgola, un messaggio con un'interruzione di riga. Dopo l'analisi, il motore di rendering verifica che ogni riga abbia lo stesso numero di campi della prima.

Se non è così, la chiamata fallisce con un errore che indica la riga ed entrambi i conteggi: una riga a cui manca una virgola finale produce una tabella visibilmente spostata, e una tabella spostata è peggio di nessuna tabella. Se preferisce vedere comunque i dati, attivi lenient e le righe corte verranno riempite con celle vuote fino alla larghezza della riga più lunga.

La larghezza di ogni colonna viene quindi calcolata come la cella più lunga, ogni cella viene riempita fino a quella larghezza e le colonne vengono unite con una barra verticale. Quando la prima riga è un'intestazione, sotto di essa viene tracciata una riga di trattini. Tutto è deterministico: lo stesso input produce sempre un output identico, byte per byte.

Delimitatori, intestazioni e uso quotidiano

Non tutti i CSV usano la virgola. Le esportazioni europee usano spesso il punto e virgola, e molti dump di database usano la tabulazione o la barra verticale. Passi il carattere nel campo delimiter e tutto il resto funziona allo stesso modo: campi tra virgolette, rilevamento degli errori e riempimento tollerante.

Se i Suoi dati non hanno una riga di intestazione, imposti header su false e la prima riga verrà renderizzata come dato, senza linea separatrice. La capacità viene eseguita all'edge senza memorizzare nulla: il testo viene analizzato, renderizzato ed eliminato. Gli utenti tipici sono script di rilascio che stampano una tabella riepilogativa nei log di CI, bot che rispondono con una tabella leggibile in chat e generatori di documentazione che incorporano dati di esempio allineati.

Sono accettati input fino a 1 MB e 50.000 righe, il che copre ampiamente qualsiasi esportazione che una persona incollerebbe e la maggior parte di quelle generate dalle macchine.