Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

assertEqual v unittest: porovnání výsledku s očekávanou hodnotou

Porovnávej výsledek s očekávanou hodnotou pomocí `assertEqual`, připravuj data v `setUp` a ověřuj různé vstupy i výjimky v `unittest`.

Verze: Python 3.12

Syntaxe

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

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

V Pythonu 3.12 je assertEqual metoda třídy unittest.TestCase. Při volání self.assertEqual(actual, expected) předávej nejprve skutečný výsledek a potom očekávanou hodnotu. Metoda ověřuje rovnost (==), nikoli identitu (is). Pokud si hodnoty nejsou rovny, aserce selže; nepovinný argument msg umožňuje doplnit kontext.

Mají-li oba operandy přesně stejný typ, může assertEqual použít porovnání specifické pro tento typ a nabídnout přesnější zprávu o selhání. To platí pro list, tuple, dict, set, frozenset, str a typy zaregistrované pomocí addTypeEqualityFunc(). Stejný typ není podmínkou rovnosti hodnot.

setUp() připravuje data před každou testovací metodou, nikoli před každým dílčím testem. V cyklu with self.subTest(text=text): označí případ, aby zpráva o selhání uvedla testovaný vstup. Pokud je failfast vypnutý, selhání aserce v dílčím testu nezabrání provedení dalších iterací.

Výjimky ověřuj pomocí assertRaises. Operaci spusť uvnitř bloku with self.assertRaises(ValueError):. Ve tvaru self.assertRaises(ValueError, int, text) předej funkci bez zavolání a její argument uveď zvlášť. Očekávaná výjimka nebo její podtřída vyhoví aserci; pokud žádná výjimka nenastane, aserce selže, a jiná výjimka se šíří dál.

Příklady

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')

Výsledek

2 tests passed

`test_direct` provede tři přímá porovnání a ověří výjimku v bloku `with`. `test_subtests` použije stejné vstupy v označených dílčích testech a předá funkci metodě `assertRaises`. Číslo `2` označuje počet testovacích metod, nikoli dílčích testů.

Související lekce

  • Python · Lekce 37 · Pokročilá · Verze: 5
  • Python · Lekce 34 · Středně pokročilá · Verze: 3

Zdroje