Skip to content

Статические тесты: 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 PASSED

PASSED — тест прошёл. 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 -v
test_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 None

Pytest показал конкретную строку и конкретное расхождение: ожидалось None, пришло 0. Правило: когда тест падает, чинят функцию, а не тест — тест фиксирует то, как программа должна работать.

Где дальше ​

Здесь — первый pytest-тест: файл, функция, assert, запуск. Дальше pytest умеет гораздо больше: фикстуры, классы тестов, прогон по папкам. Это отдельный курс — «Тестирование в Python».


Упражнения ​

  1. Напишите три проверки через assert: (а) 10 % 3 равно 1; (б) список городов содержит 'Омск'; (в) 'серёга'.upper() равно 'СЕРЁГА'. К каждому assert добавьте сообщение.
py
# допишите код ниже
  1. Напишите функцию is_adult(age), возвращающую True, если возраст не меньше 18, иначе False. Напишите к ней три assert-проверки: для 17, 18 и 45.
py
def is_adult(age):
    # допишите код ниже
  1. У Виты функция поиска:
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'}
}
# допишите код ниже
  1. Напишите функцию add_friend(phone_book, name, city, phone), добавляющую запись в книгу, и тест test_add_friend: начинаете с пустой книги, добавляете Алину, проверяете и город, и телефон.
py
def add_friend(phone_book, name, city, phone):
    # допишите код ниже
  1. Напишите тест test_double_add, который дважды добавляет одного и того же друга с разным городом и проверяет, что в книге остался один друг, а город — последний. Запустите тест — он должен упасть. Прочитайте сообщение pytest и объясните в комментарии, где расхождение.
py
# допишите код ниже
  1. Соберите все свои тесты этого урока в файлы test_*.py и запустите python -m pytest -v. Запишите в комментарий к коду: сколько тестов прошло, сколько упало, и что вы поменяли, чтобы они прошли (функцию или тест).
# допишите команду и результат ниже