CSV als Texttabelle anzeigen

Sie verarbeitet Felder in Anführungszeichen korrekt — Kommas, Semikolons und Zeilenumbrüche innerhalb der Anführungszeichen —, berechnet die Breite jeder Spalte, füllt jede Zelle auf, damit die Spalten bündig stehen, und zeichnet eine Trennlinie unter der Kopfzeile. Wenn eine Zeile eine andere Feldanzahl als die Kopfzeile hat, schlägt der Aufruf mit einem klaren Fehler fehl, statt eine schiefe Tabelle zu erzeugen — es sei denn, Sie setzen die Option lenient, um kurze Zeilen mit leeren Zellen aufzufüllen.

Warum CSV als Tabelle mit fester Breite darstellen

CSV ist das Format, in dem Daten reisen, aber es ist ein miserables Format zum Lesen. Eine Spalte mit langen Werten schiebt das nächste Feld in einer Zeile weit nach rechts und in einer anderen nicht, sodass das Auge die Ausrichtung nach zwei Zeilen verliert. Tabellenkalkulationen lösen das, indem sie den Text vollständig verstecken — genau das, was Sie nicht wollen, wenn das Ziel ein Terminal-Protokoll, ein Pull-Request-Kommentar, eine Nur-Text-E-Mail oder Dokumentation in Markdown ist.

Ein CSV zu ASCII-Tabelle-Renderer bewahrt die Daten als Text — kopierbar, mit diff vergleichbar, mit grep durchsuchbar — und stellt das eine wieder her, was die Tabellenkalkulation bot: Spalten, die bündig stehen. Fügen Sie den Export ein und erhalten Sie einen Block, in dem jedes Feld in jeder Zeile an derselben Position steht, mit einer Strichlinie aus Bindestrichen unter der Kopfzeile.

Weil die Ausgabe reiner Text ist, übersteht sie jedes Einfügen in jedes Werkzeug, jeden Chat und jede Code-Review ohne Neuformatierung, und sie liest sich auf einem Telefonbildschirm genauso wie auf einem breiten Monitor.

Wie Parsing und Ausrichtung funktionieren

Der Parser folgt den Konventionen von RFC 4180: Ein Feld in doppelten Anführungszeichen darf das Trennzeichen, Zeilenumbrüche und literale Anführungszeichen enthalten, die als zwei doppelte Anführungszeichen geschrieben werden; leere Zeilen werden ignoriert. Das ist in der Praxis wichtig, weil echte Exporte Felder genau dann in Anführungszeichen setzen, wenn sie etwas Interessantes enthalten — eine Adresse mit Komma, eine Notiz mit Semikolon, eine Nachricht mit Zeilenumbruch. Nach dem Parsen prüft der Renderer, ob jede Zeile dieselbe Feldanzahl wie die erste Zeile hat.

Ist das nicht der Fall, schlägt der Aufruf mit einem Fehler fehl, der die Zeile und beide Zählwerte nennt: Eine Zeile mit einem fehlenden abschließenden Komma erzeugt eine sichtbar verschobene Tabelle, und eine verschobene Tabelle ist schlimmer als gar keine Tabelle. Wenn Sie die Daten trotzdem sehen möchten, setzen Sie lenient auf true; kurze Zeilen werden dann mit leeren Zellen bis zur breitesten Zeile aufgefüllt. Anschließend wird die Breite jeder Spalte als längste Zelle berechnet, jede Zelle auf diese Breite aufgefüllt und die Spalten mit einem senkrechten Strich verbunden.

Wenn die erste Zeile eine Kopfzeile ist, wird darunter eine Linie aus Bindestrichen gezeichnet. Alles ist deterministisch: Dieselbe Eingabe erzeugt immer eine byteidentische Ausgabe.

Trennzeichen, Kopfzeilen und der Alltag

Nicht jedes CSV verwendet Kommas. Europäische Exporte nutzen häufig Semikolons, und viele Datenbank-Dumps verwenden Tabulatoren oder senkrechte Striche. Übergeben Sie das Zeichen im Feld delimiter, und alles andere funktioniert gleich — Felder in Anführungszeichen, Fehlererkennung, toleranten Auffüllung.

Wenn Ihre Daten keine Kopfzeile haben, setzen Sie header auf false; die erste Zeile wird dann als Datenzeile ohne Trennlinie dargestellt. Die Fähigkeit läuft am Edge, ohne etwas zu speichern: Der Text wird geparst, dargestellt und verworfen. Typische Anwender sind Release-Skripte, die eine Zusammenfassungstabelle in CI-Protokolle schreiben, Bots, die im Chat mit einer lesbaren Tabelle antworten, und Dokumentationsgeneratoren, die ausgerichtete Beispieldaten einbetten.

Eingaben bis zu 1 MB und 50.000 Zeilen werden akzeptiert — das deckt jeden Export ab, den ein Mensch einfügen würde, und die meisten maschinell erzeugten.