7. Débogage

7.1 Mode debug

Quand vous testez de nouvelles versions d'un programme, il arrive souvent de modifier un module importé par des scripts. Pour des raisons de performance, l'interpréteur standard de Python utilise des versions compilées des modules importées, et ne tient pas compte de modifications dans le code source

En mettant l'option debug à 1 dans le fichier de configuartion, les modules dont le code source a été modifié depuis leur dernière utilisation seront rechargés

Une fois que le programme est au point, vous pouvez mettre le mode debug à 0

7.2 Gestion des erreurs et débogueur

Si une erreur survient quand on appelle une URL, une trace est affichée dans le navigateur

L'information fournie consiste en :

l'url appelée
une table relative au script dans lequel l'erreur s'est produite : il se peut que ce ne soit pas celui dont le nom correspond à l'URL, si l'erreur est survenue dans un script inclus par la fonction Include(). La table montre le nom du script, le nom de l'exception, le numéro et le texte de la ligne dans le script erronné
la trace Python brute
un bouton "debug" si vous avez donné la valeur 1 à l'option debug dans le fichier de configuration

Par exemple :

Error in /demo/errors/ErrorInIncludedTest1.py

/demo/errors/ErrorInIncludedTest1.py
 includes /demo/errors/ErrorInIncludedTest2.py

Script /demo/errors/ErrorInIncludedTest1.pyNameError: name 'bonjour' is not defined
Line 1    
print 'Script 1'

Traceback (most recent call last):
  File "C:\cygwin\home\Karrigell\Template.py", line 153, in render
    exec self.pythonCode() in ns
  File "<string>", line 1, in ?
NameError: name 'bonjour' is not defined

Avec ce bouton "Debug" on accède à plus d'informations au sujet de l'erreur :

le code source, avec syntaxe colorée et la ligne où s'est produite l'erreur mise en évidence
une vue de l'environnement, dans laquelle on peut naviguer pour trouver la valeur des variables, le code source des fonctions et méthodes, etc

Aperçu :

Si vous ne voulez pas que les utilisateurs voient ces informations, vous pouvez donner la valeur 0 à l'option debug dans le fichier de configuration

7.3 Utilisation de `SCRIPT_END`

Pendant le débogage d'un script il peut être utile de se servir de l'exception intégrée SCRIPT_END pour arrêter l'exécution. Si vous voulez connaître la valeur d'une variable au moment où une exception se produit, vous pouvez écrire quelque chose comme ceci :

(...)
print "la_valeur est",la_valeur
raise SCRIPT_END
(... la ligne où l'exception est déclenchée ...)

7. Débogage

7.1 Mode debug

7.2 Gestion des erreurs et débogueur

7.3 Utilisation de SCRIPT_END

7.3 Utilisation de `SCRIPT_END`