Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

assertEqual w unittest: porównywanie wyniku z oczekiwaniem

Porównuj wynik z oczekiwaną wartością za pomocą `assertEqual`, przygotowuj dane w `setUp` i uzupełniaj testy o podtesty oraz kontrolę wyjątków.

Wersja: Python 3.12

Składnia

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

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

W Pythonie 3.12 assertEqual jest metodą klasy unittest.TestCase. Wywołaj self.assertEqual(actual, expected), podając najpierw wynik, a potem oczekiwaną wartość. Metoda sprawdza równość (==), nie tożsamość (is). Nierówność oznacza niepowodzenie asercji; opcjonalny argument msg pozwala dodać kontekst.

Jeśli oba argumenty mają dokładnie ten sam typ, assertEqual może użyć porównania właściwego dla tego typu, aby podać dokładniejszą diagnozę. Dotyczy to list, tuple, dict, set, frozenset, str i typów zarejestrowanych przez addTypeEqualityFunc(). Zgodność typów nie jest warunkiem równości.

setUp() przygotowuje dane przed każdą metodą testową, nie przed każdym podtestem. W pętli with self.subTest(text=text): oznacza sprawdzany przypadek, dzięki czemu raport wskazuje dane wejściowe, dla których asercja się nie powiodła. Bez failfast nieudana asercja w podteście nie przerywa kolejnych iteracji.

Wyjątki sprawdzaj za pomocą assertRaises. W with self.assertRaises(ValueError): wykonaj sprawdzaną operację wewnątrz bloku. W formie self.assertRaises(ValueError, int, text) przekaż funkcję bez wywoływania jej i podaj jej argument osobno. Oczekiwany wyjątek lub jego podklasa spełnia asercję; brak wyjątku oznacza niepowodzenie, a inny wyjątek nie jest przechwytywany przez tę asercję.

Przykłady

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

Wynik

2 tests passed

`test_direct` wykonuje trzy zwykłe porównania i sprawdza wyjątek w bloku `with`. `test_subtests` sprawdza te same dane w oznaczonych podtestach i używa formy z przekazaną funkcją. Liczba `2` oznacza metody testowe, a nie podtesty.

Powiązane lekcje

  • Python · Lekcja 37 · Zaawansowany · Wersja: 5
  • Python · Lekcja 34 · Średniozaawansowany · Wersja: 3

Źródła