Как проверить Python-код: линтер, тесты и приёмка

← Все подборки материалов

Разработка · 4 материала

Python-код проверяют разными способами, потому что вопросы различаются. Линтер исследует исходный текст по правилам; тест функции сравнивает результат на выбранном входе; тест класса проверяет состояние и поведение объекта; приёмочный сценарий связывает программу с требованием пользователя. Успех на одном уровне не закрывает остальные автоматически.

4 материала по задачеПерейти к инструкциям ↓
В этой подборке

Материалы подборки

Выберите инструкцию под свою задачу. Ниже — подробный разбор выбора и проверки результата.

Выберите вопрос к существующему коду

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

Ваш вопрос Проверка Свидетельство
Есть ли нарушения выбранных правил и подозрительные конструкции? Статический анализ и отдельно форматирование Отчёт с набором применённых правил и рассмотренными замечаниями
Как функция отвечает на конкретный вход? Тест функции Сравнение фактического результата с независимо заданным ожидаемым
Сохраняет ли объект нужное поведение после действий? Тест класса Проверка начального состояния, перехода и результата отказа
Получил ли пользователь обещанный результат? Приёмочный сценарий Начальное состояние, действие и наблюдаемый итог по исходной постановке

Эти проверки могут требоваться вместе. Понятное название теста не подтверждает его содержание, а зелёный отчёт не доказывает правильность непроверенного условия. Перед запуском назовите, какой вывод собираетесь сделать и какое свидетельство для него нужно.

Статический анализ: прочитайте замечания

Линтер проверяет код без выполнения пользовательского сценария. Ruff также имеет роль форматтера, но оформление и поиск нарушений правил — разные действия. Узнайте, какая конфигурация применяется в вашем проекте и какие файлы включены в проверку. Чистый отчёт ограничен именно этим набором правил и областью анализа.

Не считайте Ruff полноценной заменой отдельной проверки типов. Не включайте автоисправления вслепую: сначала рассмотрите предлагаемые изменения, затем прочитайте diff и повторите затронутые проверки. Исчезновение предупреждения после удаления нужного кода — очевидно плохое исправление, хотя формально отчёт мог стать чистым.

Поведение: задайте ожидаемое до запуска

Для функции выберите обычный вход, важную границу и недопустимые данные, если она должна их отвергать. Ожидаемый результат посчитайте или определите независимо от реализации. Если тест повторяет ту же ошибочную формулу, совпадение двух вычислений будет слабым доказательством.

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

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

Приёмка: вернитесь к требованию

До запуска сформулируйте критерии по постановке задачи. Для учебного списка это может быть условие «после сохранения новая запись видна в списке», если именно оно согласовано. Наличие внутреннего объекта в памяти ещё не подтверждает показ на экране. Условие о редактировании, приоритете или уведомлениях нельзя добавлять только потому, что его предложила модель.

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

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