Написание вашего первого приложения 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 справа от окна браузера при просмотре страницы http://localhost:8000/admin/. Нажмите на неё, чтобы открыть инструментальную панель отладки и использовать инструменты каждой панели. См. страницу документации панелей для получения дополнительной информации о том, что показывают панели.

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

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

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

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

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

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

Как отмечает Адам в своём посте, когда ответ на один из вопросов — «нет», это возможность внести свой вклад.

Что дальше?

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

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