Setuptools Data Files Analysis

Esta ferramenta analisa metadados de empacotamento relacionados a arquivos de dados para projetos Python, com foco em entradas data_files em setup.py e padrões em MANIFEST.in. Ela identifica quais arquivos estão incluídos em distribuições (sdist e wheel) e sinaliza lacunas comuns como arquivos de dados ausentes ou padrões muito amplos. A análise é destinada a mantenedores de projetos, engenheiros de lançamento e fluxos CI que buscam empacotamento reprodutível.
Conceitualmente, a ferramenta analisa setup.py para extrair regras data_files ou package_data, lê MANIFEST.in para resolver include/exclude directives, e percorre a árvore do projeto para atribuir a cada arquivo uma decisão de inclusão. Calcula um tamanho instalado representativo somando os tamanhos dos arquivos e aplica normalização simples para compensar diferenças de plataforma. Detecta padrões glob e dados gerados dinamicamente.
O valor único reside em suportar tanto data_files de setup.py quanto MANIFEST.in, fornecendo um relatório unificado que cruza as fontes e oferece recomendações concretas para corrigir omissões ou inclusões excessivas. Interessados incluem projetos de código aberto, equipes Python corporativas e qualquer processo de release que exija distribuições precisas.
Recursos-chave incluem inventários de arquivos de dados, estimativas de tamanho, verificações de validade, consistência entre fontes e resumos exportáveis para auditorias. Casos de uso: verificações de pré-release de empacotamento, validações CI e comparações históricas para acompanhar melhorias na higiene do empacotamento.