Pi-WebIde-Debugeur - Historique des versions

Admin : /* Les volets de débogage */

2013-08-11T11:10:39Z

Les volets de débogage

Admin : /* Utiliser le debuggeur */

2013-08-11T11:10:13Z

Utiliser le debuggeur

Admin : /* Utiliser le debuggeur */

2013-08-09T11:33:26Z

Utiliser le debuggeur

Admin : /* Utiliser le debuggeur */

2013-08-09T11:32:28Z

Utiliser le debuggeur

Admin : /* Utiliser le debuggeur */

2013-08-09T11:31:38Z

Utiliser le debuggeur

Admin : /* Utiliser le debuggeur */

2013-08-09T11:26:31Z

Utiliser le debuggeur

Admin : /* Utiliser le debuggeur */

2013-08-09T11:25:28Z

Utiliser le debuggeur

Admin : /* Utiliser le debuggeur */

2013-08-09T11:01:33Z

Utiliser le debuggeur

Admin le 8 août 2013 à 11:18

2013-08-08T11:18:09Z

Admin le 8 août 2013 à 11:16

2013-08-08T11:16:46Z

@@ Ligne 51 : / Ligne 51 : @@
 * La sortie débogage affiche les sorties ''stdout'' et ''stderr'' produites par votre programme produit.<br />Les instructions "print", par exemple, produisent du texte sur ''stdout''. Ce texte sera donc visible dans le volet (#3)..
 * Les variables de débogage affichent les valeurs réelles qui leurs sont assignées durant l'exécution. Ces valeurs sont donc rafraichies à chaque nouveau pas de débogage pour que le contenu reflète les opérations exécutées par votre programme.<br />Le contenu de cette section, et le nombre de variables visibles, dépends donc de la progression du programme.
 === La marge du débogueur ===

@@ Ligne 30 : / Ligne 30 : @@
 Le débogueur réalise plus de choses que simplement exécuter le programme (également plus que l'utilisation visualiseur).
 La première chose que vous remarquerez c'est les nouveau boutons qui apparaissent dans la la barre d'outils (#1):
@@ Ligne 38 : / Ligne 39 : @@
 * '''Step in''': (''pas dedans'' en traduction littérale). C'est aussi une exécution pas-à-pas comme décrit ci-dessus '''mais''' lorsque le débogueur rencontrera un appel de fonction, il sautera dans la définition de la fonction où vous pourrez continuer l'exécution pas à pas.<br />Une fois le débogage de la fonction terminée, le débogueur vous replacera tout seul au point d'appel de cette dernière où vous pourrez poursuivre le débogage pas-à-pas.<br />''C'est un mode de débogage pratique '''si vous voulez savoir''' ce qui se passe dans les différentes fonctions utilisées''.
 L'éditeur est également affiché (#2). Vous pouvez éditer votre fichier à tout moment. Lorsque vous faites des modifications dans votre fichier, vous devrez cliquer le lien "Save/Restart" (''sauver et redémarrer'') dans la barre d'outils pour que le débogueur prenne ces changements en compte.
 Sur les deux volets du bas, vous y verrez "les sorties" produites durant le débogage (#3) et les différentes variables accessibles par le débogueur (#4).
@@ Ligne 46 : / Ligne 54 : @@
 {{traduction}}
-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.
+=== La marge du débogueur ===
-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.
+Par exemple, quand il se charge au démarrage, ou lorsque vous cliquez "Save/Restart" (sauver/redémarrer), le débogueur sera dans l'état "Initializing..." (signifiant ''initialisation...'' en français).
-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).
+Lorsqu'il sera prêt à accepter vos commandes, il sera en état "Ready" (''Prêt''). Certaines parties de votre script feront apparaitre le débogueur comme bloqué, mais en réalité, ce dernier attend simplement une réponse de votre  script. Cet état peut, par exemple, être causé par une commande sleep() de longue durée.
 [[Fichier:Pi-WebIde-Debug-03.png]]
-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.
+Dans la capture d'écran ci-dessus, vous pouvez voir à quoi ressemble le débogueur pendant l'exécution d'un 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.
+A ce point du cycle de débogage, vous pouvez:
 {{Pi-WebIde-TRAILER}}

@@ Ligne 42 : / Ligne 42 : @@
 Sur les deux volets du bas, vous y verrez "les sorties" produites durant le débogage (#3) et les différentes variables accessibles par le débogueur (#4).
 * La sortie débogage affiche les sorties ''stdout'' et ''stderr'' produites par votre programme produit.<br />Les instructions "print", par exemple, produisent du texte sur ''stdout''. Ce texte sera donc visible dans le volet (#3)..
-* Les variables de débogage affichent les valeurs réelles qui leurs sont assignées durant l'exécution. Ces valeurs sont donc rafraichies à chaque nouveau pas de débogage pour que le contenu reflète les opérations exécutées par votre programme.<br />Le contenu de cette section, et ne nombre de variables visibles, dépends donc de la progression du programme.
+* Les variables de débogage affichent les valeurs réelles qui leurs sont assignées durant l'exécution. Ces valeurs sont donc rafraichies à chaque nouveau pas de débogage pour que le contenu reflète les opérations exécutées par votre programme.<br />Le contenu de cette section, et le nombre de variables visibles, dépends donc de la progression du programme.
 {{traduction}}

@@ Ligne 41 : / Ligne 41 : @@
 Sur les deux volets du bas, vous y verrez "les sorties" produites durant le débogage (#3) et les différentes variables accessibles par le débogueur (#4).
-* La sortie débogage affiche les sorties ''stdout'' et ''stderr'' produites par votre programme produit. PAr exemple, les instruction "print" produisent du texte sur ''stdout''. Ce texte sera donc visible dans le volet (#3)..
+* La sortie débogage affiche les sorties ''stdout'' et ''stderr'' produites par votre programme produit.<br />Les instructions "print", par exemple, produisent du texte sur ''stdout''. Ce texte sera donc visible dans le volet (#3)..
 * Les variables de débogage affichent les valeurs réelles qui leurs sont assignées durant l'exécution. Ces valeurs sont donc rafraichies à chaque nouveau pas de débogage pour que le contenu reflète les opérations exécutées par votre programme.<br />Le contenu de cette section, et ne nombre de variables visibles, dépends donc de la progression du programme.

@@ Ligne 40 : / Ligne 40 : @@
 L'éditeur est également affiché (#2). Vous pouvez éditer votre fichier à tout moment. Lorsque vous faites des modifications dans votre fichier, vous devrez cliquer le lien "Save/Restart" (''sauver et redémarrer'') dans la barre d'outils pour que le débogueur prenne ces changements en compte.
-Sur les deux volets du bas, vous y verrez "les sorties" produites durant le débogage (#3) et les différentes variables accessibles par le débogueur (#4).<br />la sortie débogage affiche les sorties stdout ou stderr que votre programme produit (comme par exemple les instructions "print").<br />les variables de débogage affichent les valeurs réelles qui leurs sont assignées durant l'exécution de la ligne pas-à-pas (le contenu de cette section, et ne nombre de variables visibles, dépends donc de la progression du programme).
+Sur les deux volets du bas, vous y verrez "les sorties" produites durant le débogage (#3) et les différentes variables accessibles par le débogueur (#4).
 {{traduction}}

@@ Ligne 32 : / Ligne 32 : @@
 La première chose que vous remarquerez c'est les nouveau boutons qui apparaissent dans la la barre d'outils (#1):
-# Save/Restart: (''sauver et redémarrer'') permettent de sauvegarder vos modifications dans le fichier et de redémarrer le débogueur en un seul clic. Vous pouvez aussi opter pour le raccourci clavier "control-s", ou "command-s" (sous OS X).
+* '''Save/Restart''': (''sauver et redémarrer'') permettent de sauvegarder vos modifications dans le fichier et de redémarrer le débogueur en un seul clic. Vous pouvez aussi opter pour le raccourci clavier "control-s", ou "command-s" (sous OS X).
-# Exit: (''sortir'') ce lien permettra de sortir du débogueur.
+* '''Exit''': (''sortir'') ce lien permettra de sortir du débogueur.
-# Run: (''exécuter'' ce lien poursuit l'exécution de votre programme soit jusqu'à la fin, soit jusqu'au prochain point d'arrêt<br />. S'il existe un point d'arrêt actif (activé en cliquant dans la marge (#6)), le débogueur stoppera le programme dessus et attendra vos instructions.
+* '''Run''': (''exécuter'' ce lien poursuit l'exécution de votre programme soit jusqu'à la fin, soit jusqu'au prochain point d'arrêt<br />. S'il existe un point d'arrêt actif (activé en cliquant dans la marge (#6)), le débogueur stoppera le programme dessus et attendra vos instructions.
-# Step Over: (''pas-à-pas'') fera progresser l'exécution de votre programme d'une ligne puis le débogueur attend vos instructions. Le mode pas-à-pas permet donc d'exécuter un programme ligne par ligne jusqu'à la fin.<br />La fonction "Step-Over" (''pas au dessus'' en traduction littérale) ignore le détail d'exécution des fonctions appelées. Donc, si vous avez une fonction foo() appelée par votre programme, le débogueur exécutera la fonction en une seule opération et passera à la ligne suivante de votre programme.<br />''C'est un mode de débogage pratique '''si vous ne voulez pas savoir''' ce qui se passe dans les différentes fonctions utilisées.''.
+* '''Step Over''': (''pas-à-pas'') fera progresser l'exécution de votre programme d'une ligne puis le débogueur attend vos instructions. Le mode pas-à-pas permet donc d'exécuter un programme ligne par ligne jusqu'à la fin.<br />La fonction "Step-Over" (''pas au dessus'' en traduction littérale) ignore le détail d'exécution des fonctions appelées. Donc, si vous avez une fonction foo() appelée par votre programme, le débogueur exécutera la fonction en une seule opération et passera à la ligne suivante de votre programme.<br />''C'est un mode de débogage pratique '''si vous ne voulez pas savoir''' ce qui se passe dans les différentes fonctions utilisées.''.
-# Step in: (''pas dedans'' en traduction littérale). C'est aussi une exécution pas-à-pas comme décrit ci-dessus '''mais''' lorsque le débogueur rencontrera un appel de fonction, il sautera dans la définition de la fonction où vous pourrez continuer l'exécution pas à pas.<br />Une fois le débogage de la fonction terminée, le débogueur vous replacera tout seul au point d'appel de cette dernière où vous pourrez poursuivre le débogage pas-à-pas.<br />''C'est un mode de débogage pratique '''si vous voulez savoir''' ce qui se passe dans les différentes fonctions utilisées''.
+* '''Step in''': (''pas dedans'' en traduction littérale). C'est aussi une exécution pas-à-pas comme décrit ci-dessus '''mais''' lorsque le débogueur rencontrera un appel de fonction, il sautera dans la définition de la fonction où vous pourrez continuer l'exécution pas à pas.<br />Une fois le débogage de la fonction terminée, le débogueur vous replacera tout seul au point d'appel de cette dernière où vous pourrez poursuivre le débogage pas-à-pas.<br />''C'est un mode de débogage pratique '''si vous voulez savoir''' ce qui se passe dans les différentes fonctions utilisées''.
 L'éditeur est également affiché (#2). Vous pouvez éditer votre fichier à tout moment. Lorsque vous faites des modifications dans votre fichier, vous devrez cliquer le lien "Save/Restart" (''sauver et redémarrer'') dans la barre d'outils pour que le débogueur prenne ces changements en compte.

@@ Ligne 20 : / Ligne 20 : @@
 [[Fichier:Pi-WebIde-Debug-01.png]]
-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.
+après avoir cliqué sur le lien, la barre d'outils change pour afficher les options débogage dans la barre. Cette modification intervient en quelques secondes.
-Lorsque le débogueur est prêt, vous verrez ce qui suit :
+L'éditeur s'affiche, et vous pouvez effectuer des modifications dans votre code pendant le débogage.
 [[Fichier:Pi-WebIde-Debug-02.png]]
-Le débogueur effectue plus que simplement exécuter le programme, ou que d'utiliser le visualiseur.
+Le débogueur réalise plus de choses que simplement exécuter le programme (également plus que l'utilisation visualiseur).
-La première chose que vous remarquerez est que la barre d'outils (#1) dispose de nouveaux boutons :
+La première chose que vous remarquerez c'est les nouveau boutons qui apparaissent dans la la barre d'outils (#1):
-# 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).
+# Save/Restart: (''sauver et redémarrer'') permettent de sauvegarder vos modifications dans le fichier et de redémarrer le débogueur en un seul clic. Vous pouvez aussi opter pour le raccourci clavier "control-s", ou "command-s" (sous OS X).
-# Le lien Exit permettra de sortir du débogueur.
+# Exit: (''sortir'') ce lien 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.
+# Run: (''exécuter'' ce lien poursuit l'exécution de votre programme soit jusqu'à la fin, soit jusqu'au prochain point d'arrêt<br />. S'il existe un point d'arrêt actif (activé en cliquant dans la marge (#6)), le débogueur stoppera le programme dessus 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.
+# Step Over: (''pas-à-pas'') fera progresser l'exécution de votre programme d'une ligne. xxxx, 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.

@@ Ligne 1 : / Ligne 1 : @@
 {{Pi-WebIde-NAV}}
 {{bloc-etroit|text=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?
+=== 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.
@@ Ligne 12 : / Ligne 13 : @@
 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.}}
 Pour utiliser le débogueur, ouvrez un fichier python, et cliquez sur "Debug" dans la "barre d'outils" :

@@ Ligne 11 : / Ligne 11 : @@
 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.  As you step through your program, you'll see them turn on and off as you'd expect..}}
+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.}}
 Pour utiliser le débogueur, ouvrez un fichier python, et cliquez sur "Debug" dans la "barre d'outils" :