5 Il file di configurazione di Distutils

Come descritto in precedenza, potete usare i file di configurazione di Distutils per registrare preferenze personali o indirizzi per ogni opzione di Distutils. Cos�, ogni opzione ed ogni comando possono essere conservati in uno, due o tre file di configurazione (a seconda della vostra piattaforma) che potranno essere consultati prima che venga analizzata la riga di comando. Questo significa che quei file di configurazione annulleranno i valori predefiniti e la riga di comando sovrascriver� i file di configurazione. Inoltre, se si applicano file di configurazione multipli, i valori presenti nei file ``iniziali'' verranno annullati da quelli ``successivi''.

5.1 Indirizzi e nomi dei file di configurazione

I nomi e la posizione dei file di configurazione varieranno leggermente nelle diverse piattaforme. Su Unix, i tre file di configurazione (nell'ordine in cui vengono elaborati) sono:

Tipo di file Indirizzo e nome del file Note

sistema prefix/lib/pythonver/distutils/distutils.cfg (1)
personali $HOME/.pydistutils.cfg (2)
locali setup.cfg (3)

Tipo di file	Indirizzo e nome del file	Note
sistema	prefix/lib/pythonver/distutils/distutils.cfg	(1)
personali	$HOME/.pydistutils.cfg	(2)
locali	setup.cfg	(3)

Su Windows, i file di configurazione sono:

Tipo di file Indirizzo e nome del file Note

sistema prefix\Lib\distutils\distutils.cfg (4)
personali %HOME%\pydistutils.cfg (5)
locali setup.cfg (3)

Tipo di file	Indirizzo e nome del file	Note
sistema	prefix\Lib\distutils\distutils.cfg	(4)
personali	%HOME%\pydistutils.cfg	(5)
locali	setup.cfg	(3)

E su Mac OS:

Tipo di file Indirizzo e nome del file Note

sistema prefix:Lib:distutils:distutils.cfg (6)
personali N/A
locali setup.cfg (3)

Tipo di file	Indirizzo e nome del file	Note
sistema	prefix:Lib:distutils:distutils.cfg	(6)
personali	N/A
locali	setup.cfg	(3)

Note:

(1): Solo per dirlo, i file di configurazione di Distutils risiedono nella medesima directory di dove Distutils stesso � stato installato; � cos� in Python 1.6 e seguenti, su Unix. Per Python 1.5.2, le Distutils vengono normalmente installate in prefix/lib/python1.5/site-packages/distutils, cos� i file di configurazione del sistema dovrebbero essere messe l�, in Python 1.5.2.
(2): Su Unix, se la variabile di ambiente HOME non viene definita, la directory home dell'utente verr� determinata dalla la funzione getpwuid(), dal modulo standard pwd.
(3): Per esempio, nella directory corrente (solitamente la posizione dello script di setup).
(4): (Vedete anche le note (1).) In Python 1.6 e successivi, il valore predefinito per il prefix d'installazione di Python � C:\Python, cos� i file di configurazione normalmente si trovano in C:\Python\Lib\distutils\distutils.cfg. In Python 1.5.2, il valore predefinito per il prefix era C:\Program Files\Python e le Distutils non erano parte della libreria standard--cos� il file di configurazione in un'installazione standard di Python sotto Windows dovrebbe essere C:\Program Files\Python\distutils\distutils.cfg.
(5): Su Windows, se la variabile di ambiente HOME non viene definita, non verr� trovato o usato nessun file di configurazione. (In altre parole, le Distutils non si apetteranno la vostra directory home in Windows).
(6)

(Vedete anche note (1) e (4).) Il valore predefinito per il prefix d'installazione � solo Python:, cos� sotto Python 1.6 e successivi � normalmente Python:Lib:distutils:distutils.cfg.

5.2 Sintassi dei file di configurazione

I file di configurazione di Distutils hanno tutti la medesima sintassi. I file di configurazione vengono riuniti all'interno di sezioni. C'� una sezione per ogni comando Distutils, pi� una sezione global per opzioni globali che interessano ogni comando. Ogni sezione consiste di un'opzione per riga, specificata come option=value.

Per esempio, il seguente � un file di configurazione completo che forza tutti i comandi ad un'esecuzione non prolissa in modo predefinito:

[global]
verbose=0

Se questo viene installato come il file di configurazione del sistema, interesser� tutti i processi di tutti i moduli della distribuzione Python per ogni utente del sistema. Se viene installato come un vostro personale file di configurazione (nei sistemi che lo supportano), interesser� solo il modulo della distribuzione elaborato per voi. Se viene usato come il setup.cfg per un particolare modulo della distribuzione, interesser� solo quella distribuzione.

Potete sovrascrivere la directory predefinita ``build base'' ed eseguire i comandi build* forzando sempre la ricostruzione di tutti i file nel seguente modo:

[build]
build-base=blib
force=1

Che corrisponde agli argomenti da riga di comando

python setup.py build --build-base=blib --force

ad eccezione di quelli che comprendono il comando build da riga di comando, ovvero, quel particolare comando verr� comunque eseguito. L'inclusione di un particolare comando nel file di configurazione non ha implicazioni; significa soltanto che se il comando viene eseguito, l'opzione nel file di configurazione verr� applicata. (O se altri comandi che traggono valori da esso vengono eseguiti, useranno i valori del file di configurazione.)

Potete trovare un elenco completo delle opzioni per ogni comando usando l'opzione --help, per esempio:

python setup.py build --help

e troverete l'elenco completo delle opzioni globali da usare.

L'--help senza un comando:

python setup.py --help

Vedete anche la sezione ``Riferimenti'' del manuale ``Distribuire moduli Python''

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.