← Все проекты
Средний

Поисковик книг

Требования к проекту

1. Описание проекта

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

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

Источник данных: Open Library — Search API. Для поиска используется общедоступная информация о книгах; регистрация читателя для этого проекта не нужна.

2. Сведения о книге

В результатах поиска и в избранном для каждой книги должны отображаться:

Сведения Пример
Название The Hobbit
Автор или авторы J. R. R. Tolkien
Год первой публикации 1937

Пример показывает формат, а не гарантирует, что все поля всегда будут заполнены. Если сервис не указал автора или год, программа должна написать, что эти сведения неизвестны, а не прекращать работу.

3. Что должна уметь программа

3.1. Главное меню

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

3.2. Поиск по названию

Пользователь вводит название книги или его часть. Программа отправляет запрос к Open Library и показывает до пяти найденных книг.

Для каждой книги выводятся название, автор (или авторы) и год первой публикации, если он известен. Результаты должны быть пронумерованы, чтобы пользователь мог выбрать одну из найденных книг.

Если ничего не найдено, программа сообщает об этом. Пустой поисковый запрос не отправляется на сервер.

3.3. Поиск по автору

Пользователь может искать книги по имени или фамилии автора. Результаты оформляются так же, как при поиске по названию: не больше пяти книг за один запрос, с названием, автором и годом при наличии.

3.4. Добавление книги в избранное

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

Если такая книга уже находится в избранном, второй экземпляр той же записи добавлять не нужно. Программа сообщает об этом пользователю. В то же время разные книги с похожими названиями не должны автоматически считаться одинаковыми.

3.5. Просмотр и удаление избранного

Пользователь может открыть список избранных книг даже без нового интернет-запроса. В списке отображаются сохранённые сведения о книгах.

Любую книгу из избранного можно удалить. Перед удалением программа просит подтверждение. Если список пуст, нужно показать соответствующее сообщение.

3.6. Сохранение избранного

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

Если программа запускается впервые и файла ещё нет, избранное считается пустым. Формат файла и способ хранения выбирает разработчик.

3.7. Неправильный ввод и ошибки сети

Если пользователь выбирает отсутствующий пункт меню, несуществующий номер книги или ошибается при удалении, программа предлагает повторить действие.

Если Open Library недоступен или ответ нельзя обработать, программа показывает понятное сообщение. Уже сохранённое избранное при этом должно оставаться доступным.

4. Примеры использования

Сценарий 1. Поиск по названию

  1. Пользователь выбирает поиск по названию.
  2. Вводит The Hobbit.
  3. Программа отправляет запрос и получает результаты.

Результат: показан пронумерованный список из не более пяти найденных книг. Для каждой доступны название, автор и год, если они присутствуют в ответе.

Сценарий 2. Поиск по автору

  1. Пользователь выбирает поиск по автору.
  2. Вводит Tolkien.
  3. Просматривает найденные книги.

Результат: программа показывает подходящие записи в том же формате, что и при поиске по названию.

Сценарий 3. Добавление в избранное

  1. Пользователь находит книгу.
  2. Добавляет её в избранное.
  3. Повторяет поиск и пытается добавить ту же самую книгу ещё раз.

Результат: в избранном одна запись этой книги. Программа сообщает, что повторное добавление не требуется.

Сценарий 4. Удаление из избранного

  1. Пользователь открывает избранное.
  2. Выбирает книгу для удаления.
  3. Сначала отказывается от удаления, затем повторяет действие и подтверждает его.

Результат: после отказа книга остаётся; после подтверждения исчезает.

Сценарий 5. Повторный запуск

  1. Пользователь добавляет две книги в избранное.
  2. Закрывает программу и запускает её заново.
  3. Открывает избранное без поиска в интернете.

Результат: обе книги сохранены и доступны для просмотра.

Сценарий 6. Нет результата или интернета

  1. Пользователь вводит название, по которому ничего не найдено, либо временно отключает интернет.
  2. Программа не может показать результаты поиска.
  3. Пользователь открывает ранее сохранённое избранное.

Результат: появляется понятное сообщение о проблеме поиска, а избранное продолжает работать.

5. Как проверить готовность проекта

Проект готов, если:

  • В меню доступны поиск по названию, поиск по автору, избранное и выход.
  • Поиск выполняется через Open Library, а не по заранее записанному списку книг.
  • В результатах показывается не больше пяти книг, и пользователь может выбрать нужную.
  • Для каждой книги выводятся доступные название, авторы и год; отсутствие отдельных сведений не ломает программу.
  • Книгу можно добавить в избранное, но повтор той же книги не создаёт дубликат.
  • Избранное можно просматривать и изменять, не выполняя нового поиска.
  • Удаление можно подтвердить или отменить.
  • Избранное сохраняется в текстовом файле и доступно после перезапуска.
  • Пустые запросы, неправильный выбор и проблемы с интернетом обрабатываются без неожиданного завершения программы.
  • Все шесть сценариев работают так, как описано.

6. Дополнительные возможности

Это необязательные улучшения после завершения основной версии:

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

7. Результат работы

Нужно предоставить работающее консольное приложение на Python и все файлы, необходимые для запуска и сохранения избранного.

На демонстрации нужно показать поиск по названию и автору, добавление книги в избранное, отказ от повторного добавления, удаление с подтверждением и сохранение избранного после перезапуска.

Также нужно кратко объяснить, как запустить программу. Для поиска нужен интернет, но сохранённое избранное должно открываться и без него.


Важно: здесь описано, что программа должна делать, но не указано, как её писать. Как хранить данные, какие функции создать и как организовать взаимодействие с API — решает разработчик.