csv-converter-skart 0.2.0

CLI para conversão e sanitização de arquivos de tabelas de dados.

csv-converter-skart

Ferramenta de linha de comando para converter e sanitizar arquivos de planilha, com foco em dados inconsistentes e geração de arquivos CSV com suporte a pandas.

English version

Visão geral

O projeto converte arquivos .xlsx, .xls e .csv para CSV, aplicando etapas de normalização úteis para cenários em que a origem contém problemas de estrutura, conteúdo ou codificação.

Principais recursos:

• Conversão de planilhas para CSV.
• Normalização de arquivos CSV com saída em UTF-8.
• Sanitização de XML interno de arquivos XLSX.
• Detecção de codificação para arquivos CSV.
• Interface de linha de comando e uso programático via módulo Python.

Requisitos

• Python >= 3.10

Instalação

pip install csv-converter-skart

Uso

Linha de comando

Se apenas o arquivo de entrada for informado, o diretório File{NomeDoArquivo}Normalized será criado no diretório atual. O CSV gerado manterá o nome base do arquivo original.

csv-converter ./meus_arquivos/arquivo.xlsx

Para definir explicitamente o arquivo de saída, use -o ou --output.

csv-converter ./meus_arquivos/arquivo.xlsx --output ./csv/arquivo_normalizado.csv

Para exibir a ajuda da CLI:

csv-converter --help

Uso como módulo

O pacote também expõe a função csv_converter, que pode ser importada diretamente.

import pandas as pd
from pathlib import Path

from csv_converter import csv_converter

input_file = Path("csv_converter/tests/fixtures/input_files/original.xlsx")
output_file = Path("csv_converter/tests/artifacts/original.csv")

generated_file = csv_converter(input_file, output_file)
dataframe = pd.read_csv(generated_file)

print(dataframe.info())

Comportamento de saída

• Entradas .xlsx e .xls são processadas e exportadas para CSV.
• Entradas .csv são lidas com detecção de codificação e regravadas em UTF-8.
• Quando o caminho de saída não é informado, ele é criado automaticamente.

Licença

MIT License - Copyright (c) 2026 Artur dos Santos Shon