Setuptools Data Files Analysis

Questo strumento analizza metadati di packaging relativi ai file di dati per progetti Python, concentrandosi sulle voci data_files in setup.py e sui modelli in MANIFEST.in. Identifica quali file sono inclusi nelle distribuzioni (sdist e wheel) e segnala lacune comuni come file di dati mancanti o pattern troppo ampi. L’analisi è rivolta a mantenitori di progetti, ingegneri di rilascio e flussi CI in cerca di packaging riproducibile.
Concettualmente l’outil analizza setup.py per estrarre regole data_files o package_data, legge MANIFEST.in per risolvere Include/Exclude directives, e attraversa l’albero di progetto per assegnare a ogni file una decisione di inclusione. Calcola una dimensione installata rappresentativa sommando le dimensioni dei file e applica una normalizzazione semplice per compensare differenze di piattaforma. Rileva pattern glob e dati generati dinamicamente.
Il valore unico risiede nel supportare sia data_files di setup.py sia MANIFEST.in, offrendo un rapporto unificato che cross-valida le fonti e propone raccomandazioni concrete per correggere omissioni o inclusioni eccessive. Beneficiari: progetti open source, team Python aziendali e qualsiasi processo di rilascio che richieda distribuzioni accurate.
Caratteristiche principali: inventari di file di dati, stime di dimensione, controlli di validità, coerenza tra fonti e riepiloghi esportabili per audit. Casi d’uso: controlli pre-release di packaging, verifiche CI e confronti storici per tracciare miglioramenti dell’igiene del packaging.