Écriture de votre première application Django, 8ème partie¶
Ce tutoriel commence là où le tutoriel 7 s’est arrêté. Nous avons construit une application de sondage web et allons maintenant examiner les paquets tiers. L’une des forces de Django est son riche écosystème de paquets tiers. Ce sont des paquets développés par la communauté qui peuvent être utilisés pour enrichir rapidement les fonctionnalités d’une application.
Ce tutoriel va vous montrer comment ajouter la barre d’outils de débogage Django Debug Toolbar, un paquet tiers couramment utilisé. Django Debug Toolbar figure dans les trois paquets tiers les plus souvent installés dans les résultats du sondage Django Developers Survey de ces dernières années.
Où obtenir de l’aide :
Si vous rencontrez des problèmes dans le parcours de ce tutoriel, rendez-vous dans la section Obtenir de l’aide de la FAQ.
Installation de Django Debug Toolbar¶
Django Debug Toolbar est un outil bien utile pour déboguer les applications web Django. Il s’agit d’un paquet tiers maintenu par l’organisation Jazzband. Cette barre d’outils aide à comprendre comment une application fonctionne et sert à identifier des problèmes. Elle le fait en fournissant des panneaux présentant des informations de débogage sur la requête et la réponse de la page en cours.
Pour installer une application tierce telle que cette barre d’outils, il est nécessaire d’installer le paquet en exécutant la commande ci-dessous dans un environnement virtuel activé. C’est le même procédé que pour l’installation de Django présentée dans une étape précédente.
$ python -m pip install django-debug-toolbar
...\> py -m pip install django-debug-toolbar
Les paquets tiers qui s’intègrent à Django ont besoin d’une phase de post-installation pour qu’ils s’intègrent dans votre projet. Il s’agit fréquemment d’ajouter l’application du paquet au réglage INSTALLED_APPS
. Certains paquets ont besoin d’autres modifications, comme des ajouts à la configuration d’URL (urls.py
).
Django Debug Toolbar nécessite plusieurs étapes de configuration. Suivez-les dans son guide d’installation. Ces étapes ne sont pas reproduites dans ce tutoriel, car faisant partie d’un paquet tiers, elles peuvent être modifiées indépendamment du cycle de Django.
Une fois installée, vous devriez voir apparaître la « poignée » DjDT sur la partie droite de la fenêtre du navigateur lorsque vous accédez à http://localhost:8000/admin/
. Cliquez dessus pour ouvrir la barre de débogage et utiliser les outils de chaque panneau. Consultez la page de documentation des panneaux pour plus de détails sur le contenu de chacun des panneaux.
Obtenir de l’aide¶
À un moment ou à un autre, vous rencontrerez des problèmes. Par exemple, la barre pourrait ne pas s’afficher. Lorsque cela arrive et que vous n’êtes pas capable de le résoudre vous-même, vous avez plusieurs possibilités.
Si le problème est lié à un paquet en particulier, vérifiez s’il existe un guide de dépannage ou une FAQ dans la documentation du paquet. Par exemple, pour Django Debug Toolbar, il existe une section Tips qui présente des options de dépannage.
Recherchez des problèmes semblables dans le système de suivi des tickets du paquet. Pour Django Debug Toolbar, cela se trouve sur GitHub.
Consultez le forum de Django.
Rejoignez le serveur Discord de Django.
Rejoignez le canal IRC #Django sur Libera.chat.
Installation d’autres paquets tiers¶
Il existe bien d’autres paquets tiers que vous pouvez découvrir en utilisant l’excellente ressource Django, Django Packages.
Il peut être difficile de savoir quel paquet tiers utiliser. Cela dépend des vos besoins et de vos objectifs. Dans certains cas, il peut être acceptable d’utiliser un paquet dans un stade alpha. D’autres fois, vous avez besoin d’être sûr qu’il est prêt pour la production. Adam Johnson a écrit un article qui détaille un ensemble de caractéristiques qui permettent de qualifier un paquet comme «bien maintenu». Le site Django Packages affiche des données sur certaines de ces caractéristiques, telles que la date de dernière mise à jour du paquet.
Comme Adam le signale dans son article, lorsque la réponse à l’une des questions est «non», c’est une opportunité de contribuer.
Et ensuite ?¶
Le tutoriel d’introduction se termine ici. Dans l’intervalle, vous pouvez toujours consulter quelques ressources sur la page des prochaines étapes.
Si vous êtes à l’aise avec la création de paquets Python et intéressé à apprendre comment faire de l’application de sondage une « application réutilisable », consultez le Tutoriel avancé : comment écrire des applications réutilisables.