Setuptools Data Files Analysis

Dieses Tool analysiert Packaging-Metadaten zu Daten-Dateien in Python-Projekten, mit Fokus auf data_files-Einträge in setup.py und Muster in MANIFEST.in. Es identifiziert, welche Dateien in Verteilungen (sdist und wheel) enthalten sind und kennzeichnet häufige Lücken wie fehlende Daten-Dateien oder zu breite Muster. Die Analyse richtet sich an Projekt Maintainer, Release-Ingenieure und CI-Workflows, die eine reproduzierbare Verpackung suchen.
Konzep­tionell analysiert das Tool setup.py, um data_files- oder package_data-Regeln zu extrahieren, liest MANIFEST.in, um Include/Exclude-Direktiven aufzulösen, und durchläuft den Projektbaum, um jede Datei einer Einschlussentscheidung zuzuordnen. Es berechnet eine repräsentative installierte Größe durch Summen der Dateigrößen und wendet einfache Normalisierung an, um plattformbedingte Unterschiede zu berücksichtigen. Es erkennt Glob-Muster und potenzielle dynamische Daten.
Der einzigartige Wert liegt darin, sowohl setup.py data_files als auch MANIFEST.in zu unterstützen, einen einheitlichen Bericht bereitzustellen, der die beiden Quellen cross-validiert, und konkrete Empfehlungen zur Behebung von Auslassungen oder übermäßigen Einschlüssen zu geben. Nutznießer sind Open-Source-Projekte, unternehmensweite Python-Teams und jeder Release-Prozess, der auf genaue Distributionen angewiesen ist.
Kernfunktionen umfassen Inventare von Daten-Dateien, Größenabschätzungen, Validitätsprüfungen, Konsistenzprüfung zwischen Quellen und exportierbare Zusammenfassungen für Audits. Anwendungsfälle umfassen Pre-Release Packaging-Checks, CI-Tor-Validierungen und historische Vergleiche zur Verfolgung von Packaging-Hygiene-Verbesserungen.