Ora che i nostri test delle unità di codice sono pronti, è tempo di cominciare a scrivere il codice che stiamo cercando di verificare con i nostri test. Faremo questo in più fasi, in modo che si possa osservare dapprima come tutti i test falliscano, e poi come a poco a poco abbiano successo man mano che riempiamo gli spazi vuoti all'interno del modulo roman.py.
Esempio 7.7. Il modulo roman1.py
Se non lo avete ancora fatto, potete scaricare questo ed altri esempi usati in questo libro.
"""Convert to and from Roman numerals""" #Define exceptions class RomanError(Exception): passclass OutOfRangeError(RomanError): pass
class NotIntegerError(RomanError): pass class InvalidRomanNumeralError(RomanError): pass
def toRoman(n): """convert integer to Roman numeral""" pass
def fromRoman(s): """convert Roman numeral to integer""" pass
|
|
Questo è il modo di definire le proprie eccezioni specifiche in Python. Le eccezioni sono classi, e voi create le vostre specializzando le eccezioni già esistenti. È fortemente raccomandato (ma non richiesto) di specializzare la classe Exception, che è la classe base da cui ereditano tutte le eccezioni predefinite. Qui io sto definendo RomanError (derivato da Exception), che funzionerà da classe base per tutte le mie eccezioni specifiche che saranno definite in seguito. Questa è una questione di stile; avrei potrei altrettanto facilmente derivare ogni singola eccezione direttamente dalla classe Exception. |
|
|
Le eccezioni OutOfRangeError e NotIntegerError saranno in futuro usate da toRoman per segnalare varie forme di input non valido, come specificato in ToRomanBadInput. |
|
|
L'eccezione InvalidRomanNumeralError sarà in futuro usata da fromRoman per segnalare input non valido, come specificato in FromRomanBadInput. |
|
|
In questa fase, noi vogliamo definire le API di ciascuna delle nostre funzioni, ma non vogliamo ancora scrivere il codice, cosi creiamo delle funzioni vuote usando la parola chiave di Python pass. |
Siamo arrivati al grande momento (rullo di tamburi, prego): stiamo finalmente per eseguire i nostri test su questo piccolo modulo ancora poco “formato”. A questo punto, tutti i test dovrebbe fallire. In effetti, se un test ha successo nella prima fase, vuol dire che dovremmo ritornare sul modulo romantest.py e riconsiderare il perché abbiamo scritto un test così inutile da avere successo anche con queste funzioni nullafacenti.
Eseguite romantest1.py con l'opzione di linea di comando -v, che vi darà un output più prolisso, cosicché si possa vedere esattamente che cosa succede in ogni test. Con un po di fortuna, il vostro output dovrebbe somigliare a questo:
Esempio 7.8. Output del modulo romantest1.py eseguito su roman1.py
fromRoman should only accept uppercase input ... ERROR toRoman should always return uppercase ... ERROR fromRoman should fail with malformed antecedents ... FAIL fromRoman should fail with repeated pairs of numerals ... FAIL fromRoman should fail with too many repeated numerals ... FAIL fromRoman should give known result with known input ... FAIL toRoman should give known result with known input ... FAIL fromRoman(toRoman(n))==n for all n ... FAIL toRoman should fail with non-integer input ... FAIL toRoman should fail with negative input ... FAIL toRoman should fail with large input ... FAIL toRoman should fail with 0 input ... FAIL ====================================================================== ERROR: fromRoman should only accept uppercase input ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 154, in testFromRomanCase roman1.fromRoman(numeral.upper()) AttributeError: 'None' object has no attribute 'upper' ====================================================================== ERROR: toRoman should always return uppercase ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 148, in testToRomanCase self.assertEqual(numeral, numeral.upper()) AttributeError: 'None' object has no attribute 'upper' ====================================================================== FAIL: fromRoman should fail with malformed antecedents ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 133, in testMalformedAntecedent self.assertRaises(roman1.InvalidRomanNumeralError, roman1.fromRoman, s) File "c:\python21\lib\unittest.py", line 266, in failUnlessRaises raise self.failureException, excName AssertionError: InvalidRomanNumeralError ====================================================================== FAIL: fromRoman should fail with repeated pairs of numerals ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 127, in testRepeatedPairs self.assertRaises(roman1.InvalidRomanNumeralError, roman1.fromRoman, s) File "c:\python21\lib\unittest.py", line 266, in failUnlessRaises raise self.failureException, excName AssertionError: InvalidRomanNumeralError ====================================================================== FAIL: fromRoman should fail with too many repeated numerals ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 122, in testTooManyRepeatedNumerals self.assertRaises(roman1.InvalidRomanNumeralError, roman1.fromRoman, s) File "c:\python21\lib\unittest.py", line 266, in failUnlessRaises raise self.failureException, excName AssertionError: InvalidRomanNumeralError ====================================================================== FAIL: fromRoman should give known result with known input ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 99, in testFromRomanKnownValues self.assertEqual(integer, result) File "c:\python21\lib\unittest.py", line 273, in failUnlessEqual raise self.failureException, (msg or '%s != %s' % (first, second)) AssertionError: 1 != None ====================================================================== FAIL: toRoman should give known result with known input ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 93, in testToRomanKnownValues self.assertEqual(numeral, result) File "c:\python21\lib\unittest.py", line 273, in failUnlessEqual raise self.failureException, (msg or '%s != %s' % (first, second)) AssertionError: I != None ====================================================================== FAIL: fromRoman(toRoman(n))==n for all n ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 141, in testSanity self.assertEqual(integer, result) File "c:\python21\lib\unittest.py", line 273, in failUnlessEqual raise self.failureException, (msg or '%s != %s' % (first, second)) AssertionError: 1 != None ====================================================================== FAIL: toRoman should fail with non-integer input ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 116, in testDecimal self.assertRaises(roman1.NotIntegerError, roman1.toRoman, 0.5) File "c:\python21\lib\unittest.py", line 266, in failUnlessRaises raise self.failureException, excName AssertionError: NotIntegerError ====================================================================== FAIL: toRoman should fail with negative input ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 112, in testNegative self.assertRaises(roman1.OutOfRangeError, roman1.toRoman, -1) File "c:\python21\lib\unittest.py", line 266, in failUnlessRaises raise self.failureException, excName AssertionError: OutOfRangeError ====================================================================== FAIL: toRoman should fail with large input ---------------------------------------------------------------------- Traceback (most recent call last): File "C:\docbook\dip\py\roman\stage1\romantest1.py", line 104, in testTooLarge self.assertRaises(roman1.OutOfRangeError, roman1.toRoman, 4000) File "c:\python21\lib\unittest.py", line 266, in failUnlessRaises raise self.failureException, excName AssertionError: OutOfRangeError ====================================================================== FAIL: toRoman should fail with 0 input
|
|
Eseguendo lo script, si lancia unittest.main(), che esegue ciascuno dei test, vale a dire ciascuno dei metodi definiti in ciascuna classe presente in romantest.py. Per ogni test, viene stampata la doc string del metodo comunque, sia se il test ha avuto successo sia se fallisce. Come ci si aspettava, nessuno dei nostri test ha avuto successo. |
|
|
Per ciascun test fallito, unittest visualizza la traccia di esecuzione che mostra esattamente cos'è successo. In questo caso, la nostra chiamata al metodo assertRaises (che ha anche il nome di failUnlessRaises) solleva una eccezione AssertionError, perché si aspettava che toRoman sollevasse un'eccezione OutOfRangeError e questo non è successo. |
|
|
Dopo il dettaglio delle esecuzioni dei test, unittest visualizza un sommario di quanti test sono stati eseguiti e quanto tempo è stato impiegato. |
|
|
In termini generali, il test dell'unità di codice è fallito perché almeno un test non ha avuto sucesso, Quando un test fallisce, unittest distingue tra fallimenti ed errori. Un fallimento è una chiamata ad un metodo del tipo assertXYZ, come assertEqual o assertRaises, che fallisce perché la condizione verificata non è vera o l'eccezione attesa non è stata sollevata. Un errore è ogni altro tipo di eccezione sollevata nel codice che si sta verificando o nello stesso codice di test. Per esempio, il metodo testFromRomanCase (“il metodo fromRoman dovrebbe accettare solo input in lettere maiuscole”) ha dato come risultato un errore, perché la chiamata a numeral.upper() ha sollevato un'eccezione AttributeError, dovuta al fatto che toRoman avrebbe dovuto restituire una stringa, ma non lo ha fatto. Mentre la chiamata al metodo testZero (“toRoman non dovrebbe accettare come dato in ingresso lo 0”) è fallita perché la chiamata al metodo fromRoman non solleva l'eccezione InvalidRomanNumeral alla quale assertRaises è preposta. |