É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 is a useful tool for debugging Django web applications. It’s a third-party package that is maintained by the community organization Django Commons. The toolbar helps you understand how your application functions and to identify problems. It does so by providing panels that provide debug information about the current request and response.
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.
Search for similar issues on the package’s issue tracker. Django Debug Toolbar’s is on 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.