Appearance
Статические тесты: assert и первый pytest
Программа телефонной книги работает. Но как понять, что она не сломана? Ручной прогон «введу имя — посмотрю номер» — плохая проверка: сегодня вручную всё проверишь, а через месяц, когда поменяешь функцию, забудешь, и баг уйдёт в жизнь.
Тест — это программа, которая проверяет другую программу. Её запускают не от руки, а командой, и она сама отвечает: всё верно / вот что сломалось.
assert
Базовый инструмент проверки — оператор assert. Он говорит: «условие должно быть истинным». Если условие ложно — программа падает с AssertionError; если истинно — происходит ничего:
py
def add(a, b):
return a + b
assert add(2, 3) == 5, '2 + 3 должно дать 5'После условия принято писать сообщение — его увидит тот, кто ловит падение. Если тест молчит, значит, проверка прошла.
Первый pytest-тест
pytest — библиотека, установленная в прошлом уроке (pip install pytest). Она ищет тесты по правилам:
- файл называется
test_*.py(или*_test.py); - внутри — функции с именем
test_*.
Минимальный тест:
py
def test_add():
assert 2 + 3 == 5, '2 + 3 должно дать 5'Сохраните в файл test_first.py и запустите:
python -m pytest -vФлаг -v — подробный вывод:
test_first.py::test_add PASSEDPASSED — тест прошёл. Pytest сам находит все файлы test_*.py в папке и запускает все функции test_*.
Тестируем телефонную книгу
Разобьём книгу на функции и проверим каждую. Сами функции:
py
phone_book = {
'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'}
}
def find_phone(phone_book, name):
try:
return phone_book[name]['phone']
except KeyError:
return None
def add_friend(phone_book, name, city, phone):
phone_book[name] = {'city': city, 'phone': phone}Теперь файл test_phone_book.py с тестами:
py
from phone_book import find_phone, add_friend, phone_book
def test_find_phone_found():
assert find_phone(phone_book, 'Соня') == '+7 911 234-56-78'
def test_find_phone_missing():
assert find_phone(phone_book, 'Лена') is None
def test_add_friend():
book = {}
add_friend(book, 'Алина', 'Хабаровск', '+7 955 111-22-33')
assert book['Алина']['phone'] == '+7 955 111-22-33'
assert book['Алина']['city'] == 'Хабаровск'Запуск:
python -m pytest -vtest_phone_book.py::test_find_phone_found PASSED
test_phone_book.py::test_find_phone_missing PASSED
test_phone_book.py::test_add_friend PASSEDТри проверки, ни одной ручной. Заметьте: find_phone возвращает None на неизвестное имя — так тест не ловит KeyError, а проверяет аккуратное поведение функции. Логирование ошибки здесь тоже уместно, как в уроке про лог.
Как выглядит провал
Допустим, кто-то «поправил» функцию и стал возвращать 0 вместо None. Тест упадёт:
test_phone_book.py::test_find_phone_missing FAILED
def test_find_phone_missing():
> assert find_phone(phone_book, 'Лена') is None
E AssertionError: assert 0 is NonePytest показал конкретную строку и конкретное расхождение: ожидалось None, пришло 0. Правило: когда тест падает, чинят функцию, а не тест — тест фиксирует то, как программа должна работать.
Где дальше
Здесь — первый pytest-тест: файл, функция, assert, запуск. Дальше pytest умеет гораздо больше: фикстуры, классы тестов, прогон по папкам. Это отдельный курс — «Тестирование в Python».
Упражнения
- Напишите три проверки через
assert: (а)10 % 3равно1; (б) список городов содержит'Омск'; (в)'серёга'.upper()равно'СЕРЁГА'. К каждомуassertдобавьте сообщение.
py
# допишите код ниже- Напишите функцию
is_adult(age), возвращающуюTrue, если возраст не меньше 18, иначеFalse. Напишите к ней триassert-проверки: для 17, 18 и 45.
py
def is_adult(age):
# допишите код ниже- У Виты функция поиска:
py
def find_phone(phone_book, name):
try:
return phone_book[name]['phone']
except KeyError:
return NoneНапишите два теста: test_find_phone_found — для имени, которое есть в книге, и test_find_phone_missing — для имени, которого нет (ожидается None). Кладите обе проверки в файл test_find_phone.py.
py
phone_book = {
'Серёга': {'city': 'Омск', 'phone': '+7 900 123-45-67'},
'Соня': {'city': 'Москва', 'phone': '+7 911 234-56-78'}
}
# допишите код ниже- Напишите функцию
add_friend(phone_book, name, city, phone), добавляющую запись в книгу, и тестtest_add_friend: начинаете с пустой книги, добавляете Алину, проверяете и город, и телефон.
py
def add_friend(phone_book, name, city, phone):
# допишите код ниже- Напишите тест
test_double_add, который дважды добавляет одного и того же друга с разным городом и проверяет, что в книге остался один друг, а город — последний. Запустите тест — он должен упасть. Прочитайте сообщение pytest и объясните в комментарии, где расхождение.
py
# допишите код ниже- Соберите все свои тесты этого урока в файлы
test_*.pyи запуститеpython -m pytest -v. Запишите в комментарий к коду: сколько тестов прошло, сколько упало, и что вы поменяли, чтобы они прошли (функцию или тест).
# допишите команду и результат ниже