Session de mentorat TOSA sur la gestion des exceptions et l'usage d'exceptions personnalisées

Session du 27 janvier 2025 à 21h00

Veille & Discussions

Deviens membre Premium

Cette session de mentorat est réservée aux membres Premium. Rejoignez-nous pour accéder à toutes les rediffusions des sessions de mentorat !

Premium

+100h de formations
+180 exercices de code
+100h de mentorats en rediffusion
20 projets
Mentorats groupés hebdomadaires
Support individuel avec nos mentors

Découvrir les formules

Voir le détail des fonctionnalités

Session de mentorat TOSA sur la gestion des exceptions et l'usage d'exceptions personnalisées

Session de mentorat TOSA durant laquelle nous parlerons de la gestion des erreurs avec les exceptions et de l'usage d'exceptions personnalisées

Rechercher dans la transcription

00:00:00 :Ok, donc la thématique aujourd'hui c'est de parler un petit peu des exceptions si vous y avez déjà été confronté et de voir un petit peu comment les utiliser, comment utiliser ses propres exceptions et quand les utiliser et donc on va essayer de voir autour de cette thématique des choses qui pourraient vous aider dans ce domaine

00:00:30 :Est-ce que vous avez déjà été confronté à devoir gérer des exceptions qui étaient levées par du code que vous utilisiez par exemple par une fonction de la biotech standard et est-ce que vous avez déjà créé vos propres exceptions ?

00:00:44 :Pour ma part, non, moi je débute donc les exceptions que j'ai utilisées c'est ce qu'on m'a demandé dans les exercices Sinon de ma propre initiative, je n'en ai pas fait Alors on va regarder un petit peu quels critères, comment les utiliser et à quoi ça sert aussi et donc comme c'est une fonctionnalité de base de Python, des fondamentaux, sortir au TOSA également

00:01:20 :Est-ce que vous voyez tous mon écran ? En principe vous devriez voir la page d'accueil de Google sur Chrome On va passer sur Colab, sur un autre book et puis on va regarder un petit peu ça Les exceptions en Python sont le cœur de la gestion des erreurs Donc il y a deux situations où vous pouvez y être confronté

00:01:49 :Soit vous écrivez du code et ma foi le code que vous écrivez génère des exceptions et donc font cracher votre programme ou alors vous voulez vous-même lever des exceptions pour notifier les personnes qui pourraient utiliser les fonctions que vous écrivez qu'il y a eu quelque chose qui s'est passé pas comme ça devrait

00:02:16 :Typiquement on a ces deux situations, il faut bien comprendre qu'elles facilitent un petit peu la vie du Pythonista et donc de la personne qui va coder en Python Ce qu'on voit souvent quand on travaille avec des personnes qui débutent en Python, ce qui est souvent mon cas dans mes accompagnements

00:02:40 :je vois souvent finalement des gens écrire des kilomètres de code alors ici on pourrait le symboliser comme ceci ou les trois petits points qui se suivent pourraient finalement dénoter tout en programme donc si on voulait même symboliser ça, on pourrait dire mon programme sous forme d'une fonction comme ça, donc l'entier du programme et puis except

00:03:09 :et puis en cas d'exception on peut faire quelque chose, parfois on voit même ce genre de code de début ici donc voilà le fond des exceptions, une exception c'est quelque chose qui va pouvoir nous notifier d'une erreur et qui va nous donner la possibilité de capturer si mon programme génère une erreur je pourrais la capturer

00:03:36 :par exemple, si mon programme génère une erreur, qu'est-ce que ça veut dire concrètement ?si mon programme, c'est juste une fonction pour l'instant si mon programme génère n'importe quelle erreur, par exemple une value erreur une simple erreur levée dans mon programme si je ne fais rien, mon programme va crasher

00:04:08 :ici, si j'exécute cette fonction et qu'elle lève une erreur à un moment donné le programme va crasher et il se trouve que quand on débute et qu'on a un programme qui crash souvent on n'est pas super content et on va aller chercher sur Google des solutions et on va trouver très vite qu'une manière d'éviter que notre programme crash

00:04:40 :c'est effectivement d'entourer tout notre programme avec une exception avec un bloc try except plutôt, une capture d'exception et puis on pourrait faire ce genre de choses qui va capturer toutes les exceptions qui vont être levées par mon programme et ensuite finalement les ignorer alors tout d'un coup, mon programme qui ne fonctionnait pas, fonctionne

00:05:06 :or ici, on a quelque chose qui est vraiment en gros anti-pattern en programmation c'est-à-dire que j'ai un système de capture d'exception qui va quelque part capturer toutes les exceptions que pourrait lever mon programme sans distinction et les rendre complètement invisibles donc vous avez vu qu'un programme qui crashait, maintenant ne crash plus

00:05:32 :et parfois il est bien de faire crasher un programme c'est pas forcément une mauvaise chose, surtout lorsque vous développez puisque lorsque vous développez, vous voulez découvrir également des situations où votre programme ne fonctionne pas et pouvoir agir ponctuellement sur ce programme alors essayons d'être un petit peu plus concret sur mon exemple

00:06:01 :actuellement mon exemple est trop générique et effectivement ne montre pas grand chose premièrement, alors on va essayer d'être plus spécifique c'est-à-dire que je peux essayer de capturer avec des exceptions uniquement certaines exceptions mais pas d'autres alors le bloc try except permet d'être spécifique sur le type d'erreur que vous voulez pouvoir lever

00:06:33 :par exemple ici, si je sais que mon programme peut avoir par exemple des problèmes de l'ordre d'une value-erreur par exemple, je peux être spécifique avec ça donc ici, si je spécifie que je m'attends à ce que mon programme lève une value-erreur, je peux par exemple dire ok, une value-erreur c'est pas un problème pour moi

00:07:01 :je peux même éventuellement gérer cette value-erreur si je le désire donc ici, imaginons que dans mon programme je veux gérer spécifiquement cette value-erreur je peux la mentionner directement ici et faire en sorte que cette value-erreur soit gérée d'une manière ou d'une autre effectivement, si mon programme génère une value-erreur

00:07:35 :finalement, mon programme ici se termine on voit que je n'ai aucune erreur parce que j'ai dit, j'ai prétendu que je sais quoi faire de cette erreur là tandis que si je sais quoi faire par exemple d'une index-erreur mais je ne sais pas quoi faire d'une value-erreur enfin ici, capturons une index-erreur

00:07:57 :et puis on voit que mon programme va crasher malgré tout parce qu'il lève une erreur qui n'était pas planifiée tandis que si mon programme lève une erreur qui est gérée qui est planifiée ici effectivement, on n'aura plus d'erreur parce que je sais quoi faire de l'index-erreur donc ici, se dire qu'une erreur en soi

00:08:18 :ce n'est pas forcément quelque chose de problématique c'est quelque chose qui va intervenir parce que l'utilisateur a par exemple fait une action qui n'était pas immédiatement prévue par mon programme donc mon programme peut lever une exception mais à l'extérieur de mon programme je peux éventuellement savoir gérer ce truc

00:08:40 :par exemple, imaginez un programme ou une fonction qui va devoir aller chercher des choses sur le web on peut imaginer plein de choses plein d'erreurs différentes si on va chercher des choses sur le web par exemple, on peut imaginer que l'URL que j'ai utilisée pour aller chercher quelque chose sur le web

00:09:03 :donc l'adresse web que j'utilise pour aller récupérer des informations sur le web est erronée dans ce cas, j'ai un problème j'ai un problème si cette URL est erronée parce que si je réessaye dans 5 minutes dans 10 minutes dans 1 heure dans 3 heures j'aurai toujours un problème d'URL

00:09:27 :à l'inverse si c'est un problème de réseau alors à ce moment là, c'est peut-être différent imaginez que votre programme se connecte au réseau il va essayer de récupérer des informations sur le web et ensuite traiter ces informations et retourner un résultat si au moment où vous exécutez votre programme

00:09:50 :vous êtes en train de passer devant un tunnel et vous n'avez plus de 5G à ce moment là votre programme va échouer mais si vous réessayez 30 secondes plus tard par exemple vous allez avoir un programme qui réussit parce que le réseau sera nouveau disponible encore qu'en France, on peut se demander

00:10:15 :si le réseau sera encore disponible moi j'habite en Suisse là où il y a toujours du réseau parce que les villes sont séparées de moins de 20 minutes les unes des autres mais vous avez des grands espaces chez vous donc l'idée c'est que les erreurs peuvent être de multiples natures

00:10:33 :première chose à essayer de bannir c'est quand je veux gérer des exceptions jamais dans votre code jamais grandieux jamais vous devriez avoir un except tout nu par exemple un except tout nu veut dire qu'il va capturer n'importe quelle exception de quelque nature qu'elle soit si c'est un indexerreur si c'est une zéro division erreur

00:10:59 :par exemple là elle sera capturée dans mon exemple si j'ai une exception simplement exception pareil exception quelle que soit la nature de l'exception qui sera levée en mettant un except vous êtes sûr d'avoir un trou noir à exception et de capturer si vous êtes spécifique à ce niveau là

00:11:25 :vous capturez que l'exception que vous avez levée donc si j'ai une zéro division erreur ici typiquement le programme va cracher malgré le fait que j'ai un try except dans mon code voilà ça c'est le contexte très global maintenant comment est-ce qu'on finalement va utiliser ces exceptions alors imaginez-vous dans l'élaboration d'un programme

00:11:55 :dans lequel vous allez utiliser des fonctions pour coder différentes fonctionnalités imaginons qu'on veut ici avoir une fonction qui va permettre de downloader une web page par exemple ok par exemple download docstring alors à ce moment là on va devoir utiliser une fonction à l'intérieur qui va pouvoir faire l'appel réseau

00:12:27 :donc qu'est-ce qu'on va vouloir faire on va vouloir aller chercher une page web à une certaine URL à une certaine adresse et rapatrier le contenu de cette page web qui va être encodée d'une certaine manière on va vouloir décoder cette page puis ensuite on peut faire plein de choses mais imaginons que ici je veux simplement

00:12:51 :retourner le code HTML de cette page là de nouveau qu'est-ce qui peut arriver alors soyons plus générique quand même imaginez que je vais aller récupérer une web page et pour cela il va me falloir une URL donc première chose qui peut arriver dans mon code c'est que la personne qui utilise

00:13:15 :cette fonction ok elle ne donne pas d'URL imaginez que la personne qui utilise cette fonction download web page je pourrais déjà m'économiser ici appelle cette fonction sans rien lui passer alors Python va automatiquement vous retourner déjà une type error donc a priori vous n'avez rien besoin de coder en particulier

00:13:51 :pour que Python vous dise ok vous utilisez mal cette fonction download web page vous ne lui passez pas une URL et il vous le dit ici mais imaginez que vous lui passez une URL hop ici je lui passe une URL techniquement je lui passe une URL parce que je passe un argument ici

00:14:17 :et qui sera associé au paramètre URL seulement ce n'est pas une URL donc là je n'ai plus d'exception déjà mon code passe et j'ai toujours un problème parce que ma fonction ne sait pas trop quoi faire elle ne sait pas quoi aller chercher ici alors première chose je peux ici

00:14:41 :faire un premier test premièrement on pourrait vérifier que s'il n'y a pas d'URL alors if not URL ici on va faire quelque chose quand est-ce que ce test if not URL est vrai est-ce que vous pouvez est-ce que vous arrivez à me dire toutes les situations où ce if not URL

00:15:11 :est vrai avec la chaîne de caractère vide comme tu as mis là avec celle là donc ici on va dire vrai si URL vaut ça ok qu'est-ce qu'on pourrait imaginer d'autre comme situation a priori on pourrait imaginer que c'est faux si c'est non techniquement c'est faux à partir du moment

00:15:51 :où je ne mets pas une adresse qui commence par HTTPS après une URL valide donc une URL valide une URL valide commence par HTTPS éventuellement S est suivi d'un domaine valide etc etc ici déjà pour votre fonction vous avez plusieurs choses que vous pouvez mettre en place pour faire un test de validité

00:16:31 :on peut rester très simple c'est à dire en testant comme ça if not URL si au moins c'est pas quelque chose de vide donc différentes chaînes vides et différentes non je pourrais déjà ou je pourrais tester déjà si c'est une chaîne de caractère et s'il n'est pas vide if instant

00:16:54 :instant URL et puis on va dire chaîne de caractère URL string ok donc là on a éliminé tout ça on vérifie simplement qu'elle n'est pas vide et si elle est vide alors if not URL or not instant string dans ce cas là on va par exemple dire c'est une valeur

00:17:21 :non valide value error l'URL doit être une chaîne de caractère non vide par exemple ok ceci va entraîner finalement un crash un crash de l'usage de ma fonction est-ce que c'est mauvais que cette fonction crash dans ce contexte non parce que ça permet d'informer le développeur ok qu'il a mal utilisé

00:17:55 :sa fonction et c'est quelque chose même qu'on peut ici documenter par exemple à un moment donné vous décrivez la fonction des descriptions ici de la fonction et puis on peut décrire ici par exemple value error l'URL doit être une chaîne non vide on va lui dire par exemple ok si on lui passe

00:18:25 :une chaîne vide on va recevoir une value error ça c'est une des exceptions possibles deuxième chose qui peut se passer maintenant c'est si je retourne la chaîne directement on va utiliser ici urllib pour le coup puisqu'on nous est en train de prendre la bibliothèque standard donc urllib .request

00:18:55 :et puis on va faire un return ici de urllib .request .urlopen et on va ouvrir la page web qu'on va chercher alors effectivement je programme quelque chose autour d'une fonction Python qui existe déjà et on va aller lire le contenu et on va éventuellement le décoder on va présupposer qu'il est encodé

00:19:31 :en UTF-8 par exemple et on va le décoder pour obtenir une chaîne de caractère Python pas une ByteStream donc si jamais vous n'êtes pas à l'aise avec urllib n'hésitez pas à aller par exemple sur la doc de la bibliothèque standard donc doc python ici vous allez sur la library

00:19:55 :reference ou vous passez en français si vous n'êtes pas à l'aise urllib ici et urllib .request ici vous avez toute la doc de par exemple urlopen c'est de la doc donc si c'est indigeste je vous recommande ici un site qui s'appelle python module of the week pymot python module of the week

00:20:19 :et donc c'est un site de tuto sur la bibliothèque standard qui est fait par un des core dev de Python et là dedans vous cherchez urllib vous avez urllib .request ici et puis un tuto

00:20:33 :de très bonne facture qui vous apprendra à l'utiliser et donc aller chercher des informations sur le web uniquement que la bibliothèque standard de python sans rien installer donc ici on va chercher des informations il se trouve que l'url actuellement elle est vide maintenant je décide qu'elle soit plus vide

00:20:57 :alors docstring est-ce que c'est www docstring c'est juste www là je vais me faire taper sur les doigts mais hop docstring.fr pour le coup c'est bon alors on va venir là et docstring.fr

00:21:23 :et voilà on a téléchargé le contenu de docstring toutefois ici il peut arriver plein de choses qu'est-ce qui peut arriver selon vous il va y avoir un souci d'encodage non ?

00:21:53 :alors là je pourrais très bien recevoir du contenu qui n'est pas encodé en utf-8 c'est plus en plus rare sur le web mais c'est très possible techniquement et donc il n'arrive pas à décoder ça ok donc je pourrais avoir eu une erreur de décodage comment savoir ce qui va se passer

00:22:15 :en cas d'erreur de décodage par exemple on peut faire est-ce que ça va fonctionner si je prends une chaîne de caractère je l'utilise encode et puis on va encoder en latin comme ça je décode ça comme si c'était du utf-8 est-ce qu'il me donne une exception donc probablement donc ici ce que j'ai fait

00:22:57 :une bonne technique pour savoir ce qui va se passer si j'ai un problème de décodage vous prenez une chaîne de caractère typiquement du français avec des accents vous l'encodez en latin 1 c'est plus ou moins une variante de ce que vous allez avoir par exemple sur Windows avec l'encodage par défaut

00:23:19 :ou historiquement dans les pays francophones ou du latin donc on encode ça sur en latin on va prétendre que c'est du unicode version utf-8 et on le décode donc évidemment on a encodé d'une manière notre texte ici python et on l'a décodé avec autre chose donc il n'est pas content

00:23:45 :donc si ce qu'on reçoit du web est encodé selon par exemple du latin 1 et qu'on le décode en prétendant que c'est de l'utf-8 à ce moment là on aura une erreur pour l'instant on ne l'a pas mais on pourrait l'avoir donc ce unicode décode erreur et typiquement c'est ce décode utf-8

00:24:09 :qui pourrait élever ça ok donc se pose la question à ce stade qu'est-ce que je fais et surtout il faut vraiment prendre votre casquette de développeur et vous poser la question de deux points de vue premier point de vue c'est que vous développez une fonction qui fait quelque chose

00:24:35 :dans notre contexte cette fonction va aller chercher des informations sur le web et dans un autre contexte c'est que vous êtes utilisateur d'une fonction qui a été faite pour vous ça va donner quelque chose il se peut qu'en tant que développeur vous soyez des deux côtés de ça que vous soyez le développeur de cette fonction

00:24:55 :et que vous utilisiez cette fonction par ailleurs dans votre code ici vous avez un choix à faire vous avez un choix à faire qui est est-ce que je laisse passer ces erreurs auquel cas c'est l'utilisateur de votre fonction qui devra les gérer par exemple typiquement là vous voyez que je fais un return

00:25:19 :url, livre, request, url open, read, decode c'est une longue chaîne mais finalement ici je récupère la page web ensuite je lis cette page web et ensuite je décode cette page web déjà là il peut y avoir une multitude d'erreurs première erreur possible je récupère la page web ne pas avoir de réseau

00:25:45 :lorsque je fais un cours en présentiel à l'université où je travaille souvent ce qu'on fait à ce moment là c'est qu'on coupe le réseau alors là j'ai un problème de mentorat en ligne c'est que je ne peux pas le faire sinon je vous perds mais ici peut déjà intervenir une première erreur

00:26:03 :pour savoir cette erreur pour connaître cette erreur qui est de type url libre url libre point erreur point url erreur donc ici l'erreur qui vous est rendue suppose que l'url n'est pas bonne parce qu'il n'arrive pas à télécharger mais vous pourriez très bien ne pas avoir de réseau dans les deux cas l'effet est le même

00:26:33 :c'est que vous ne récupérez pas la ressource en ligne ok mais du fait que nous n'avons pas géré cette erreur finalement ça va être à l'utilisateur de votre fonction éventuellement vous, de faire éventuellement un try download web page ici récupérer le résultat de la page web donc web page code

00:26:59 :par exemple ici vous allez récupérer le code s'il y a une erreur réseau except ici url libre point erreur point url erreur faire quelque chose donc ici je dois également importer url libre point erreur donc ici je dis dans ma fonction je ne gère pas ça, je vais documenter

00:27:35 :éventuellement ceci ici une erreur d'url ou de réseau ou de réseau est survenue et la personne qui utilise ma fonction elle doit se taper alors ici une value erreur si le caractère est vide ça non mais par contre elle va se devoir également de se taper une unicode des codes

00:28:03 :unicode des codes erreur ici si je volontairement je documente la fonction de manière assez verbeuse donc si je suis utilisateur de ça je vois que cette exception cette fonction peut me faire un petit peu tout ça, donc quelque part je vais devoir décider ce que je fais à chaque fois

00:28:27 :par contre ici qu'est-ce que je fais s'il y a une erreur d'encodage dans ce que je reçois ce que je fais si donc ici except download unicode des codes erreurs unicode des codes erreurs c'est bon bien sûr c'est pas tout ça que je veux c'est juste ça etc donc vous voyez que

00:28:59 :finalement il y a une liste alors ici, il y a une première erreur qui peut arriver, c'est si j'ai passé n'importe quoi à ma fonction moi je sais que j'ai pas passé n'importe quoi à cette fonction donc l'erreur d'URL je devrais pas avoir à la gérer mais techniquement vous pouvez la gérer

00:29:17 :etc donc voilà ici j'ai typiquement une fonction qui ne fait pas de gestion d'erreur qui n'utilise pas d'exception et pour le coup c'est le code, c'est votre code le code qui utilise cette fonction qui va devoir faire l'effort il est pas obligé lui de faire tout l'effort ici je peux imaginer

00:29:43 :que j'ai une fonction c'est une fonction de votre code qui fait tout ça et elle est pas obligée de gérer toutes les exceptions elle même et vous pouvez décider l'erreur d'encodage je le gère pas et plus bas dans votre code c'est au moment où vous aurez que vous utiliserez

00:30:05 :une fonction par exemple que vous allez devoir gérer éventuellement ça donc vous voyez que les exceptions vous permettent de gérer les erreurs sur plusieurs niveaux c'est à l'intérêt de Download Webpage que j'ai une exception qui est levée par exemple pour le décodage une fonction Appel Download Webpage ici qui gère

00:30:31 :uniquement les problèmes de téléchargement de réseau d'URL mal formé etc et il ne gère pas les problèmes d'encodage et puis à un moment donné ici la fonction peut être il gère les problèmes d'encodage donc les exceptions c'est quelque chose qui va vous servir dans la gestion d'erreur sur plusieurs niveaux

00:30:53 :finalement d'appel plusieurs niveaux d'appel ici j'ai le code principal on peut dire qu'ici on est dans le code principal éventuellement fonction main par exemple ou simplement le module qui vous servira à lancer votre programme ce module va appeler une fonction qui est définie quelque part ailleurs et cette fonction elle même

00:31:21 :va appeler une fonction qui est définie encore ailleurs, la fonction la plus intérieure à une erreur et il va falloir la gérer vous pouvez la gérer directement au niveau de Download Webpage, vous pouvez la gérer dans le niveau appelant ou alors au niveau le plus élevé de votre programme

00:31:41 :n'hésitez pas à tout moment à me couper alors comment est-ce que je vais décider où je vais finalement utiliser ces exceptions on est ici dans une logique de design d'interface ça ne vous parle pas beaucoup mais finalement tout votre métier de développeur va tourner là autour en fait au jour le jour

00:32:11 :vous allez pratiquement faire ce qu'on appelle du design d'interface c'est à dire qu'au jour le jour vous allez créer des fonctions et vous allez devoir imaginer comment est-ce que l'utilisateur de votre fonction va devoir gérer tout ça si j'efface tout ça on peut se reposer maintenant la question quelles sont les options

00:32:35 :quelles sont les options pour notre utilisateur ici ou pour notre concepteur de Download Webpage ici on va se remettre logstring et finalement est-ce que je suis obligé de laisser passer comme je le fais ici ou est-ce que je peux gérer les exceptions directement à l'intérieur de ce Download Webpage

00:33:03 :alors il n'y a pas de réponse absolue à ça de manière générale essayez toujours de gérer les exceptions dès que vous le pouvez alors dès que vous le pouvez ça veut dire quoi par exemple, imaginons que ce code ici vous ne faisiez pas directement de return mais imaginons que vous récupérez

00:33:31 :le résultat de votre page déjà on peut ici récupérer la réponse je ne décode pas pour l'instant là, sur la réponse j'ai la possibilité déjà à ce stade de gérer except urllib.error

00:33:57 :etc alors, est-ce que je fais un print, est-ce que je fais quelque chose ici en fait à chaque étape vous pouvez vous poser la question, qu'est-ce que je vais faire d'une erreur, ici typiquement j'ai ici cette instruction le statement ici peut échouer si l'url n'existe pas ou plutôt si le domaine n'existe pas

00:34:35 :donc si le nom de domaine n'existe pas ou si vous n'avez pas de réseau vous n'avez pas de réseau alors dans ce cas qu'est-ce que je fais s'il n'y a pas de réseau, est-ce que je signale est-ce que je signale pas si on veut vraiment aller au bout des choses, par exemple

00:35:03 :retourner une page web vide qu'est-ce qui m'interdit de faire ça si la page n'existe pas ma fonction va pouvoir retourner une page web vide tandis que si il récupère le contenu en ligne je vais finalement retourner du contenu qui est celui-là ça peut être une possibilité imaginez que si je vais plus loin

00:35:33 :que j'analyse même le contenu de cette page par exemple je vais sur docstring.fr et je veux retourner une liste de tous les cours proposés par docstring, je pourrais retourner une liste avec les titres de chaque cours et si j'ai une erreur réseau je peux retourner une liste vide tandis que si

00:35:55 :je récupère bien cette liste je vais retourner c'est une manière de signaler une erreur si je veux obtenir une information qui se présente sous la forme d'une liste et que je reçois une liste vide alors j'ai une erreur. Ici

00:36:09 :si je veux obtenir une réponse alors ici on va response égal rien et puis on fait un return un return de notre response ici pour l'instant un return et là j'ai géré une erreur. Est-ce que

00:36:33 :c'est la bonne façon de gérer l'erreur ça c'est uniquement le programme, le contexte applicatif dans lequel vous allez travailler qui va nous le dire mais ce qui est déjà sûr maintenant c'est que je peux éliminer dans cette fonction là de cette liste là une erreur déjà même chose je pourrais ici me dire

00:37:03 :ok maintenant j'essaye de décoder donc ici on va dire que response devient data j'essaye de lire et de décoder et puis éventuellement là je décode et si j'ai une erreur de décodage même chose à l'extrême de nouveau dire que je n'ai pas reçu de données et je retourne des données vides

00:37:37 :si j'ai eu des exceptions donc même chose j'ai géré à l'intérieur de cette fonction la problématique qui m'était donnée ici et je vais devoir pour le coup je peux maintenant effacer cette ligne là pour le coup je peux probablement effacer également cette première ligne je vais juste voir ce que

00:38:07 :donnerait par exemple on peut essayer de voir ce que donnerait ici que donnerait URLOpen si je lui passe une URL qui est vide elle va retourner elle même déjà une valueError ok donc pour le coup ici je peux décider soit d'éliminer ça parce que ici il y aura déjà une valueError

00:38:39 :et rien ne m'empêche ici également de faire un except avec une valueError et puis une réponse vide ok maintenant Thierry oui excuse moi c'est juste une question sémantique mais pourquoi parfois tu mets as quelque chose et parfois non c'est une question bête je sais pas non il n'y a pas de question bête déjà

00:39:07 :premièrement en fait une exception donc une exception elle a deux choses il y a un type et il y a une valeur si vous voulez par exemple si je veux lever moi même une exception je vais utiliser le mot clé Raise et puis le type de l'exception et puis vous voyez c'est comme si je

00:39:31 :prends une classe ici ma classe par exemple ma classe et puis je lui passe des valeurs ici c'est ce qu'on appelle une instantiation je crée un objet à partir d'une classe ici c'est pareil ici quand j'ai une erreur je vais instantier la classe valueError lui donner le nom dans le message

00:39:51 :et ça ça va créer un objet ok cet objet je peux le récupérer c'est à dire que quand il y a une exception qui a été levée ici je capture ici juste en fonction du type je dis ok si il y a une exception de type valueError qui est levée

00:40:11 :je rentre ici dans cette branche là et je vais exécuter le code qui est là dedans mais pour autant ça me donne juste que je me base juste sur le type de l'erreur mais je n'ai pas l'exception à un particulier par exemple quand on fait un raise ici raise value

00:40:31 :valueError là vous voyez il y a un message ok donc à l'intérieur de cette fonction urlOpen quand il détecte qu'il n'y a pas de réseau par exemple il va lever une exception de type urlError et il va lui donner quelque chose comme ça un message on peut essayer ici urlOpen

00:40:59 :htps docstring et puis je mets plein de petites lettres à la fin .fr donc je prends une url qui n'existe pas ok donc j'ai bien une urlError qui a été levée et il y a bien un texte qui est associé name hors service not known ici ici donc je peux

00:41:29 :capturer ça mais si je veux capturer ce texte là par exemple je peux maintenant le capturer cette exception pas celle là mais celle là ici en disant as et puis lui donnant exception donc c'est l'objet exception on a souvent tendance à le nommer e ici mais vous pouvez lui donner

00:41:53 :le nom de votre grand-maman si vous voulez ça c'est une variable qui va contenir ensuite l'objet représentant l'exception ici je peux faire en print dans un vrai programme on va éviter print et on va plutôt loguer avec logging.error

00:42:11 :ou exception ici exception et puis on va ajouter un texte là qui contiendra l'exception mais mettons en print pour l'instant print et .message ok et puis ici docstring et puis on teste alors déjà ici la valueerror la chaîne non vide elle n'est pas vide ok donc là j'ai capturé

00:42:53 :une exception qui est ici il se trouve que pour le coup ça génère une autre exception puisque ici j'ai mis une chaîne vide et puis là la chaîne vide n'a pas de méthode read donc ici ça échoue donc ici la chaîne vide ne serait pas la bonne chose à mettre ou alors je fais directement

00:43:15 :ici en return vide et puis en return vide ici pour éviter qu'on arrive sur la suite du programme et effectivement ce qu'on va voir ici c'est que ici l'exception n'y met rien qu'est-ce que je dois faire pour aller chercher dans cette exception on pourrait ici aller voir on va faire en print de dire

00:43:47 :alors dire pour ceux qui ne savent pas je ne suis pas sûr que je rentre ici on a passé ça qu'est-ce qu'on a fait avant ça on a eu une URL erreur autant pour moi c'est ici qu'on a passé n'importe quoi on a eu l'URL erreur donc ici as et

00:44:11 :et puis pour le coup si je mets en print et ici capture puis voilà on capture l'objet et puis ici plutôt que d'afficher l'objet je peux juste afficher le message ok j'aurai accès ici dans ce type d'exception là et puis là vous avez tout ce que contient cette exception là

00:44:45 :la reason ici par exemple qui est la raison pour laquelle il a échoué ok .reason et puis il vous donne il vous décrit la raison pour laquelle on a reçu ici ce texte là on a ce print qui a été fait si vous ne voulez pas faire en print vous pouvez

00:45:11 :loguer un grès dans un fichier de log par exemple comme ça vous avez le détail de pourquoi l'appel de fonction a échoué donc récupérer ici ce as et permet d'en savoir plus sur l'exception ou alors si vous n'avez pas besoin d'en savoir plus ça vous suffit de savoir que c'est une URL

00:45:29 :erreur à ce niveau là vous n'avez pas besoin si vous ne faites rien avec ce e vous n'êtes pas obligé de le mettre ok donc donc voilà en fait deux styles de programmation qui font que la première toute première version de notre download .web page

00:45:51 :on allait documenter alors même maintenant on n'a plus besoin de ça on n'a plus besoin de ce chapitre raises dans notre docstring ici on peut juste documenter ce qu'on gère en interne ce qui se passe c'est que je reçois une chaîne vide dès que j'ai une erreur donc l'utilisateur ici

00:46:11 :n'y voit que du feu il cherche un site si ce site n'existe pas il reçoit juste une chaîne vide par contre si il cherche docstring.fr

00:46:21 :il va recevoir du texte donc quand ça réussit il a du texte quand ça ne réussit pas il n'a rien c'est une manière de gérer les erreurs aussi ok l'avantage c'est qu'ici l'utilisateur de download web page n'a pas besoin de se préoccuper de savoir s'il a des erreurs à gérer

00:46:43 :et c'est une fonction qui est complètement intégrée donc vous voyez que quand je gère les exceptions le plus proche possible du code qui lève cette exception je vais permettre de simplifier probablement le code en amont par contre je n'aurai plus cette possibilité ici lorsque j'utilise download web page de réagir face aux

00:47:09 :différentes erreurs c'est quelque part le concepteur et l'écrivain de la fonction download web page qui aura pris cette décision pour vous évidemment là vous pourriez encore dire page égal etc et puis ici if not page vous pourriez encore gérer ce que vous devez faire si vous n'avez pas reçu de contenu

00:47:39 :à ce niveau là par exemple ou alors if page et puis là vous allez écrire du code seulement si vous avez reçu du contenu mais c'est tout ce que vous avez comme possibilité vous n'avez plus de possibilité de gérer les erreurs d'encodage par exemple parce que ce ne serait pas du TF8

00:47:59 :alors si ce n'est pas du TF8 j'essaye latin par exemple donc ici je pourrais très bien dire TF8 donc ici faire un read une fois qu'on a fait le read data égal data.decode

00:48:19 :là et puis ici si ça échoue data.un data décode latin 1 par exemple si vous savez que vous êtes en France peut être des possibilités que le latin 1 fonctionne si le TF8 n'a pas fonctionné ici je peux décider si le concepteur décide ce qu'il fait ici l'appelant

00:48:45 :la personne qui utilise la fonction n'a plus la possibilité de jouer avec la même finesse donc vous voyez qu'il y a des avantages et des exceptions à gérer une exception localement si je gère les exceptions localement il va perdre en flexibilité si je laisse passer les exceptions c'est le code appelant qui devra tout faire

00:49:09 :comme dans mon exemple au tout début où on ne faisait rien au niveau de la fonction download web page et c'était le code utilisateur qui devait faire un try except pour s'assurer que le code n'allait pas crasher n'allait pas échouer une dernière chose que je veux vous montrer c'est que parfois

00:49:29 :c'est la première stratégie que je veux utiliser donc on va voir si à coup de ctrl z on arrive à revenir un petit peu en arrière ça fait mal à la tête un petit moment mais on y arrive ici je reviens à mon code initial remet en return ici

00:50:01 :et nous avions donc un read d'abord et un decode ok donc ici je veux faire un download d'une nouvelle page et puis on a vu qu'il y avait toutes ces exceptions qui peuvent arriver alors il y a une exception standard valueerror ça semble relativement normal que celle là soit utilisée

00:50:33 :si jamais je passe n'importe quoi ici à url donc gardons là unicode decodeerror peut être qu'on peut la garder ou pas et puis ça ça devient on commence à avoir un ensemble hétérogène de d'exceptions qui seraient levées ici donc ici des exceptions standard puis des exceptions on va dire standard

00:51:03 :mais non standard puisque ça appartient à une bibliothèque de la bibliothèque standard ou un module de la bibliothèque standard j'ai possibilité de cacher à download web page ce détail là je peux ici par exemple ici avoir créé une exception qui serait downloader invalid url par exemple et puis si

00:52:23 :des exceptions personnalisées à quoi ça va servir ça va servir que ici ok, il va faire un try except et déjà s'il veut capturer l'une, n'importe laquelle de ces exceptions on voudrait qu'il puisse avoir une erreur générique comme celle là par exemple except except downloader error et puis il va faire downloader error

00:52:51 :et puis il va faire le nécessaire ici ou alors s'il ne veut pas être générique, il va utiliser ces différentes exceptions là pour gérer ces erreurs par exemple il veut gérer le cas d'une url invalide et puis il veut gérer le cas de la network error ok et puis

00:53:21 :d'autres cas éventuels qu'on pourrait gérer comme la décode erreur donc de manière générale on pourrait aller comme ça ça va donner un petit peu plus de générique ici puisqu'à la place de la unicode décode erreur, j'aurai mon erreur downloader décode erreur et puis ici à la place de toute cette chaîne là dont on sait

00:53:47 :trop que faire en tant que débutant dans l'usage de download web page je peux avoir une exception download ici network error donc c'est une autre stratégie qui va impliquer que c'est la fonction elle même qui va devoir gérer et lever les bonnes exceptions. Pour ça

00:54:11 :je vais devoir créer les exceptions alors comment est-ce qu'on crée des exceptions de manière simple ici au plus simple on va créer une exception générique, ici qui s'appelle downloader error, vous créez une exception vous créez une classe qui s'appelle downloader error, simplement cette classe va hériter de exception et puis après vous pouvez créer

00:54:35 :toute une hiérarchie d'exceptions donc ici j'ai créé une exception générique qui s'appelle downloader error, ça voudrait dire toutes les erreurs qui peuvent être levées par cette fonction et ensuite je peux créer des erreurs plus spécialisées qui vont hériter de ce downloader error ici et par exemple c'est le cas de ces différentes

00:55:01 :exceptions ici donc downloader invalide url downloader network error, downloader décode error, donc ici vous avez cette erreur parente et puis ces éventuelles erreurs ici spécifiques, dans l'usage de Webex je peux par exemple décider que je vais uniquement gérer les downloader error de manière spécifique comme ça et puis toutes les autres

00:55:35 :les downloader error invalide url ou décode url je les gère de manière générique par exemple je décide simplement de faire un print pour avertir l'utilisateur ou un log pour avertir l'utilisateur que quelque chose s'est passé et ensuite je laisse exploser l'exception je gère avec un print et ensuite je fais

00:55:57 :ici un raise qui va simplement réexécuter ou relever cette exception là alors ici pour maintenant que ma fonction gère ces erreurs, vous pouvez donc faire ce qu'on a fait tout à l'heure response ici response égale ceci et donc je fais un try except je vais capturer cette exception qui peut être à ce

00:56:31 :niveau là une url libre error url error et moi je décide derrière de faire un raise de ma propre exception qui s'appelle downloader network error ici et ici downloader network error c'est ce que ma fonction va déclarer comme exception possible si jamais j'ai une erreur ou d'exception ou de réseau

00:56:57 :ok donc pour le coup cette fonction là ne va plus jamais lever d'urli.error.url j'ai utilisé une exception personnalisée pour clarifier l'interface de ma fonction, donc quand je parle d'interface de fonction, de quoi je parle, je parle des paramètres que vont accepter ou des arguments que vont accepter la fonction, donc ici

00:57:27 :cette fonction accepte une chaîne de caractère qui sera nommée url, d'ailleurs on ne sait pas actuellement que c'est une chaîne de caractère, soit j'utilise les types int pour guider notre utilisateur, soit je décide de documenter ma fonction en lui disant d'utiliser une url sous la forme de string et

00:57:51 :je vais retourner ici une chaîne de caractère, mais également je vais préciser les exceptions qui seront potentiellement levées par download webpage ces exceptions ça peut très bien être mes propres exceptions plutôt que d'être des exceptions génériques, et ici pareil si un try content ici unicode plutôt qu'unicode décodeerror, j'ai ma

00:58:23 :mon downloader décodeerror là hop qui prévient downloader, alors unicodeerror downloader décodeerror, voilà hop qui prévient que ici on a eu un problème de décodage qui retourne le truc vous voyez donc, ici donc je peux faire que, ok ma fonction ici elle ne gère rien, elle va quand même lever des exceptions

00:58:49 :mais j'ai uniformisé cette interface d'exception ici, mes fonctions, toutes les fonctions qui sont liées à mon downloader bibliothèque qui s'appellerait comme ça vont toutes retourner des exceptions qui ont des noms uniformisés des noms qui se rapportent directement à ma fonction et qui seront faciles donc pour le coup à deviner, à utiliser etc

00:59:15 :c'est par exemple la stratégie qu'utilise une bibliothèque comme Request, pour ceux d'entre vous qui l'ont peut-être utilisé Request est une bibliothèque qui remplace urllib, qui simplifie urllib, donc ici nous avons le tuto, le quick start de la bibliothèque Request on peut aller chercher du contenu sur le web avec Request, et puis si je vais

00:59:39 :dans la doc, probablement ici si je vais dans références API j'ai tout un chapitre sur les exceptions ici vous voyez donc j'ai une Request exception et puis ensuite j'ai une ConnectionError, HTTPError,urlRequired, etc...

00:59:55 :vous avez pas mal d'erreurs qui sont liées au réseau et cette bibliothèque va typiquement utiliser donc ses propres exceptions, elle va pas utiliser par exemple les exceptions de urllib et donc vous allez pas retrouver au sein de la bibliothèque Request par exemple une urllib.error

01:00:17 :.urlError ici c'est des erreurs pour urllib ok, donc même chose si vous faites votre propre bibliothèque ne vous préoccupez pas uniquement des paramètres que peuvent accepter, soit les fonctions mais également les méthodes des classes que vous avez, et les valeurs retournées, enfin les types retournés par votre fonction, ici c'est des chaînes

01:00:43 :de caractère, mais également les exceptions qui vont être levées par votre fonction ou votre méthode, et pour ça vous pouvez créer des exceptions personnalisées et ce qu'on voit c'est que créer au plus simple créer une exception personnalisée c'est uniquement créer une classe qui hérite de exceptions et ensuite cette

01:01:07 :classe-là peut elle-même être utilisée dans un mécanisme d'héritage pour permettre une logique de capture qui va être différente si je capture ça, je vais capturer les trois autres en même temps tandis que si je capture ça je capturerais uniquement ça, donc uniquement l'exception spécifique et donc vous pouvez dans vos fonctions

01:01:29 :dans vos petits projets, imaginer des hiérarchies d'exceptions qui faciliteront la vie de l'utilisateur de vos fonctions, même si c'est vous l'utilisateur de vos fonctions, dites-vous toujours travailler l'interface d'une fonction ça permet à votre vous, dans six mois de vous souvenir comment fonctionne ou comment travaille cette fonction et vous pouvez

01:01:55 :documenter ces fonctions de manière exhaustive, que ce soit des fonctions ou des méthodes d'ailleurs, avec une description, en écrivant chaque argument qui est attendu dans la fonction, en documentant la valeur retournée et éventuellement les exceptions qui seront retournées. N'oubliez pas que vous

01:02:13 :pouvez peut-être ajouter des type int mais que les type int ici, ne sont pas en substitut à la documentation donc ici c'est clair que je peux éventuellement éviter de dire d'être redondant donc ici je peux éviter de dire que je retourne une chaîne de caractère puisqu'on précise ici et je peux éviter de dire

01:02:33 :que url est une chaîne de caractère puisque je le précise en type par contre une docstring va préciser également exactement le rôle joué par votre paramètre donc en type int, une annotation de type n'est pas en substitut à c'est pas non plus en substitut aux vérifications que vous pouvez faire

01:02:59 :parce qu'il n'y a rien de contraignant derrière une annotation de type, il n'y a rien qui empêche ici d'appeler cette fonction avec une url qui serait non ou qui serait en donc ne pensez pas que les annotations de type sont des protections. Et puis

01:03:17 :par contre les exceptions elles vont devoir être utilisées en plus, ça fait partie intégrante de ce que j'appelle l'interface d'une fonction l'interface de programmation d'une fonction sachant quelles sont les exceptions qui pourront être levées par une fonction je sais que quand j'utilise cette fonction potentiellement je peux avoir à gérer ces situations

01:03:41 :et quand j'utilise une fonction download web page, je sais probablement que je vais devoir gérer la situation où je n'ai pas de réseau ou alors où je récupère le code d'une page web qui serait mal formée Voilà pour ce que je voulais dire aujourd'hui et pour comment utiliser les exceptions personnalisées

01:04:03 :quand est-ce que je dois laisser à la fonction appelante le soin de gérer ces exceptions ou quand est-ce que je dois les gérer à l'intérieur on a vu quand on gère les exceptions au plus proche du code qui la génère ça va simplifier la suite du code mais ce code là va perdre en flexibilité

01:04:23 :à vous donc de peser le pour et le contre à chaque fois de quand est-ce que vous gérez cette exception mais plutôt le plus proche de l'endroit où cette exception est levée le plus simple sera votre code par la suite Est-ce que vous avez des questions sur les exceptions ?

01:04:45 :Non c'est très clair, merci Je vais arrêter la présentation pour vous voir Ok donc déjà cette fois j'ai progressé par rapport à la dernière fois j'ai pas oublié la vidéo donc si vous deviez revenir sur cette thématique sur la vidéo où vous aurez l'enregistrement dans les enregistrements de docstring, donc à l'endroit habituel

01:05:15 :où vous trouvez les enregistrements des mentorats la prochaine fois qu'on se verra J'avais prévu de faire une session pour discuter des questions ouvertes de toutes vos questions sur la PO donc ici n'hésitez pas à regarder l'agenda pour la suite Voilà 22h06 donc une petite heure ensemble et puis moi il ne me reste plus qu'à vous souhaiter

Session de mentorat TOSA sur la gestion des exceptions et l'usage d'exceptions personnalisées

Session du 27 janvier 2025 à 21h00

Deviens membre Premium

Premium

Session de mentorat TOSA sur la gestion des exceptions et l'usage d'exceptions personnalisées

Rechercher sur le site