Python Code Smells Tool

La herramienta analiza el código Python para exponer riesgos de mantenibilidad y smells accionables. Utiliza mediciones basadas en AST para cuantificar complejidad, anidación y tamaño, y marca anti-patrones como métodos largos, clases grandes y números mágicos. Los resultados se organizan por archivo con niveles de severidad y sugerencias de refactorización concretas, lo que permite a los desarrolladores priorizar cambios. El análisis puede ejecutarse en archivos individuales o en repositorios enteros, proporcionando una vista de la deuda técnica del proyecto. Conceptualmente, la herramienta aplica heurísticas fijas y umbrales configurables para determinar cuándo un patrón se considera un smell, y agrupa los hallazgos en un informe estructurado para revisión e integración CI. Los usuarios incluyen desarrolladores individuales que buscan código más limpio, equipos que hacen cumplir estándares de codificación y gerentes que siguen tendencias de calidad. El valor único radica en la combinación de métricas AST precisas, directrices prácticas de remediación y salida compatible con CI que soporta grandes bases de código Python. Funcionalidades clave: umbrales de complejidad configurables, detección de imports no utilizados, verificación de duplicación de código y reconocimiento de cadenas codificadas en duro. Casos de uso: verificaciones previas a commits, revisiones de pull request y evaluaciones de calidad continuas. La herramienta enfatiza salidas accionables sobre advertencias genéricas y se centra en oportunidades de refactorización concretas, mejoras de nombres y modularización.