Python Splitter

O Python Splitter é uma ferramenta voltada para desenvolvedores que transforma scripts Python grandes em unidades modulares adequadas para empacotamento e colaboração. Destina-se a engenheiros, cientistas de dados e engenheiros de automação que mantêm bases de código que crescem além de um único arquivo. Ao produzir fronteiras de módulo coerentes, reduz a carga cognitiva durante revisões de código e facilita o gerenciamento de dependências, testes e fluxos de implantação.
Ele analisa o código-fonte Python usando AST, identifica definições de nível superior, imports e lógica __main__; suporta dividir por função ou por classe, por regiões marcadas ou por regras de agrupamento personalizadas. O processo preserva imports e referências relativas, cria arquivos de módulo separados e, opcionalmente, gera __init__.py para formar um pacote.
Em comparação com divisão manual, a ferramenta oferece resultados determinísticos, lida com conflitos de nomes com renomeação configurável e pode exportar um pacote pronto para distribuição. É especialmente útil para refatoração de bibliotecas legadas, criação de micro-pacotes ou isolamento de código de experimento em projetos de dados. Também apoia fluxos educacionais mostrando como grandes scripts podem ser decompostos em componentes reutilizáveis.
Funções-chave incluem divisão baseada em AST, fronteiras configuráveis, preservação de imports e dependências, extração opcional de docstrings e uma estrutura de saída que segue convenções comuns de empacotamento Python. Casos limites como imports dinâmicos, uso de eval/exec e dependências circulares são sinalizados, com fallback seguro para divisão linha a linha. A ferramenta não executa código nem testes e assume que a entrada segue a sintaxe Python após pré-processamento.