Exécution et débogage de Python

Ces étapes s'appuient sur le script créé dans Création d'un nouveau script Python.

Afficher une version complète de ce script.

Etapes :

1. Cliquez sur le bouton Check dans la barre d'outils standard PythonWin pour vérifier si votre script contient des erreurs de syntaxe ou d'indentation. Si une erreur est signalée, le curseur se place dessus. Corrigez la syntaxe et vérifiez-la de nouveau jusqu'à ce qu'aucune erreur ne s'affiche.
2. Cliquez sur le bouton Run pour ouvrir la boîte de dialogue Run Script.
3. Tapez les paramètres requis par le script : un espace de travail en entrée, une classe d'entités de découpage, un espace de travail en sortie et une tolérance XY. Vous pouvez spécifier vos propres données ou utiliser celles du didacticiel. Le tableau suivant présente les données de didacticiel disponibles. Les chemins d'accès aux données contenant des espaces, entourez-les de guillemets lorsque vous les utilisez comme paramètre.

Chemin	Paramètre
"C:\ArcGIS\ArcTutor\GP Service Examples\DriveTimePolygons\ToolData\SanFrancisco.gdb\Transportation"	Espace de travail en entrée
"D:\ArcGIS\ArcTutor\GP Service Examples\DriveTimePolygons\ToolData\SanFrancisco.gdb\BaseMap\Parks"	Classe d'entités de découpage
"D:\ArcGIS\ArcTutor\GP Service Examples\DriveTimePolygons\Scratch\Scratch.gdb"	Espace de travail en sortie
5	tolérance x,y

Données de didacticiel utilisables avec le script

La tolérance XY est facultative dans l'outil Découpage. Vous pouvez donc l'omettre si vous souhaitez utiliser la tolérance XY par défaut pour chaque classe d'entités en entrée.

4. Sélectionnez l'option Step-through in the debugger comme option de débogage, puis cliquez sur OK.

Deux fenêtres s'affichent, la fenêtre Watch, indiquant la valeur des expressions que vous définissez, et la fenêtre Stack, affichant la valeur des variables dans la pile des appels du système (vous pouvez activer ou fermer les fenêtres Watch et Stack en cliquant sur les boutons dans la barre d'outils de débogage). Le curseur se positionne sur la première ligne du script interprété par Python correspondant à l'instruction import. Ajustez la taille de la fenêtre de l'application Python pour réorganiser les nouvelles fenêtres.

5. Cliquez sur le bouton Step Over . Cela exécute la ligne de code en cours qui importe tous les modules spécifiés, puis le code passe à la ligne suivante.

Outre le bouton Step Over, la barre d'outils de débogage inclut le bouton Step et le bouton Step Out .

• Step : exécute la ligne en cours et attend la suivante.
• Step Over : exécute la ligne en cours. Si la ligne inclut un appel de module, de fonction ou de méthode Python, le module, la fonction ou la méthode sont exécutés.
• Step Out : si le code est dans un module, une fonction ou une méthode, il est exécuté et le débogueur retourne au code qui suit le module, la fonction ou la méthode.
6. Cliquez sur le bouton Step Over plusieurs fois pour atteindre l'instruction try.
7. Dans la fenêtre Stack, cliquez sur le nœud _main_module.
8. Cliquez sur le nœud Locals (Dict) pour afficher toutes les variables locales et leurs valeurs.

Toutes les variables que vous avez définies apparaissent dans la fenêtre interactive, ainsi que le script multi_clip et les modules que vous avez importés. Utilisez la fenêtre Stack pour vérifier le domaine d'applicabilité de vos variables et de leurs valeurs, ainsi que le contenu de tous les modules disponibles.

9. Cliquez sur le bouton Step Over plusieurs fois pour placer le curseur sur l'instruction while. Les trois lignes que vous exécutez créent la liste des classes d'entités disponibles et remplissent la variable fc avec le premier nom.
10. Dans la fenêtre Watch, cliquez sur <Nouvel attribut> et entrez "fc". Appuyez sur Entrée pour modifier l'expression selon le nom de la variable. La valeur de la variable s'affiche.
11. Double-cliquez sur le bouton Step Over pour définir l'espace de travail en sortie, puis vous déplacer vers l'instruction if.
12. Cliquez sur le bouton Step Over pour vous déplacer vers le bloc de code de l'instruction if dans lequel l'outil Découper est exécuté.
13. Double-cliquez sur le bouton Step Over pour exécuter l'outil et récupérer le nom de la classe d'entités suivante à partir de l'énumération des noms de classes d'entités. Notez la valeur de la variable fc dans la fenêtre Watch.
14. Cliquez sur les boutons des fenêtres Watch et Stack dans la barre d'outils de débogage pour les fermer.
15. Cliquez sur le bouton de la fenêtre interactive . Ajoutez le code suivant et appuyez sur Entrée :

arcpy.GetMessages()

Tous les messages provenant de l'outil Découper s'affichent dans la fenêtre interactive. Des objets et des variables quelconques peuvent être utilisés dans la fenêtre interactive lors d'une session de débogage. La fenêtre peut donc servir à interroger des objets et gérer des variables.

16. Cliquez sur le bouton Fermer dans la barre d'outils de débogage pour arrêter l'exécution du script.
Astuce :
La valeur d'une variable de chaîne est précédée de la lettre u pour indiquer qu'il s'agit d'une chaîne Unicode. Unicode représente une norme de jeu de caractères 16 bits facilitant la prise en charge de plusieurs langages.