Pi-WebIde-Debugeur
Introduction
Le débogueur python du WebIDE peut être utile dans de nombreuses situations.
Le débogueur vous permet d'exécuter votre programme Python pas-à-pas en temps réel. Ce qui contraste avec le visualiseur, qui exécute le programme dans son entièreté, et vous permet ensuite d'en parcourir le contenu.
Quand utiliser le débogueur?
Parmi les scénario, il y a le cas de la fonction qui ne retourne pas les résultats/valeurs escomptées, ou une variable qui ne semble pas contenir la valeur attendue.
Dans ces cas de figure, vous pouvez lancer le débugeur et placer des points d'arrêt ("breakpoint" en anglais) où vous pensez que le code pose problème et voir quelles sont les valeurs à un moment donné de l'exécution de votre programme.
Vous pouvez également utiliser les broches du GPIO pour allumer différentes LEDs. Vous les verrez s'allumer et s'éteindre au fur et à mesure de l'exécution pas-à-pas de votre programme.
Utiliser le debuggeur
Pour utiliser le débogueur, ouvrez un fichier python, et cliquez sur "Debug" dans la "barre d'outils" :
après avoir cliqué sur le lien, la barre d'outils change pour une barre de débogage. Elle s'ouvrira en quelques secondes. l'éditeur s'affiche, et vous pouvez effectuer des changements dans votre code pendant le débogage.
Lorsque le débogueur est prêt, vous verrez ce qui suit :
Le débogueur effectue plus que simplement exécuter le programme, ou que d'utiliser le visualiseur.
La première chose que vous remarquerez est que la barre d'outils (#1) dispose de nouveaux boutons :
- Save/Restart permettent de sauvegarder votre fichier, et redémarrer le débogueur en un seul clic. Vous pouvez aussi démarrer en pressant "control-s", ou "command-s" (sous OS X).
- Le lien Exit permettra de sortir du débogueur.
- Le lien Run lance l'exécution de votre programme soit jusqu'à la fin, soit jusqu'au prochain point d'arrêt que vous avez activé. si il existe un point d'arrêt actif (en cliquant dans la "gouttière" (#6)), il stoppera ici, et attendra vos instructions.
- Pas-à-pas fera progresser l'exécution de votre programme, ligne par ligne jusqu'à la fin. Cette option ignore tous les appels de fonction. donc, si vous avez une fonction appelée foo(), il exécutera la fonction entière, et passera à la prochaine ligne.
- Il passera bien pas après pas dans votre programme, mais il passera au-dessus des fonctions, au lieu de les exécuter pas-à-pas.
L'éditeur est également affiché (#2). Vous pouvez éditer votre fichier à tout moment. Si vous faites des changements à votre fichier, vous devrez cliquer le lien "Save/Restart" dans la barre d'outils pour que le débogueur prenne en compte ces changements.
Sur les deux panneaux du bas, vous y verrez la sortie de débogage (#3), et les Variables de débogage (#4). la sortie débogage affiche les sorties stdout or stderr que votre programme génère (comme les états d'impression). les variables débogage affichent les valeurs réelles qui leurs sont assignées.
La ligne rouge dans l'éditeur (#5) se déplace à chaque pas de votre programme. C'est la prochaine ligne qui sera exécutée, et qui restera centrée dans la fenêtre de l'éditeur pendant la progression du programme.
A l'extrême gauche de l'éditeur (#6), nous avons un espace vide à gauche des numéros de ligne. Cet espace est appelé la "gouttière". Si vous cliquez dans la gouttière lorsque le débogueur est en état "Ready", vous pouvez ajouter des points d'arrêt. Un point d'arrêt est utile dans de nombreuses situations, comme lorsque vous avez un long script, et qu'il y a un problème dans une section boguée. Au lieu d'exécuter lentement pas-à-pas votre programme, vous pouvez créer un point d'arrêt (un carré rouge apparaîtra dans la gouttière), ensuit cliquez sur "Run". Le script s'exécutera jusqu'au point d'arrêt, la ligne rouge marquera l'arrêt, et attendra que vous continuiez l'exécution.
La dernière option à prendre en compte est les messages d'état de débogage (#7). Ceux-ci vous indiqueront la progression du débogueur. Par exemple, quand il charge au démarrage, ou lorsque vous cliquez "Save/Restart", il sera dans un état d'"initialisation...". Lorsqu'il sera prêt à accepter vos entrées, il sera "Ready". Certaines parties de votre script le feront apparaître bloqué, mais en réalité, il attend une réponse du serveur à votre script (une commande sleep() de longue durée peut causer cet état, par exemple).
Dans la capture d'écran ci-dessus, vous pouvez voir à quoi ressemble le débogueur pendant l'exécution d'un programme. Le débogueur est un pas avant le point d'arrêt imposé à la ligne 13 du code. Vous pouvez voir 'print "Bonjour, World"' dans la sortie débogage, et les valeurs des variables au moment de l'exécution du programme.
A ce point du cycle de débogage, vous pouvez éditer votre fichier, et "Save/Restart". Vous pouvez continuer le parcourt pas-à-pas du programme, ou quitter le débogueur.
Source: [1]
Réalisé avec l'aide de Mr Carette J. à qui nous remettons tous nos remerciements.
Tutoriel créé par Tyler Cooper pour AdaFruit Industries. Tutorial created by Tyler Cooper for AdaFruit Industries.
Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : « Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.
L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.
Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com