Программа курса Урок 241 из 250 · Итоговый проект: Отправка (Упаковка вашего проекта)
Итоговый проект: Отправка (Упаковка вашего проекта)

Напишите Test Harness

Пустая tests/ папка никого не обманет. В тот момент, когда рецензент видит реальные тесты, происходят две вещи: они больше доверяют коду, и они больше доверяют you, потому что тесты являются доказательством того, что вы подумали о том, что значит "правильно". В реальном репозитории вы запустите их с помощью pytest (одна команда, она будет рассмотрена в следующем уроке). Но внутри тест-фреймворк это не магия -> это цикл, который запускает вашу функцию на известных входных данных и проверяет результат. Создание этого цикла самостоятельно один раз лишает всё происходящее тайны.

Итак, этот урок проверяет, как преподавать обычный детерминированный код. Вы пишете крошечный harness:

  • run_checks(fn, cases) -> cases это список пар (args_tuple, expected). Вызывайте fn(*args) для каждого случая, сравнивайте результат с expected и возвращайте список {"args": args, "ok": bool} с записью о том, какие случаи прошли. Если при вызове возникает fn, этот случай считается неудачей (ok=False), а не сбоем, который останавливает весь запуск -> настоящий запуск тестов сообщает о неудаче и продолжает работу.
  • all_pass(results) -> True только если есть хотя бы один результат и у каждого есть ok=True. Пустой list результатов означает, что ничего не было проверено, так что это not не прохождение. Это сигнал "green build": один boolean, который говорит, что весь suite в порядке.

Почему важно правило «хотя бы один»: набор тестов, который молча запускает ноль тестов и сообщает об успехе, хуже, чем отсутствие тестов, потому что он дает ложное доверие. Защита пустого случая это разница между тестовым стендом, который имеет смысл, и тем, который всегда говорит да.

Пример работы. Допустим, ваш проект предоставляет add(a, b). Вы пишете кейсы [((1, 2), 3), ((0, 0), 0), ((5, 5), 10)]. Корректный adder проходит все три -> all_pass это True. Багная версия, которая вычитает, возвращает -1, 0, 0 -> два кейса не проходят, all_pass это False, и ваш harness просто caught a regression. В этом вся ценность тестов в одном предложении: корректная функция и сломанная дают вам разные ответы автоматически.

Постройте с простым try/except вокруг вызова, чтобы функция повышения считалась неудачным случаем. Нажмите Run, чтобы использовать правильный сумматор и увидеть, как каждый случай становится зеленым.

Твоя очередь

Создайте минимальный тестовый стенд. Напишите run_checks(fn, cases), где cases это список (args_tuple, expected): вызовите fn(*args) для каждого и верните список {"args": args, "ok": bool}, помечающий, какие случаи соответствуют expected (функция, которая вызывает makes, делает этот случай ok=False, без сбоя). Напишите all_pass(results), возвращающий True только тогда, когда есть хотя бы один результат и каждый ok это True (пустой список это False). Корректная функция и багнутая должны получать разные вердикты.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.