2.5 Installare ulteriori file

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.