1. Описание проекта
В мире Pokémon есть множество существ с разными типами, способностями и характеристиками. В играх для просмотра этой информации используется Pokédex — электронный справочник покемонов.
Задача: создать консольную версию Pokédex. Пользователь вводит имя покемона или его номер, а программа получает сведения из интернета и показывает их в понятном виде.
Источник данных: PokéAPI. Это открытый справочник, позволяющий получать сведения о покемонах с помощью запросов. В этом проекте программа только читает информацию, не изменяя её на сервере.
2. Сведения о покемоне
Для найденного покемона нужно отображать:
| Сведения | Пример |
|---|---|
| Номер в справочнике | 25 |
| Имя | Pikachu |
| Тип или типы | Electric |
| Рост | 40 см |
| Вес | 6 кг |
| Способности | Названия способностей из ответа сервиса |
| Здоровье (HP) | Базовое значение из ответа сервиса |
| Атака (Attack) | Базовое значение из ответа сервиса |
Пример нужен для понимания формата. Показатели HP и Attack — характеристики покемона из справочника, а не текущее здоровье персонажа в бою.
Для основной версии достаточно английских имён, которые используются в PokéAPI. Перевод названий на русский язык не требуется.
3. Что должна уметь программа
3.1. Главное меню
После запуска пользователь видит меню. Из него можно найти покемона, посмотреть историю успешных поисков за время работы или выйти из программы. После просмотра информации можно выполнить новый поиск.
3.2. Поиск по номеру
Пользователь вводит номер покемона. Программа обращается к PokéAPI и показывает сведения о найденном существе.
Если покемона с таким номером нет, программа сообщает, что он не найден, и предлагает выполнить новый поиск.
3.3. Поиск по имени
Пользователь вводит английское имя покемона, например pikachu или bulbasaur.
Программа находит покемона и показывает те же сведения, что и при поиске по номеру. Регистр букв не должен мешать поиску: PIKACHU и pikachu должны приводить к одному результату.
3.4. Отображение информации
Программа показывает все сведения, перечисленные в разделе 2. Если у покемона несколько типов или способностей, нужно показать все доступные значения, а не только первое.
Единицы измерения роста и веса должны соответствовать показанным числам. Информация должна быть оформлена так, чтобы её было удобно читать в консоли.
3.5. История поисков
Программа хранит историю успешно найденных покемонов за текущий запуск. Пользователь может открыть её в меню и увидеть имена и номера в порядке поиска.
Повторный поиск одного покемона тоже отображается в истории. Сохранять историю между запусками не требуется.
3.6. Неправильный ввод и ошибки сервиса
Если пользователь вводит пустое имя, неподходящий номер или покемона, которого нет в справочнике, программа сообщает об этом и предлагает повторить поиск.
Если интернет недоступен или PokéAPI не отвечает, программа не должна аварийно завершаться. В истории не появляются записи о неудачных поисках.
4. Примеры использования
Сценарий 1. Поиск по номеру
- Пользователь запускает Pokédex.
- Выбирает поиск по номеру.
- Вводит
25.
Результат: программа показывает сведения о Pikachu, включая номер, имя, тип, рост, вес, способности и две базовые характеристики.
Сценарий 2. Поиск по имени
- Пользователь выбирает поиск по имени.
- Вводит
BULBASAUR. - Программа получает сведения.
Результат: показана информация о Bulbasaur. Регистр букв не повлиял на поиск, а все его типы и способности отображены.
Сценарий 3. Покемон не найден
- Пользователь вводит имя, которого нет в PokéAPI.
- Программа не находит такого покемона.
- Пользователь вводит другое, существующее имя.
Результат: после понятного сообщения о неудачном поиске можно продолжить работу и успешно найти другого покемона.
Сценарий 4. История
- Пользователь последовательно ищет
25,bulbasaurи снова25. - Открывает историю поисков.
Результат: в истории три записи в порядке поиска: Pikachu, Bulbasaur, Pikachu.
Сценарий 5. Нет подключения к интернету
- Пользователь пытается выполнить поиск при недоступном интернете.
- Программа не может получить ответ PokéAPI.
Результат: программа сообщает об ошибке, остаётся работоспособной, а неудачный запрос не попадает в историю успешных поисков.
5. Как проверить готовность проекта
Проект готов, если:
- После запуска появляется меню с возможностью поиска, просмотра истории и выхода.
- Поиск работает как по номеру, так и по английскому имени покемона.
- Регистр букв в имени не влияет на успешность поиска.
- Данные действительно получаются из PokéAPI.
- Показываются номер, имя, все типы, рост, вес, все способности, HP и Attack.
- Рост и вес отображаются с правильными единицами измерения.
- История содержит только успешные поиски, в том числе повторные.
- Если покемон не найден или пользователь ошибся при вводе, можно продолжить поиск.
- Проблемы с интернетом не приводят к неожиданному закрытию программы.
- Все пять сценариев из предыдущего раздела выполняются по описанным правилам.
6. Дополнительные возможности
Это необязательные улучшения после завершения основной версии:
- Сравнение двух покемонов: вывести их характеристики рядом, чтобы пользователь мог увидеть различия.
- Избранное: добавлять покемонов в личный список и сохранять его в файл.
- Другие характеристики: показывать защиту, скорость и специальные характеристики.
- Случайный покемон: находить случайного покемона и предлагать пользователю узнать о нём больше.
- Русские названия: показывать доступные переводы имён и типов, если найдён надёжный источник переводов.
7. Результат работы
Нужно предоставить работающее консольное приложение Pokédex на Python и все файлы, необходимые для его запуска.
На демонстрации нужно найти покемона по номеру и по имени, показать несколько типов или способностей, открыть историю, выполнить поиск несуществующего покемона и продемонстрировать реакцию на недоступность сервиса.
Также нужно кратко объяснить, как запустить программу. Для получения информации нужен интернет.
Важно: здесь описано, что программа должна делать, но не указано, как её писать. Как организовать запросы, обработку данных и взаимодействие частей программы — решает разработчик.