Написание unit-тестов

Среди всех тестов львиную долю занимают именно unit-тесты. В классическом понимании unit-тесты позволяют быстро и автоматически протестировать отдельные части ПО независимо от остальных.

В этой лабораторной работе мы рассмотрим простой пример создания unit-тестов. Работа основывается на задании первой лабораторной до удаления ветки, то есть со всеми фигурами: круг, треугольник, квадрат, прямоугольник.

Ручное тестирование

Начнём с простого варианта — ручного тестирования:

1. Зная алгоритм нахождения периметра и площади фигуры, определяем наборы входных данных, которые будут переданы на вход программе.
2. Зная входные данные, вручную просчитываем, какой ответ должна дать программа.
3. Запускаем программу и передаём ей на вход исходные данные.
4. Получаем ответ и сравниваем с ожидаемым. Если совпадают — идём к следующему набору данных, если нет — фиксируем ошибку в протоколе тестирования.

Unittest

Обычно Python поставляется уже с пакетом unittest. Если в вашей системе его нет, установите через pip.

Формат кода

• Тесты должны быть написаны в классе.
• Класс должен наследоваться от базового класса unittest.TestCase.
• Имена всех функций-тестов должны начинаться с test.
• Внутри функций должны быть вызовы операторов сравнения (assertX) — именно они проверяют полученные значения на соответствие заявленным.

Пример для нашей задачи

import unittest
 
...
 
class RectangleTestCase(unittest.TestCase):
    def test_zero_mul(self):
        res = area(10, 0)
        self.assertEqual(res, 0)
 
    def test_square_mul(self):
        res = area(10, 10)
        self.assertEqual(res, 100)

Запускается этот код командой:

python -m unittest rectangle.py

В результате на экран будет выведено:

C:\GSS\git_test>python -m unittest rectangle.py
..
----------------------------------------------------------------------
Ran 2 tests in 0.001s
 
OK

Если в каком-нибудь из тестов будет обнаружена ошибка, unittest вернёт:

C:\GSS\git_test>python -m unittest rectangle.py
F.
======================================================================
FAIL: test_square_mul (rectangle.RectangleTestCase)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\GSS\git_test\rectangle.py", line 16, in test_square_mul
    self.assertEqual(res, 100)
AssertionError: 110 != 100
 
----------------------------------------------------------------------
Ran 2 tests in 0.002s
 
FAILED (failures=1)

Подготовка отчёта

В отчёте нужно написать план тестирования, который минимально содержит следующие пункты:

Исходный код тестов должен лежать на GitHub (или в другом общедоступном репозитории), а в истории документа должен быть отражён факт появления тестов. При форматировании документа опирайтесь на опыт второй лабораторной работы.

• Тесты написаны на unittest: класс-наследник unittest.TestCase, методы начинаются с test, проверки через assertX.
• Покрыты все четыре фигуры: круг, треугольник, квадрат, прямоугольник.
• Исходный код фигур не изменён.
• Тесты лежат в общедоступном репозитории, их появление видно в истории коммитов.
• В отчёте есть план тестирования со всеми восемью пунктами, включая актуальные результаты и выводы.

Отчёт с планом тестирования и ссылкой на репозиторий с тестами. Проваленные тесты не снижают оценку сами по себе, если в выводах объяснено, почему они провалились.