18.8 `py_compile` -- Compilazione di file sorgenti Python

Il modulo py_compile fornisce una funzione per generare file bytecode da un file sorgente ed un'altra funzione utilizzata quando il file sorgente del modulo viene invocato come script.

Sebbene non utilizzata spesso, questa funzione può essere utile durante l'installazione di moduli condivisi, specialmente se alcuni utenti non hanno il permesso di scrittura su file di cache bytecode nella directory contenente il codice sorgente.

exception PyCompileError: Eccezione sollevata quando viene rilevato un errore nel tentativo di compilare il file.

compile( file[, cfile[, dfile[, doraise]]]): Compila un file sorgente generando bytecode che viene scritto in un file di cache. Il codice sorgente viene caricato dal file identificato dal parametro file. Il bytecode viene scritto nel file cfile, il valore predefinito di tale parametro è file + 'c' ('o' se è attiva l'opzione di ottimizzazione nell'interprete in esecuzione). Se viene definito il parametro dfile, esso viene utilizzato come nome del file sorgente nei messaggi di errore al posto di file. Se doraise = True, viene sollevata un'eccezione PyCompileError se si verifica un errore durante la compilazione di file. Se doraise = False (valore predefinito), viene scritta su sys.stderr una stringa di errore, ma non viene sollevata alcuna eccezione.

main( [args]): Compila diversi file sorgenti. I file specificati in args (o sulla riga di comando, se args non viene definito) vengono compilati ed il bytecode risultante viene messo nella cache alla solita maniera. Questa funzione non ricerca in una struttura di directory per trovare i file sorgenti; compila solamente i file definiti esplicitamente.

Quando questo modulo viene eseguito come script, viene utilizzata main() per compilare tutti i file elencati sulla riga di comando.

Vedete anche:

Modulo compileall:: Utilità per compilare file sorgenti Python in un albero di directory.

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

18.8 py_compile -- Compilazione di file sorgenti Python

18.8 `py_compile` -- Compilazione di file sorgenti Python