9.22 distutils.sysconfig -- Informazioni circa la configurazione di sistema

Il modulo distutils.sysconfig consente l'accesso alle informazioni della configurazione di basso livello di Python. Le variabili specifiche di configurazione dipendono profondamente dalla piattaforma e dalla configurazione. Le variabili specifiche dipendono dal processo di compilazione per la particolare versione di Python in fase di esecuzione; le variabili sono quelli trovate in Makefile e nelle intestazioni di configurazione che vengono installate con Python sui sistemi Unix. L'intestazione di configurazione chiamata pyconfig.h per le versioni di Python a partire dalla 2.2 e config.h per le versioni precedenti.

Vengono fornite alcune ulteriori funzioni che svolgono alcune comode manipolazioni per altre parti del package distutils.

PREFIX
Il risultato di os.path.normpath(sys.prefix).

EXEC_PREFIX
Il risultato di os.path.normpath(sys.exec_prefix).

get_config_var( name)
Restituisce il valore di una singola variabile. Questo è equivalente a get_config_vars().get(name).

get_config_vars( ...)
Restituisce un insieme di definizioni di variabile. Se non ci sono argomenti, restituisce un dizionario di nomi di variabili di configurazione associati ai rispettivi valori. Se vengono forniti argomenti, devono essere stringhe ed il valore restituito sarà una sequenza che indicherà i valori associati. Se il nome indicato non ha un corrispondente valore, verrà incluso None per quella specifica variabile.

get_config_h_filename( )
Restituisce il nome completo del percorso dell'intestazione di configurazione. Per Unix, questa sarà l'intestazione generata dallo script configure; per altre piattaforme l'intestazione dovrà essere fornita direttamente dalla distribuzione del sorgente Python. Il file è un file di testo specifico per la piattaforma ospite.

get_makefile_filename( )
Restituisce il nome completo del percorso relativo al Makefile usato per compilare Python. Per Unix, questo sarà un file generato dallo script configure; il risultato per le altre piattaforme sarà diverso. Il file, se esiste, è un file di testo specifico per la piattaforma ospite. Questa funzione è utile solo su piattaforme POSIX.

get_python_inc( [plat_specific[, prefix]])
Restituisce la directory sia per il file generale che per gli include C dipendenti dalla piattaforma. Se plat_specific viene indicato, evidenzierà la directory che contiene gli include, in funzione della piattaforma in uso; se falso o omesso, verrà restituita una directory indipendente dalla piattaforma. Se viene fornito il parametro prefix, verrà usato sia come prefisso al posto di PREFIX che come il prefisso di esecuzione al posto di EXEC_PREFIX se plat_specific risulta avere valore vero.

get_python_lib( [plat_specific[, standard_lib[, prefix]]])
Restituisce la directory della libreria generale o dipendente dalla piattaforma di installazione. Se plat_specific ha un valore vero, viene restituita la directory degli include dipendenti dalla piattaforma; se falso o omesso, viene restituita la directory indipendentemente dalla piattaforma. Se prefix viene indicata, viene usata sia come prefisso al posto di PREFIX che come prefisso di esecuzione al posto di EXEC_PREFIX se plat_specific ha come valore vero. Se standard_lib è vera, la directory per la libreria standard viene restituita al posto della directory per l'installazione di estensioni di terze parti.

Le seguenti funzioni sono intese solo per l'uso all'interno del package distutils.

customize_compiler( compiler)
Esegue ogni tipo di personalizzazione per la piattaforma specifica di un'istanza distutils.ccompiler.CCompiler.

Questa funzione è necessaria (per adesso) solo su sistemi Unix, ma dovrebbe venir usata in modo consistente per supportare la compatibilità con il passato. Inserisce informazioni variabili che cambiano attraverso i diversi Unix e vengono memorizzate nel Makefile di Python. Queste informazioni comprendono il compilatore in uso, le opzioni del linker e le estensioni usate dal linker per gli oggetti condivisi.

Questa funzione è qualcosa di molto specifico e dovrebbe essere usata solo dalle procedure di compilazione interne a Python.

set_python_build( )
Comunica al modulo distutils.sysconfig che è stato utilizzato come parte del processo di compilazione di Python. Questo modifica tutta una serie di indirizzi relativi ai file, permettendogli di essere posizionati nell'area di compilazione invece che all'interno di un'esistente installazione Python.

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