L'opzione data_files può essere usata per specificare ulteriori file necessari alla distribuzione del modulo: file di configurazione, elenchi di messaggi, file di dati, qualsiasi altra cosa che non rientri nelle precedenti categorie.
data_files specifica una sequenza di coppie (directory, files) nel seguente modo:
setup(... data_files=[('bitmaps', ['bm/b1.gif', 'bm/b2.gif']), ('config', ['cfg/data.cfg']), ('/etc/init.d', ['init-script'])] )
Si noti che si possono specificare i nomi delle directory dove i file di dati verranno installati, ma non si possono rinominare i file di dati direttamente.
Ogni coppia (directory, files) nella sequenza
specificata, la directory d'installazione ed il file da installarvi
dentro. Se directory è un percorso relativo, viene interpretato
come relativo al prefisso di installazione ( il sys.prefix
di
Python, per i package in puro python, sys.exec_prefix
per i
package che contengono moduli di estensione). Ogni nome di file in
files viene interpretato relativamente allo script
setup.py all'inizio della distribuzione del sorgente del
package. Nessuna informazione su directory, proveniente da
files, viene usata per determinare l'ubicazione finale dei file
installati; viene usato solo il nome del file.
È possibile specificare l'opzione data_files come una
semplice sequenza di file, senza specificare una directory di
destinazione, ma questo non è raccomandato ed il comando
install
stamperà un avvertimento in casi come questi. Per
installare file di dati direttamente nella directory di destinazione,
deve essere indicata una stringa vuota come directory.
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.