Setuptools Data Files Analysis

Cet outil analyse les métadonnées d'emballage relatives aux fichiers de données pour les projets Python, en se concentrant sur les entrées data_files dans setup.py et les modèles dans MANIFEST.in. Il identifie quels fichiers sont inclus dans les distributions (sdist et wheel) et signale les lacunes courantes telles que des fichiers de données manquants ou des motifs trop larges. L'analyse s'adresse aux mainteneurs de projets, aux ingénieurs de release et aux workflows CI en quête d'un emballage reproductible.
Conception: l'outil analyse setup.py pour extraire les règles data_files ou package_data, lit MANIFEST.in pour résoudre les directives include/exclude, et parcourt l'arborescence du projet afin d'associer chaque fichier à une décision d'inclusion. Il calcule une taille installée représentative en sommant les tailles de fichiers et applique une normalisation simple pour comparer les différences de plateforme. Il détecte les motifs glob et les données générées dynamiquement.
Sa valeur unique réside dans le fait qu'il prend en charge à la fois data_files de setup.py et MANIFEST.in, fournit un rapport unifié qui croise les sources et propose des recommandations concrètes pour corriger les omissions ou les inclusions excessives. Les bénéficiaires incluent les projets open source, les équipes Python d'entreprise et tout processus de release qui dépend de distributions précises.
Les fonctionnalités clés incluent des inventaires de fichiers de données, des estimations de taille, des vérifications de validité, la cohérence inter-sources et des résumés exportables pour des audits. Cas d'usage: vérifications de packaging pré-release, validations CI et comparaisons historiques pour suivre les améliorations d'hygiène du packaging.