Converter CSV em tabela de texto alinhada

Ela analisa corretamente os campos entre aspas — vírgulas, ponto e vírgula e quebras de linha dentro das aspas —, calcula a largura de cada coluna, preenche cada célula para que as colunas fiquem alinhadas e desenha uma linha separadora sob o cabeçalho. Quando uma linha tem um número de campos diferente do cabeçalho, a chamada falha com um erro claro em vez de produzir uma tabela torta, a menos que você ative a opção lenient para preencher as linhas curtas com células vazias.

Por que converter CSV em uma tabela de largura fixa

CSV é o formato em que os dados viajam, mas é péssimo para ler. Uma coluna com valores longos empurra o campo seguinte para a direita em uma linha e não em outra, e a vista perde o alinhamento logo na segunda linha. As planilhas resolvem isso escondendo o texto por completo, que é exatamente o que você não quer quando o destino é um log de terminal, um comentário de pull request, um e-mail em texto puro ou documentação em Markdown.

Um conversor de csv para tabela de texto mantém os dados como texto — copiável, comparável com diff, pesquisável com grep — enquanto devolve a única coisa que a planilha oferecia: colunas alinhadas. Cole a exportação e receba um bloco em que cada campo ocupa a mesma posição em todas as linhas, com uma régua de hífens sob o cabeçalho.

Por ser texto puro, o resultado sobrevive a qualquer colagem em qualquer ferramenta, chat ou revisão de código sem perder a formatação, e se lê da mesma forma na tela de um celular e em um monitor ultrawide.

Como funcionam a análise e o alinhamento

O analisador segue as convenções do RFC 4180: um campo entre aspas duplas pode conter o delimitador, quebras de linha e aspas literais escritas como duas aspas duplas, e as linhas em branco são ignoradas. Isso importa na prática porque as exportações reais colocam aspas nos campos justamente quando eles contêm algo interessante: um endereço com vírgula, uma nota com ponto e vírgula, uma mensagem com quebra de linha. Depois da análise, o renderizador verifica se cada linha tem o mesmo número de campos da primeira.

Se alguma não tiver, a chamada falha com um erro que indica a linha e as duas contagens: uma linha com uma vírgula final faltando gera uma tabela visivelmente deslocada, e uma tabela deslocada é pior do que tabela nenhuma. Se preferir ver os dados mesmo assim, ative lenient e as linhas curtas serão preenchidas com células vazias até a largura da linha mais longa.

Em seguida, a largura de cada coluna é calculada como a célula mais longa, cada célula é preenchida até essa largura e as colunas são unidas com uma barra vertical. Quando a primeira linha é um cabeçalho, uma régua de hífens é desenhada abaixo dela. Tudo é determinístico: a mesma entrada sempre produz uma saída idêntica, byte a byte.

Delimitadores, cabeçalhos e uso no dia a dia

Nem todo CSV usa vírgula. As exportações europeias costumam usar ponto e vírgula, e muitos dumps de banco de dados usam tabulação ou barra vertical. Passe o caractere no campo delimiter e todo o resto funciona igual: campos entre aspas, detecção de erros e preenchimento leniente.

Se seus dados não têm linha de cabeçalho, defina header como false e a primeira linha será renderizada como dado, sem linha separadora. A capacidade roda na borda sem armazenar nada: o texto é analisado, renderizado e descartado. Os usuários típicos são scripts de release que imprimem uma tabela de resumo nos logs de CI, bots que respondem com uma tabela legível no chat e geradores de documentação que embutem dados de exemplo alinhados.

São aceitas entradas de até 1 MB e 50.000 linhas, o que cobre com folga qualquer exportação que uma pessoa colaria e a maioria das geradas por máquinas.