Написание первого приложения на Django, часть 8¶
Этот учебник начинается с того места, на котором остановился Tutorial 7. Мы создали наше веб-приложение для опроса и теперь рассмотрим пакеты сторонних разработчиков. Одним из достоинств Django является богатая экосистема пакетов сторонних разработчиков. Это пакеты, разработанные сообществом, которые могут быть использованы для быстрого расширения функциональности приложения.
В этом руководстве будет показано, как добавить Django Debug Toolbar, широко используемый пакет сторонних разработчиков. В последние годы Django Debug Toolbar входит в тройку наиболее используемых пакетов сторонних разработчиков по результатам опроса Django Developers Survey.
Где можно получить помощь:
Если у вас возникли проблемы с прохождением этого руководства, перейдите в раздел часто задаваемых вопросов Получение справки.
Установка панели инструментов отладки Django¶
Django Debug Toolbar - это полезный инструмент для отладки веб-приложений Django. Это сторонний пакет, поддерживаемый организацией Jazzband. Панель инструментов помогает понять, как функционирует ваше приложение, и выявить проблемы. Для этого в ней предусмотрены панели, предоставляющие отладочную информацию о текущем запросе и ответе.
Для установки стороннего приложения, например панели инструментов, необходимо установить пакет, выполнив приведенную ниже команду в активированной виртуальной среде. Это аналогично нашему предыдущему шагу install Django.
$ python -m pip install django-debug-toolbar
...\> py -m pip install django-debug-toolbar
Пакеты сторонних разработчиков, интегрируемые с Django, нуждаются в некоторой настройке после установки для их интеграции с вашим проектом. Часто требуется добавить Django-приложение пакета в настройки INSTALLED_APPS. Некоторые пакеты требуют других изменений, например, добавления в URLconf (urls.py).
Django Debug Toolbar требует нескольких шагов настройки. Следуйте им в its installation guide. Эти шаги не дублируются в данном руководстве, поскольку, будучи пакетом стороннего производителя, он может изменяться отдельно от расписания Django.
После установки вы должны увидеть «ручку» DjDT в правой части окна браузера при обновлении программы опроса. Щелкните по ней, чтобы открыть панель инструментов отладки и воспользоваться инструментами на каждой панели. Более подробную информацию о том, что показывают панели, см. в panels documentation page>.
Получение помощи от других¶
В какой-то момент вы столкнетесь с проблемой, например, панель инструментов может не отображаться. Если это происходит, и вы не можете решить проблему самостоятельно, есть несколько вариантов.
- Если проблема связана с конкретным пакетом, проверьте, есть ли в документации к пакету раздел FAQ по устранению неполадок. Например, в пакете Django Debug Toolbar есть Tips section, в котором описаны варианты устранения неполадок.
- Поиск похожих проблем на трекере проблем пакета. Django Debug Toolbar’s - это on GitHub.
- Проконсультируйтесь с Django Forum.
- Присоединяйтесь к Django Discord server.
- Присоединяйтесь к IRC-каналу #Django на сайте Libera.chat.
Установка других пакетов сторонних производителей¶
Существует множество других пакетов сторонних разработчиков, которые можно найти на фантастическом ресурсе Django, Django Packages.
Бывает трудно определить, какие пакеты сторонних разработчиков следует использовать. Это зависит от ваших потребностей и целей. Иногда можно использовать пакет, находящийся в состоянии альфа-версии. В других случаях необходимо знать, что он готов к производству. Adam Johnson has a blog post, в котором описывается набор характеристик, позволяющих отнести пакет к категории «хорошо поддерживаемых». Django Packages показывает данные для некоторых из этих характеристик, например, когда пакет был обновлен в последний раз.
Как отмечает Адам в своем посте, если ответ на один из вопросов - «нет», то это возможность внести свой вклад.
Что дальше?¶
Учебник для начинающих здесь заканчивается. Тем временем вы можете проверить что делать дальше.
Если вы знакомы с пакетами Python и хотите узнать, как превратить опросы в «повторно используемое приложение», ознакомьтесь с Расширенное руководство: как писать повторно используемые приложения.