Определите, что считается результатом
Решите, является ли строка из пробелов пустой и учитывается ли последняя строка без завершающего переноса. Отдельно опишите случай пустого файла. Эти договорённости образуют контракт функции. Если их нет, два исполнителя могут получить разные ответы и оба считать решение правильным. Полезно записать вход и выход до реализации. В учебном примере функция получает текст и возвращает целое число непустых строк. Путь к файлу и сообщения пользователю пока остаются за её пределами.
Разделите вычисление и взаимодействие со средой
Чтение файла зависит от файловой системы, прав и кодировки, а подсчёт строк можно проверить на обычной строковой переменной. Поэтому удобно отделить функцию обработки от оболочки, которая получает путь и читает данные. Затем отдельный небольшой участок показывает результат. Такое разделение упрощает повторное использование: тот же подсчёт пригодится для текста из формы или теста. Оно также облегчает поиск ошибки. Если число неверно уже на коротком тексте, проблема находится в обработке, а не в настройках файла.
Обрабатывайте ожидаемые ошибки явно
Отсутствующий файл, недоступный путь и некорректная кодировка требуют понятного исхода. В Python исключения позволяют отделять обычный ход программы от таких ситуаций. Перехватывать следует ожидаемые случаи на подходящем уровне. Безусловное подавление всех ошибок способно скрыть дефект самой программы. Сообщение пользователю должно объяснять, что не удалось сделать, а технические подробности можно сохранять отдельно. Ошибка чтения не должна превращаться в успешный результат ноль строк. Это разные состояния, даже если на экране хочется показать одно короткое число.
Проверьте поведение до расширения задачи
Начните с маленьких примеров, ожидаемый результат которых известен заранее. Проверьте пустой текст, одну строку, несколько строк, пробелы между ними и отсутствие переноса в конце. Затем отдельно проверьте оболочку на несуществующем пути. Модульные тесты фиксируют эти ожидания и помогают заметить изменение поведения при правках. Названия тестов полезно связывать с конкретным условием. После этого можно добавлять дополнительные возможности, сохраняя прежние проверки. Расширение функциональности без ясного контракта обычно усложняет и код, и объяснение ошибок.
Попробуйте на практике
Спроектируйте утилиту подсчёта непустых строк и составьте тесты без обращения к реальным личным файлам.
- Запишите правило: строка из одних пробелов считается пустой, последняя строка учитывается независимо от завершающего переноса.
- Подготовьте пять коротких вымышленных текстов и вручную посчитайте ожидаемые результаты.
- Разделите программу на чтение, подсчёт и вывод. Укажите, какие данные передаются между частями.
- Добавьте два сценария ошибки чтения и опишите сообщение для пользователя, отличающее их от успешного нулевого результата.
Как проверить результат. Для каждого теста есть однозначный ответ. Вычисление проверяется отдельно от файла, а ошибки ввода не маскируются числом ноль.
Частые вопросы
Нужна ли сложная архитектура для маленькой программы?
Нет. Достаточно понятных границ между вводом, обработкой и выводом. Избыточное количество слоёв может мешать так же, как их полное отсутствие.
Почему полезен тест на пустой вход?
Он проверяет границу задачи, на которой часто проявляются неверные предположения. Такой тест короткий и легко проверяется вручную.
Самостоятельный разбор темы. Содержание конкретной обучающей программы здесь не представлено.