Создание первого приложения на Django, часть 8

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

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

Чтобы установить стороннее приложение, например панель инструментов, установите пакет, выполнив приведённую ниже команду в активированной виртуальной среде. Это аналогично нашему предыдущему шагу по установке Django.

$ python -m pip install django-debug-toolbar

...\> py -m pip install django-debug-toolbar

Для интеграции с Django сторонним пакетам после установки требуется дополнительная настройка проекта. Часто нужно добавить приложение Django из пакета в параметр INSTALLED_APPS. Некоторым пакетам нужны и другие изменения, например дополнения к конфигурации URL (urls.py).

Для Django Debug Toolbar требуется выполнить несколько шагов настройки. Следуйте руководству по установке. Эти шаги не повторяются в данном руководстве, поскольку сторонний пакет может обновляться независимо от графика выпусков Django.

После установки при переходе на http://localhost:8000/admin/ вы должны увидеть «элемент управления» DjDT в правой части окна браузера. Нажмите на него, чтобы открыть панель отладки и воспользоваться инструментами на каждой панели. Подробнее о содержимом панелей читайте на странице документации по панелям.

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

Рано или поздно вы столкнётесь с проблемой — например, панель инструментов может не отображаться. Если это произошло и вам не удаётся самостоятельно решить проблему, можно воспользоваться несколькими вариантами.

1. Если проблема связана с определённым пакетом, проверьте, есть ли в его документации руководство по устранению неполадок или раздел часто задаваемых вопросов. Например, в Django Debug Toolbar есть раздел с советами, где описаны способы устранения неполадок.
2. Поищите похожие проблемы в системе отслеживания ошибок пакета. У Django Debug Toolbar она находится на GitHub.
3. Обратитесь к форуму Django.
4. Присоединитесь к серверу Django в Discord.

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

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

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

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

Что дальше?

На этом руководство для начинающих заканчивается. А пока вы можете ознакомиться с рекомендациями о том, куда двигаться дальше.

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