Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

assertEqual in unittest: confrontare il risultato con il valore atteso

Confronta il risultato con il valore atteso usando `assertEqual`, prepara i dati con `setUp` e verifica diversi input e le eccezioni con `unittest`.

Versione: Python 3.12

Sintassi

self.assertEqual(actual, expected, msg=None)

with self.subTest(label=value):
    self.assertEqual(actual, expected)

In Python 3.12, assertEqual è un metodo di unittest.TestCase. In self.assertEqual(actual, expected) passa prima il risultato e poi il valore atteso. Il metodo verifica l’uguaglianza (==), non l’identità (is). Se i valori sono diversi, l’asserzione fallisce; puoi aggiungere contesto con l’argomento opzionale msg.

Se entrambi gli operandi sono esattamente dello stesso tipo, assertEqual può usare un confronto specifico per quel tipo e produrre un messaggio di errore più informativo. Vale per list, tuple, dict, set, frozenset, str e per i tipi registrati tramite addTypeEqualityFunc(). Due valori possono essere uguali anche se hanno tipi diversi.

setUp() prepara i dati prima di ogni metodo di test, non prima di ogni sottotest. In un ciclo, with self.subTest(text=text): identifica il caso, così il resoconto indica quale input ha causato il fallimento. Se failfast è disattivato, un’asserzione fallita in un sottotest non impedisce l’esecuzione delle iterazioni successive.

Usa assertRaises per verificare le eccezioni. Esegui l’operazione nel blocco with self.assertRaises(ValueError):. Nella forma self.assertRaises(ValueError, int, text), passa la funzione senza chiamarla e fornisci il suo argomento separatamente. L’eccezione attesa o una sua sottoclasse soddisfa l’asserzione; se non viene sollevata alcuna eccezione, l’asserzione fallisce, mentre un’eccezione diversa si propaga.

Esempi

import io
import unittest


class IntConversionTests(unittest.TestCase):
    def setUp(self):
        self.inputs = ('0', '7', '-3', 'not a number')

    def test_direct(self):
        self.assertEqual(int(self.inputs[0]), 0)
        self.assertEqual(int(self.inputs[1]), 7)
        self.assertEqual(int(self.inputs[2]), -3)
        with self.assertRaises(ValueError):
            int(self.inputs[3])

    def test_subtests(self):
        for text, expected in zip(self.inputs[:3], (0, 7, -3)):
            with self.subTest(text=text):
                self.assertEqual(int(text), expected)
        self.assertRaises(ValueError, int, self.inputs[3])


if __name__ == '__main__':
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(IntConversionTests)
    report = io.StringIO()
    result = unittest.TextTestRunner(stream=report).run(suite)
    if not result.wasSuccessful():
        raise SystemExit(report.getvalue())
    print(f'{result.testsRun} tests passed')

Risultato

2 tests passed

`test_direct` esegue tre confronti diretti e verifica l’eccezione in un blocco `with`. `test_subtests` usa gli stessi input in sottotest identificabili e passa la funzione ad `assertRaises`. Il `2` conta i metodi di test, non i sottotest.

Lezioni correlate

  • Python · Lezione 37 · Avanzato · Versione: 5
  • Python · Lezione 34 · Intermedio · Versione: 3

Fonti