Python Code Smells Tool

Das Tool analysiert Python-Code, um Wartbarkeitsrisiken und konkrete Gerüche aufzudecken. Es verwendet AST-basierte Messgrößen, um Komplexität, Verschachtelung und Größe zu quantifizieren, und kennzeichnet Anti-Pattern wie lange Methoden, große Klassen und Magic Numbers. Ergebnisse werden pro Datei mit Schweregrad und konkreten Refactoring-Vorschlägen organisiert, was Entwicklern hilft, Änderungen zu priorisieren. Die Analyse kann auf einzelnen Dateien oder ganzen Repositories durchgeführt werden und bietet eine projektweite Sicht auf technischen Schuldenstand. Konzeptuell wendet das Tool feste Heuristiken und konfigurierbare Schwellenwerte an, um zu bestimmen, wann ein Muster als Geruch gilt, und fasst Ergebnisse in einem strukturierten Bericht für Review- und CI-Integrationen zusammen. Zu den Nutzern gehören Einzelentwickler, die saubereren Code wünschen, Teams, die Coding-Standards durchsetzen, und Manager, die Qualitäts-Trends verfolgen. Der einzigartige Mehrwert liegt in der Kombination aus präzisen AST-basierten Metriken, praxisnahen Bereinigungsanweisungen und nahtlos CI-freundlicher Ausgabe, die große Python-Codebasen unterstützt. Kernfunktionen umfassen konfigurierbare Komplexitäts-Schwellenwerte, Erkennung ungenutzter Importe, Duplikatcode-Prüfungen und Erkennung hartkodierter Strings. Einsatzszenarien umfassen Pre-Commit-Checks, Pull-Request-Reviews und kontinuierliche Qualitätsbewertungen. Das Tool legt Wert auf umsetzbare Ausgaben statt generischer Warnungen und fokussiert auf konkrete Refactoring-Möglichkeiten, Namensverbesserungen und Modularisierung. Es ergänzt Linters durch strukturierte Qualitätsinformationen statt nur Stilhinweisen und hilft Teams, technische Schulden im Zeitverlauf zu reduzieren.