Cómo depurar código Python con PyScripter

Transcripción

1 Cómo depurar código Python con PyScripter En este post vamos a daros las claves para aprovechar el uso de PyScripter como editor de código de Python para ArcGIS, tanto para escribir código como para la detección y corrección de errores de programación. Ventajas de usar PyScripter Utiliza diferentes colores, indenta y comenta el código de modo rápido, subraya una palabra determinada, busca y reemplaza, etc. Es personalizable: colores, plantillas, fragmentos completos de código, etc. Tiene predicción de código fuente, que agiliza nuestro trabajo y evita que cometamos errores de escritura. Las ventanas del IDE y de depuración, entre las que destacamos la ventana de Variables y la ventana Intérprete ayudan durante la ejecución del script al seguimiento del código.

2 La utilización de un IDE como PyScripter facilita el trabajo y reduce la posibilidad de introducir errores en nuestros programas. Aún así cometeremos fallos, sobre todo al principio, que es cuando precisamente más nos van a entorpecer. Cómo reparar nuestros errores? Un 50% del error se soluciona cuando descubrimos DONDE ESTÁ EL ERROR. El otro 50% se soluciona cuando descubrimos POR QUÉ SE HA PRODUCIDO EL ERROR. Respecto al primer punto, para localizar el error debemos aprender a DEPURAR EL CÓDIGO. PyScripter cuenta con una barra de herramientas de depuración: Depurar código: Opción 1 > ejecutando línea por línea: usaremos esta opción cuando creamos saber dónde está el error, para parar en ese punto y examinar el comportamiento del programa, los valores que adoptan las variables, etc.

3 1.1 Situando el cursor en la línea del script en la que queremos interrumpir la ejecución automática y pulsando la flecha azul Ejecutar hasta el cursor o F4. A partir del punto de interrupción cada línea de código se ejecutará cuando el usuario pulse el icono Avanzar hasta la siguiente línea o F8, de este modo localizamos la sentencia que falla y los valores que el programa está interpretando. 1.2 Fijando nuestros puntos de interruptor con el círculo rojo Conmutar punto de parada o F5 sobre cada línea en la que queramos conmutar parada y pulsando la flechita verde con bicho Depurar o F9. Depurar código: Opción 2 > ejecutando fragmentos de código: utilizaremos esta opción cuando sabemos que el programa funciona antes de haber incluido nuevas sentencias, y queremos comprobar el funcionamiento de las mismas sin tener que ejecutar para ello el script completo. Resaltando las líneas que nos interesan y pulsando Ctl+F7, o con botón derecho Source Code/Ejecutar Selección. Cómo capturar los errores? En cuanto a la segunda cuestión: porqué ha fallado nuestro programa, podemos capturar el error y mostrarlo en la ventana Intérprete de PyScripter. Para ello tendremos que utilizar la estructura try & except. Con esta estructura el programa intenta (try) ejecutar todo el código que se encuentre indentado dentro del bloque try:. Si se produce un fallo, el código se dirige al bloque except: en el que se mostrará el mensaje de error generado. Cuales son los errores más típicos y cómo se interpretan? El siguiente listado muestra los errores más típicos y el mensaje de error que muestra la ventana intérprete: 1.- Case Sensitive: Python diferencia las mayúsculas y minúsculas. Ojo con darle un nombre a una variable y pretender usarla llamándola de otro modo.

4 El mensaje de error que se genera depende del la palabra en la que se encuentre la confusión: si se trata del nombre de una capa o de una ruta, el mensaje mostrado nos dirá que no existe dicha capa o que no se localiza: Input Features: xxx.shp does not exist or is not supported. Puede incluso no generarse ningún error, pero no darnos la respuesta que queremos. 2.- Indentación: en Python cada bloque de código debe ir sangrado para que el intérprete lo identifique y diferencie. Los fallos de indentación detectados quedan marcados en rojo, además si intentamos ejecutar el script se mostrará el mensaje IndentationError: expected an indented block. Ojo, puede que el código funcione, pero una frase mal indentada puede cambiar el curso del programa y su resultado. 3.- Importación de módulos. Antes de trabajar con alguna herramienta de una librería específica debemos importar esta librería. En nuestro caso, si queremos trabajar con la ArcPy para ArcGIS debemos incluir al principio del programa un import ArcPy El mensaje de error que nos da en caso de no haber importado la Arcpy es name arcpy is not defined 4.-Símbolo de igualdad y símbolo de asignación de valor. Cuando Python quiere darle un valor a una variable lo hace a través del símbolo =. Cuando queremos comprobar si un valor es igual a otro utilizaremos el símbolo ==. El mensaje de error en una sentencia como if coordx = 3500: será SyntaxError: invalid syntax. 5.- Condiciones y bucles mal construidos. Además de la indentación del código, estas construcciones requieren que la primera frase finalice con el símbolo :. El mensaje de error en una sentencia como if coordx = =3500 será igualmente SyntaxError: invalid syntax. La sentencia correcta es:

5 if coordx = =3500: coordy = Incorrecta definición de una ruta. En Python la contrabarra \ forma parte de sentencias clave como \n (nueva línea) o \t (tabulador). Una ruta debe precederse de la letra r o sustituir el símbolo \ por \\ o por /. Ojo además con los acentos, los espacios en blanco y las mayúsculas y minúsculas. El mensaje de error puede ser si se trata de la ubicación de una capa Input Features: xxx.shp does not exist or is not supported, o si se trata de la identificación de un espacio de trabajo, en cuyo caso, puede tomar un valor como nulo y por tanto no localizar los datos de ese workspace. 7.- Parámetros mal introducidos: en número o en orden. Centrándonos en el uso de herramientas de ArcGIS, aunque también es un error típico de otro tipo de funciones, debemos saber qué argumentos requiere cada herramienta, de qué tipo son y en qué orden deben introducirse. El mensaje de error que se genera en este caso es Failed to execute. Parameters are not valid. Si te ha gustado nuestro post de hoy compártelo y ayúdanos a seguir, muchas gracias!!