Python Code Smells Tool

A ferramenta analisa o código Python para expor riscos de manutenção e smells acionáveis. Utiliza medições baseadas em AST para quantificar complexidade, aninhamento e tamanho, e marca anti-padrões como métodos longos, grandes classes e números mágicos. Os resultados são organizados por arquivo com níveis de severidade e sugestões de refatoração concretas, permitindo que desenvolvedores priorizem mudanças. A análise pode ser executada em arquivos individuais ou em repositórios inteiros, fornecendo uma visão da dívida técnica do projeto. Conceitualmente, a ferramenta aplica heurísticas fixas e limites configuráveis para determinar quando um padrão é considerado smell, e agrega os achados em um relatório estruturado para revisão e integração CI. Os usuários incluem desenvolvedores individuais que buscam código mais limpo, equipes que aplicam padrões de codificação e gerentes que acompanham tendências de qualidade. O valor único está na combinação de métricas AST precisas, diretrizes práticas de remediação e saída compatível com CI que suporta grandes bases de código Python. Funcionalidades principais: limites de complexidade configuráveis, detecção de imports não utilizados, verificação de duplicação de código e reconhecimento de strings codificadas. Casos de uso incluem verificações pré-commit, revisões de pull request e avaliações de qualidade contínuas. A ferramenta foca em saídas acionáveis em vez de avisos genéricos, com oportunidades concretas de refatoração, melhoria de nomes e modularização.