База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

assertEqual в unittest: сравняване на резултат с очаквана стойност

Сравнявай резултата с очакваната стойност чрез `assertEqual`, подготвяй данните в `setUp` и проверявай различни входни стойности и изключения.

Версия: Python 3.12

Синтаксис

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

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

В Python 3.12 assertEqual е метод на unittest.TestCase. При self.assertEqual(actual, expected) подай първо получения резултат, а след това очакваната стойност. Методът проверява равенство (==), а не идентичност (is). Ако стойностите не са равни, проверката се проваля; незадължителният аргумент msg добавя контекст.

Ако двата операнда са от точно един и същ тип, assertEqual може да използва сравнение, специфично за този тип, и да даде по-информативно съобщение при неуспех. Това важи за list, tuple, dict, set, frozenset, str и за типове, регистрирани чрез addTypeEqualityFunc(). Стойностите могат да са равни и без да са от един и същ тип.

setUp() подготвя данните преди всеки тестов метод, а не преди всеки подтест. В цикъл with self.subTest(text=text): обозначава случая, така че отчетът за неуспех да посочи входната стойност. Ако failfast е изключен, неуспешната проверка в един подтест не спира следващите итерации.

Проверявай изключения с assertRaises. Изпълни операцията в блока with self.assertRaises(ValueError):. При self.assertRaises(ValueError, int, text) подай функцията, без да я извикваш, и посочи аргумента ѝ отделно. Очакваното изключение или негов подклас удовлетворява проверката; ако няма изключение, проверката се проваля, а друго изключение се предава нататък.

Примери

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

Резултат

2 tests passed

`test_direct` прави три преки сравнения и проверява изключението в блок `with`. `test_subtests` използва същите входни стойности в обозначени подтестове и подава функцията на `assertRaises`. Числото `2` брои тестовите методи, а не подтестовете.

Свързани уроци

  • Python · Урок 37 · Напреднало · Версия: 5
  • Python · Урок 34 · Средно · Версия: 3

Източници