Les bases de Django

00:00:00 :Dans cette vidéo, on va voir comment inclure les URL de notre application de blog à l'intérieur de notre projet Django.Pour l'instant, je suis dans le fichier urls.py de DocBlog
00:00:11 :dans lequel j'ai deux chemins qui sont définis.Le chemin pour la vue de l'index et le chemin pour admin qui est donc l'interface d'administration de Django.
00:00:20 :Ce qu'on va faire, c'est qu'on va créer un fichier URLs pour notre blog.Ce fichier, il n'est pas créé par défaut quand vous créez l'application avec la commande StartApp.
00:00:29 :Donc, c'est nous qui allons devoir le créer.Il faut savoir qu'on pourrait tout faire à l'intérieur du fichier d'URL de DocBlog.Ce n'est pas une obligation d'avoir un fichier d'URL par application,mais là encore, c'est une bonne pratique de séparer les choses et vous allez voir comment séparer les URL pour l'application des URL
00:00:46 :de mon projet actuel avec la vue index et la vue admin.Ce que je vais faire, c'est créer un fichier à l'intérieur de mon application blog.
00:00:54 :Je fais un fichier Python que j'appelle url.py.Je valide avec entrée.Et à l'intérieur de ce fichier, je vais créer des URL pour mon blog.
00:01:03 :Avant ça, je vais créer une vue qui va être une vue très simple,juste pour l'exemple, à l'intérieur du fichier views.py de mon application blog.
00:01:11 :Donc ici, je vais faire une vue que je vais appeler index également avec le paramètre request.Et on va retourner un HTTP response qui va contenir tout simplement un H1 qui va dire le blog.
00:01:24 :Rien de bien compliqué, c'est vraiment juste pour l'exemple.Et on n'oublie pas d'importer HTTP response, donc option entrée sur PyCharm.Je sélectionne le premier et automatiquement, l'import est fait.
00:01:34 :Je peux enlever l'import de Render qui ne me sert à rien car je n'utilise pas ici la fonction Render.Et voilà ma vue qui est créée, la vue index à l'intérieur de mon fichier views.py
00:01:44 :de mon application blog.Maintenant, ce qu'on va faire, c'est créer des chemins d'URL à l'intérieur du fichier URLs de notre blog.Donc ce qu'on va faire ici, c'est à peu près la même chose que ce qu'on a dans notre fichier URLs.py de l'application DocBlog.
00:01:59 :Donc ce que je vais faire, c'est créer une liste qui s'appelle URL patterns à l'intérieur de URL ici, donc URL patterns qui est une liste et qui va contenir les chemins pour mon blog.
00:02:10 :Donc je vais faire un chemin path et ce chemin, pour l'instant, il va pointer vers une chaîne de caractère vide.Donc là, j'ai quelques imports à faire puisqu'il faut que j'importe déjà la fonction path.
00:02:20 :Donc cet import, je peux le copier ici de mon fichier d'URL de DocBlog et je le colle ici pour que la fonction soit bien reconnue.
00:02:27 :Je vais ensuite importer la vue, donc la vue qui est à l'intérieur de views.py.Donc pour ça, je vais faire from.views import index et on va associer cette vue ici à notre chemin qui est une chaîne de caractère vide et on va lui donner un nom également.
00:02:42 :Donc le nom, on va mettre tout simplement blog-index.Alors le nom ici, vous voyez que je le préfixe avec le nom de l'application vu qu'on a déjà ici une URL qui s'appelle index.
00:02:53 :Donc ça, c'est l'URL index de mon application en général.Et ici, j'ai une URL index pour mon blog.Donc ça, c'est une nomenclature, vous n'êtes pas obligé de la suivre.
00:03:02 :Généralement, quand on met un nom, on préfixe avec le nom de l'application tout en minuscule avec un tiret pour séparer chaque mot.Donc actuellement, qu'est-ce qui se passe ?
00:03:11 :Eh bien, pas grand-chose parce que je n'ai pas inclus ce fichier d'URL dans mon fichier principal.Si vous vous souvenez bien, Django, il a juste un point d'entrée pour les URLs.
00:03:20 :C'est le point d'entrée qui est défini dans settings.py dans cette variable root-urlconf.Donc Django, quand il va résoudre des chemins d'URL,il va regarder cette variable, il va voir qu'il faut qu'il regarde dans docblog.url et dans docblog.url, pour l'instant,
00:03:36 :il y a uniquement deux chemins qui sont définis.Le chemin pour la vue par défaut, donc la vue d'index,et le chemin pour la vue admin avec l'interface d'administration.
00:03:45 :Donc nous, on va devoir inclure à l'intérieur de ce URL patterns notre fichier blog.urls.py.Pour ça, on va utiliser encore la fonction path et on va spécifier vers quel chemin on veut rediriger les gens qui veulent voir notre blog.
00:04:00 :Donc nous, on va mettre un chemin blog tout simplement avec un slash et ici, on va inclure notre fichier d'URL.Donc le fichier d'URL, on va l'inclure avec la fonction include et on va passer à cette fonction, une chaîne de caractère et la chaîne de caractère, ça va être en fait le module URLs
00:04:16 :de mon application blog à partir de source ici.Donc ça va être tout simplement blog.url.On n'oublie pas de mettre la virgule à la fin puisque là,on a une liste de chemin, donc il faut bien mettre une virgule ici et on va importer cette fonction include puisqu'elle n'est pas importée
00:04:31 :actuellement. Cette fonction, elle se trouve dans le même module que la fonction path, donc dans django.urls donc on va tout simplement rajouter include ici.Donc là, ce qu'on a fait, c'est tout simplement lier les URLs les unes avec les autres, donc c'est-à-dire que quand on va se rendre sur le chemin blog slash, Django va aller voir
00:04:50 :ce qu'il se trouve à l'intérieur de blog.urls et dans blog.urls,pour l'instant, on a un seul chemin, le chemin avec une chaîne de caractère vide et il va concaténer ces chemins les uns avec les autres.
00:05:00 :Donc si je relance mon serveur de développement, je vais juste avant fixer une petite erreur puisque là, j'ai mis un S à URL patterns mais il n'y en a pas, donc c'est juste URL patterns comme ceci et vous voyez d'ailleurs que PyCharm était suffisamment intelligent là encore pour me surligner cette erreur, donc
00:05:15 :URL patterns comme ceci, sinon ça ne fonctionnera pas.Donc je relance mon serveur, je reviens sur le site donc là j'ai bien ma page d'accueil qui s'actualise et si je vais sur slash blog slash,j'ai bien la vue qui m'est retournée, donc avec le http response et mon titre le blog. Donc là ce qu'il faut bien comprendre
00:05:33 :c'est qu'on a une concaténation entre mon adresse ici donc blog et ma chaîne de caractère ici. Donc là actuellement comme la chaîne de caractère est vide, il suffit que je me rende sur blog slash et rien après le slash pour arriver sur la page d'accueil. Si je mettais par contre ici index
00:05:48 :slash, et bien là la page qui renverrait à cette vue d'index, ce serait la concaténation de blog slash et de index slash. Donc là si je rafraîchis la page en l'état actuel, je vais avoir une erreur 404 puisqu'il n'y a rien à blog slash,par contre si je me rends à blog slash index slash,
00:06:06 :là je retrouve bien ma vue. Donc vous voyez ici qu'on a juste séparé nos fichiers d'URL et qu'on les a reliés ensemble grâce à cette fonction include. On n'est pas obligé de faire ça,
00:06:18 :c'est généralement ce qu'on fait, on sépare nos URL et ensuite on inclut les URL de nos applications avec les chemins ici. Mais là encore il faut vraiment bien comprendre comment tout s'agence.
00:06:27 :Le seul point d'entrée, comme je vous disais, c'est vraiment ce qui est dans Settings ici.Donc c'est vraiment ce point d'entrée docblog.urls et on pourrait très bien ne pas faire un fichier d'URL pour notre application. Donc si vous souhaitez tout mettre à l'intérieur
00:06:39 :du fichier URLs ici, je peux vous laisser quelques petites minutes si vous souhaitez le faire vous-même et si vous n'avez pas envie de vous casser la tête vous pouvez rester avec moi et je vais vous montrer comment on peut réagencer tout ce qu'on a fait ici pour n'avoir que
00:06:51 :un fichier, donc urls.py ici, qui renvoie vers notre vue. Donc ce que je vais faire c'est prendre ma vue index et donc plutôt que de la déclarer dans mon fichier urlpatterns ici,je vais l'enlever, pour l'instant je n'ai plus rien à l'intérieur de urlpatterns et je vais tout simplement l'ajouter ici. Donc je vais faire
00:07:06 :blog slash index slash et ici plutôt que d'inclure mon fichier blog.urls, je vais retourner la vue qui correspond à la vue qu'on avait définie ici, donc la vue d'index. Et c'est là que vous allez voir qu'il faut commencer
00:07:18 :à bien manipuler Python puisque j'ai déjà une vue qui s'appelle index. Donc ce que je vais faire c'est que je vais importer depuis blog.views ma vue d'index. Là vous allez
00:07:27 :remarquer que PyCharm nous indique que ce module n'est pas reconnu donc ça c'est normal, c'est parce qu'en fait lui il s'attend à ce qu'on part du dossier source, donc du dossier ici puisque PyCharm lui va partir du dossier racine, donc le dossier doc blog et donc actuellement si on ne voulait pas avoir d'erreur d'import
00:07:42 :il faudrait faire src.blog.views et là vous voyez qu'on n'a plus l'erreur. Sauf que à l'intérieur de Django,Django lui il ne part pas du dossier doc blog, il va partir du dossier source qui contient notre dossier blog. Donc nous
00:07:54 :ce qu'il faut faire c'est vraiment juste mettre from blog.views import index. Si on veut résoudre ce problème d'import, il nous suffit de spécifier que ce dossier source doit être un dossier spécifique donc pour ça on fait un clic droit, on va dans mark directory as tout en bas et on lui indique source root
00:08:09 :ici. Donc comme ça il va pouvoir ajouter ce dossier dans sa résolution de chemin et là si je reviens dans mon fichier urs.py vous voyez qu'on n'a plus l'erreur d'afficher.
00:08:18 :Le problème actuellement comme je vous disais c'est qu'on a deux vues index. On a la vue index de notre index ici donc de notre projet doc blog qui est défini dans views ici et on a notre vue index qui est définie dans blog.views.py. Donc là il y a
00:08:33 :différentes façons de régler le problème. On pourrait faire un import index as et dire par exemple qu'on veut l'importer avec un nom différent donc comme blog index et là comme ça on pourrait avoir deux noms différents et on n'aurait pas de clash entre la vue d'index de doc blog et la vue d'index du blog.
00:08:48 :Donc ça c'est une façon de faire mais vous voyez que là on doit du coup commencer à gérer les choses avec différents noms et c'est pour ça que c'est intéressant de séparer les choses en différents fichiers d'avoir un fichier d'url pour doc blog et un fichier d'url pour notre application blog comme ça on n'a pas ces
00:09:03 :problèmes de clash entre les noms. Mais c'est tout à fait possible de faire ça comme ça et là ça va fonctionner de la même façon si je me rends à cette adresse ici blog slash index slash et que je reviens ici donc dans ma vue que j'actualise la page, là vous voyez qu'on retourne bien la vue en question
00:09:18 :pour vous prouver que c'est bien cette vue que je retourne ici je peux mettre le blog de docstring par exemple, je reviens ici, je rafraîchis et là j'ai bien le blog de docstring qui est affiché. Donc c'est bien
00:09:30 :cette vue ici qui est retournée. Donc vous voyez il y a plein de façons de changer les choses on pourrait également mettre un nom différent directement dans la définition de ma fonction donc l'appeler blogindex comme ça si je reviens dans mon fichier ici je n'ai plus besoin de faire
00:09:42 :un as, je peux directement l'importer comme ceci donc avec le nom blogindex et là on n'aurait également aucun problème de conflit entre ma vue d'index et ma vue blogindex donc c'était un petit peu long mais je trouvais ça important de vous montrer que là encore ce n'est que des manipulations
00:09:57 :de chemin, de module Python et qu'on peut faire les choses de plusieurs façons. La façon la mieux de faire quand même c'est celle que je vous ai montré au tout début donc si je fais ctrl z de revenir en arrière avec le include comme ça on sépare bien les choses, on a nos vues de chaque côté
00:10:12 :on a les vues et les urls au niveau de notre projet dans DocBlog on a les vues et les urls pour notre application blog et comme ça tout ça est bien séparé. Donc là si je reviens
00:10:21 :dans ma vue je vais remettre le nom d'index, si je reviens dans les vues de DocBlog là je n'ai rien touché donc c'est bon et dans blog.vrs je vais remettre mon pattern ici
00:10:30 :et donc là ce qu'il faut bien comprendre c'est que je peux mettre autant de chemins que je veux ici et tous ces chemins vont être concaténés avec blog ici. Alors là il faut bien faire attention d'enlever les choses au bon endroit
00:10:39 :puisqu'actuellement si vous avez bien suivi cette vidéo, si je laisse ça en l'état actuel, pour arriver à cette vue ici il faudrait rentrer l'url blog slash index slash index slash. Donc je vais vous montrer ça
00:10:51 :tout de suite, blog slash index slash et là j'arrive bien à ma vue de blog. Si j'enlève le dernier index là j'ai une erreur 404. Donc voilà
00:11:01 :pour cette vidéo, je vais revenir ici avec la chaîne de caractère vide, je vais remettre le blog ici avec le slash et comme ça j'ai bien ma vue d'index du blog qui est retournée quand je me rends tout simplement sur blog slash et rien après.

Définir les urls de l'application

Débloquez votre potentiel ! ✨

Prêt à passer au niveau supérieur ?

Toutes les questions

Gabriel Trouvé

marquer le dossier src comme source

Rechercher sur le site