5.5 `test.test_support` -- Funzioni di utilit� per i test

Il modulo test.test_support fornisce un supporto ai test di regressione di Python.

Questo modulo definisce le seguenti eccezioni:

exception TestFailed: Eccezione sollevata quando un test fallisce.

exception TestSkipped: Sottoclasse di TestFailed. Sollevata quando un test viene saltato. Si presenta quando una risorsa richiesta (come una connessione di rete) non � disponibile al momento del test.

exception ResourceDenied: Sottoclasse di TestSkipped. Sollevata quando una risorsa (come una connessione di rete) non � disponibile. Viene sollevata dalla funzione requires().

Il modulo test.test_support definisce le seguenti costanti:

verbose: True quando l'output � abilitato. Dovrebbe essere controllato quando sono richieste informazioni pi� dettagliate circa l'esecuzione di un test. verbose viene impostata da test.regrtest.

have_unicode: True quando � disponibile il supporto per Unicode.

is_jython: True se l'interprete � Jython.

TESTFN: Imposta il percorso in cui pu� essere creato un file temporaneo. Ogni file temporaneo che viene creato deve essere chiuso e delinkato (rimosso).

Il modulo test.test_support definisce le seguenti funzioni:

forget( module_name): Rimuove il modulo chiamato module_name da sys.modules e rimuove ogni file del modulo compilato in bytecode.

is_resource_enabled( resource): Restituisce True se la risorsa resource � abilitata e disponibile. L'elenco delle risorse disponibili viene impostata solo quando test.regrtest sta eseguendo il test.

requires( resource[, msg]): Solleva ResourceDenied se la risorsa resource non � disponibile. msg � l'argomento di ResourceDenied se questa viene sollevata. Restituisce sempre vero se chiamata da una funzione il cui __name__ � '__main__'. Utilizzata quando i test sono eseguiti da test.regrtest.

findfile( filename): Restituisce il percorso al file chiamato filename. Se non c'� corrispondenza, viene restituito filename. Questo non � equiparabile ad un fallimento poich� pu� essere il percorso del file.

run_unittest( *classes): Esegue le sotto classi di unittest.TestCase passate alla funzione. La funzione analizza le classi alla ricerca di metodi che iniziano con il prefisso "test_" ed esegue i test individualmente. Questo � il modo preferenziale per eseguire i test.

run_suite( suite[, testclass]): Esegue l'istanza suite di unittest.TestSuite. L'argomento facoltativo testclass accetta una delle classi di test presenti nella suite, cos� da stampare informazioni pi� dettagliate sulla provenienza della suite di test.

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