Написание вашей первой Django-приложения, часть 8

Этот учебник начинается там, где закончился Учебник 7. Мы построили наше веб-приложение для опросов и теперь рассмотрим сторонние пакеты. Одним из преимуществ Django является богатый экосистема сторонних пакетов. Это пакеты, разработанные сообществом, которые могут быстро улучшить функциональность приложения.

В этом учебнике показано, как добавить Django Debug Toolbar, широко используемый сторонний пакет. Django Debug Toolbar в последние годы вошел в тройку самых используемых сторонних пакетов в опросе разработчиков Django.

Установка Django Debug Toolbar

Django Debug Toolbar — полезный инструмент для отладки веб-приложений Django. Это сторонний пакет, поддерживаемый организацией Jazzband. Панель инструментов помогает понять, как работает ваше приложение, и выявить проблемы. Она делает это, предоставляя панели, которые предоставляют отладочную информацию о текущем запросе и ответе.

Чтобы установить стороннее приложение, например, панель инструментов, вам необходимо установить пакет, выполнив приведенную ниже команду в активированной виртуальной среде. Это аналогично нашему предыдущему шагу по установке 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 требует нескольких этапов настройки. Следуйте инструкциям в руководстве по установке. Эти шаги не дублируются в этом учебнике, так как как сторонний пакет, он может меняться отдельно от графика Django.

После установки вы должны увидеть "ручку" DjDT справа от окна браузера при обновлении приложения polls. Щелкните ее, чтобы открыть панель отладки и использовать инструменты на каждой панели. См. страницу документации по панелям для получения дополнительной информации о том, что отображают панели.

Получение помощи от других

В какой-то момент вы столкнетесь с проблемой, например, панель инструментов может не отображаться. Когда это происходит, и вы не можете самостоятельно решить проблему, у вас есть варианты.

1. Если проблема связана с конкретным пакетом, проверьте, есть ли в документации пакета раздел по устранению неполадок или часто задаваемые вопросы. Например, у Django Debug Toolbar есть раздел с советами, в котором описаны варианты устранения неполадок.
2. Поищите аналогичные проблемы на трекере проблем пакета. Для Django Debug Toolbar он находится на GitHub.
3. Обратитесь к форуму Django.
4. Присоединяйтесь к серверу Discord Django.
5. Присоединяйтесь к каналу IRC #Django на Libera.chat.

Установка других сторонних пакетов

Существует множество других сторонних пакетов, которые вы можете найти, используя замечательный ресурс Django, Django Packages.

Сложно понять, какие сторонние пакеты вам следует использовать. Это зависит от ваших потребностей и целей. Иногда можно использовать пакет, который находится на стадии alpha. В другие моменты вам нужно убедиться, что он готов к использованию в продакшене. Adam Johnson опубликовал статью в блоге, в которой описан набор характеристик, по которым пакет можно считать «хорошо поддерживаемым». Django Packages предоставляет данные по некоторым из этих характеристик, например, о том, когда пакет был обновлен в последний раз.

Как указывает Адам в своей публикации, если ответ на один из вопросов — «нет», это возможность внести свой вклад.

Что дальше?

Начальный учебник заканчивается здесь. Между тем, вы можете изучить некоторые указания на куда двигаться дальше.

Если вы знакомы с пакетированием Python и хотите узнать, как преобразовать опросы в «многоразовое приложение», ознакомьтесь с Расширенный учебник: как создавать многоразовые приложения.