Conversor Excel XLS/XLSX

Objetivo e intenção do usuário: a ferramenta resolve o problema de converter arquivos Excel (.xls/.xlsx) em formatos portáteis e legíveis por máquina, como CSV, JSON ou XML. O público-alvo são engenheiros de dados, analistas de dados e desenvolvedores que recebem planilhas regularmente e precisam inseri-las em ambientes de análise, armazéns de dados ou pipelines de automação. Quando equipes recebem dados legados ou de fornecedores em Excel, esta ferramenta oferece um caminho confiável para exports estruturados que mantêm a integridade dos dados e permitem consumo programático. Casos de uso incluem migração de dados, automação de relatórios e ingestão de arquivos planos em bancos de dados.
Lógica central e recursos: Funções obrigatórias incluem: suporte a entradas XLS/XLSX, formatos de saída CSV/JSON/XML, preservação de cabeçalhos e suporte a múltiplas folhas. Funções opcionais/avançadas incluem processamento em lote via API, exportação por folha, codificação configurável (UTF-8, ISO-8859-1), controle do delimitador CSV, localização de datas e números e embalagem de saídas (arquivo comprimido) para várias folhas. A ferramenta exporta apenas valores de células e não exporta gráficos ou macros.
Entradas e Saídas: Entradas: input_file (arquivo, obrigatório, tipos: xls/xlsx), target_format (string, obrigatório, valores: CSV/JSON/XML), sheet_selection (string, opcional, ex.: all ou nome da folha), output_delimiter (string, opcional, ex.: vírgula, ponto e vírgula), encoding (string, opcional, padrão UTF-8), include_headers (boolean, opcional, padrão true), flatten_sheets (boolean, opcional, padrão false). Saídas: output_file (arquivo, tipo varia conforme formato), row_count (inteiro), sheet_count (inteiro), e sample_output (string ou pequeno arquivo) para validação rápida.
Algoritmos e cálculos: O fluxo analisa cada workbook, atribui a primeira linha aos cabeçalhos e percorre as linhas para gerar a estrutura-alvo. CSV usa o delimitador escolhido; JSON transforma cada folha em um array de objetos com chaves derivadas dos cabeçalhos; XML representa uma folha com linhas como elementos. Suporte multi-folha pode gerar saídas separadas por folha ou um único arquivo compactado.
Erros e casos limites: Lida com arquivos corrompidos com códigos de erro precisos, detecta cabeçalhos ausentes e valida consistência de tipos por coluna quando possível. Arquivos grandes podem ser processados em chunks com relatório de progresso.
Conformidade e localização: Segue convenções comuns de planilhas, incluindo datas e formatos numéricos regionais. UTF-8 é preferido; outros encodings podem ser especificados. A semântica multi-folha respeita nomes de folhas e a ordem, quando possível.
Suposições e exclusões: Assume que os arquivos de entrada não contêm fórmulas, macros ou gráficos incorporados; não são avaliados nem exportados.