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