Написание первого приложения на Django, часть 8¶
Этот учебник начинается с того места, на котором остановился Tutorial 7. Мы создали наше веб-приложение для опроса и теперь рассмотрим пакеты сторонних разработчиков. Одним из достоинств Django является богатая экосистема пакетов сторонних разработчиков. Это пакеты, разработанные сообществом, которые могут быть использованы для быстрого расширения функциональности приложения.
В этом руководстве будет показано, как добавить Django Debug Toolbar, часто используемый сторонний пакет. Панель инструментов Django Debug Toolbar за последние годы вошла в тройку наиболее часто используемых сторонних пакетов в опросе разработчиков Django.
Где можно получить помощь:
Если у вас возникли проблемы с прохождением этого руководства, перейдите в раздел часто задаваемых вопросов Получение справки.
Установка панели инструментов отладки Django¶
Панель инструментов Django Debug Toolbar - это полезный инструмент для отладки веб-приложений Django. Это сторонний пакет, который поддерживается организацией community Django Commons. Панель инструментов помогает вам понять, как работает ваше приложение, и выявить проблемы. Он делает это путем предоставления панелей, которые предоставляют отладочную информацию о текущем запросе и ответе.
Для установки стороннего приложения, например панели инструментов, необходимо установить пакет, выполнив приведенную ниже команду в активированной виртуальной среде. Это аналогично нашему предыдущему шагу 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 в правой части окна браузера, когда перейдете к http://localhost:8000/admin/. Щелкните по нему, чтобы открыть панель инструментов отладки и использовать инструменты на каждой панели. Смотрите panels documentation page для получения дополнительной информации о том, что показывают панели.
Получение помощи от других¶
В какой-то момент вы столкнетесь с проблемой, например, панель инструментов может не отображаться. Если это происходит, и вы не можете решить проблему самостоятельно, есть несколько вариантов.
- Если проблема связана с конкретным пакетом, проверьте, есть ли в документации к пакету раздел FAQ по устранению неполадок. Например, в пакете Django Debug Toolbar есть Tips section, в котором описаны варианты устранения неполадок.
- Найдите похожие проблемы в системе отслеживания проблем с пакетом. Панель инструментов отладки Django имеет значение on GitHub.
- Проконсультируйтесь с Django Forum.
- Присоединяйтесь к Django Discord server.
Установка других пакетов сторонних производителей¶
Существует множество других пакетов сторонних разработчиков, которые можно найти на фантастическом ресурсе Django, Django Packages.
Бывает трудно определить, какие пакеты сторонних разработчиков следует использовать. Это зависит от ваших потребностей и целей. Иногда можно использовать пакет, находящийся в состоянии альфа-версии. В других случаях необходимо знать, что он готов к производству. Adam Johnson has a blog post, в котором описывается набор характеристик, позволяющих отнести пакет к категории «хорошо поддерживаемых». Django Packages показывает данные для некоторых из этих характеристик, например, когда пакет был обновлен в последний раз.
Как отмечает Адам в своем посте, если ответ на один из вопросов - «нет», то это возможность внести свой вклад.
Что дальше?¶
Учебник для начинающих здесь заканчивается. Тем временем вы можете проверить что делать дальше.
Если вы знакомы с пакетами Python и хотите узнать, как превратить опросы в «повторно используемое приложение», ознакомьтесь с Расширенное руководство: как писать повторно используемые приложения.