gvSIG blog

Comentamos la semana pasada la posibilidad de añadir geoprocesos a la Caja de Herramientas de gvSIG. Un problema era que teníamos que ejecutar manualmente este script cada vez que quisiéramos añadir el geoproceso, y esto hacerlo cada vez que arrancamos gvSIG.

Una solución que hemos desarrollado es la oportunidad de añadir un fichero que se ejecutará cada vez que arranquemos gvSIG, teniendo la posibilidad de realizar la tarea que deseemos. Por supuesto, esto será útil para cualquier tipo de herramienta que realicemos.

La forma de hacerlo es muy sencilla y voy a basarme en el script de la semana anterior que aparece en el post sobre Insertar nuevos geoprocesos mediante Scripting.

Vamos a suponer que tenemos nuestro script dentro de una carpeta denominada /gridpol/ dentro de la cual solo estaría por ahora nuestro script quedando: /gridpol/geoprocess_gridpol.py

Para poder crear un fichero autoejecutable, necesitamos dos cosas:

• Crear un fichero __init__.py dentro de la carpeta donde se encuentra nuestro script. Esto viene de Python y hará que esta carpeta sea tratada como un módulo, por ejemplo, permitiéndonos realizar imports sobre ella. Este fichero es de iniciación del módulo y puede estar en blanco.
• Crear un fichero autorun.py, este script es el que se ejecutará al arrancarse gvSIG y que contendrá el código que nos interese.

En este caso, dentro del fichero geoprocess_gridpol.py he metido lo que había dentro de la función main() en una función selfRegister(). Esta parte del código es la que se encarga de añadir el proceso a la Caja de Herramientas. En este ejemplo podríamos eliminar la ventana emergente msgbox() para que no nos aparezca cada vez que abrimos gvSIG.

En geoprocess_gridpol.py quedará la función siguiente a la misma altura que la función main():

def selfRegister(*args):
        # Creamos nuesto geoproceso
        process = GridPol()
        # Lo registramos entre los procesos disponibles en el grupo de "Scripting"
        process.selfregister("Scripting")
        
        # Actualizamos el interface de usuario de la Toolbox
        process.updateToolbox()

Lo que hago ahora es escribir en el fichero autorun lo siguiente:

# encoding: utf-8

import geoprocess_gridpol
reload(geoprocess_gridpol)

def main(*args):
    geoprocess_gridpol.selfRegister()

De esta forma el fichero autorun estará llamando a la función selfRegister que acabamos de crear y ejecutará esa parte del código. Como vemos, estamos importando el script que teníamos creado. Con reload() estamos forzando a Jython a recompilar este módulo, por si hubieran habido cambios.

El reload es útil a la hora de realizar importaciones para que aparezcan los cambios realizados en script modificados pero no ejecutados, como puede ser el caso de librerías creadas por nosotros dentro del propio módulo.

Quedará una estructura del proyecto similar a:

Guardamos los cambios, reiniciamos gvSIG, y veremos que se realiza la ejecución de proceso. Los scripts que contienen un autorun, se van cargando en segundo plano mientras gvSIG se acaba de iniciar, podéis ver esta carga en la parte inferior izquierda de la aplicación.

Es recomendable no abrir el Scripting Composer hasta que no acabe la ejecución de estos autorun ya que en algunos casos puede llevar a un fallo de ejecución.

También hemos añadido una opción extra en la cual puedes desactivar los ficheros autorun que no desees que se ejecuten al inicio. Puede ser útil si estamos desarrollando uno de estos módulos o dejamos de utilizar alguna herramienta.

Para ello solo tienes que irte al Scripting Composer, abrir el fichero autorun correspondiente, y en la pestaña de Propiedades desactivar la opción de Enabled que vendrá activada por defecto:

Acordaros siempre de Guardar los cambios. Si falta algo por guardar, el nombre del script aparecerá en negrita en las pestañas de la parte superior.

Cualquier duda podéis poneros en contacto con nosotros en las Listas de Usuarios o Desarrolladores.

Para la nueva versión de gvSIG 2.3 se han realizado una gran cantidad de mejoras a nivel de integración con sus librerías, pero también en las herramientas de desarrollo para ayudar en la creación de scripts y extensiones.

Debido a esto, el Scripting Composer ha recibido una ampliación de funcionalidades muy interesantes para los desarrolladores, el pack de herramientas ScriptingComposerTools. Estas funcionalidades vienen a completar las herramientas básicas que podría tener cualquier IDE, con la ventaja de tenerlo todo ya integrado en gvSIG.

Y un tema importante, todas estas herramientas se han realizado con esta misma IDE dentro de gvSIG desarrolladas sobre Jython, las cuales amplían las funcionalidades del Scripting Composer en forma de extensiones.

Renovación del interfaz

Editor integrado

Tendremos un editor integrado en nuestro IDE no solo para ficheros .py, sino para otros como DBF, TXT..

Navigator

Una ventana en la que aparecerá un árbol con todas las funciones y clases que tenga nuestro script, permitiendo movernos entre ellas con un solo click. Si cambiamos de script, el árbol se actualizará automáticamente al nuevo script.

Podemos tenerlo integrado en la ventana para un uso continuo:

O llamarlo cuando lo necesitemos con CONTROL + O.

Búsqueda de referencias

Podemos abrir esta herramienta con CONTROL+R. Nos ayudará a buscar texto, clases, funciones, métodos.. en nuestro código o módulo.

Si por ejemplo buscamos en este caso sobre Panel, nos aparecerán los siguientes resultados mostrando en qué puntos está siendo llamado o declarado. Haciendo click sobre ellos nos llevará a la línea de código donde se encuentra.

Correcciones mientras escribimos

Hemos integrado un analizador de código, que comprobará los errores básicos de programación.

Por ejemplo, en este caso estamos intentando imprimir el valor de una variable que no existe.

Autocompletado

Herramientas de autocompletado básico, con variables de nuestro script, indicador de funciones de gvSIG con el mismo nombre, librerías, etc. Se lanza al presionar CONTROL+ESPACIO mientras escribimos código.

Herramienta de generación de interfaces visuales: Abeille

La integración de Abeille en la herramienta, nos permitirá su ejecución desde un botón, y a la hora de guardar el fichero creado nos aparecerá por defecto la ruta actual de nuestro script.

Y abierta la aplicación:

Revisión de sintaxis con Lint

Una de las herramientas incorporadas es Lint.

Nos permitirá analizar nuestro código en busca de errores como en este ejemplo, encontrando variables declaradas en desuso.

Debugging

Los errores que nos aparezcan en el IDE a la hora de la ejecución podremos hacer click sobre ellos y nos llevará directamente al error y nos abrirá el script donde saltó el error. Muy útil para el desarrollo de plugins.

Cerrar scripts en ejecución

A veces queremos cerrar un script el cual se encuentra en bucle o no accesible. Para ellos hemos desarrollado una herramienta en la cual podemos parar estos scripts en ejecución.

Aparecerá integrada en nuestro IDE:

Empaquetador de scripts

La posibilidad de desarrollar plugins basados en scripts tenía que venir acompañada de la posibilidad de poder empaquetarlos y enviarlos. Seleccionando la carpeta donde se encuentra todo nuestro módulo, podremos empaquetar un script en un paquete de gvsig: .gvspkg

Estos paquetes podrán ser instalados desde el Administrador de Complementos como si se trataran de cualquier otro tipo de plugin.

Ayuda integrada

Y una de las más importantes, una ayuda integrada sobre el módulo de programación. Permitiendo acceder a la información de javadocs y otras webs sobre Scripting.

Por contenidos:

Por clases:

Ayuda web que se encuentra actualmente en desarrollo:

Y la posibilidad de añadir otro tipo de documentación:

Si este pack de herramientas no vienen instalados en vuestra distribución al no ser aún finales, podéis descargarlas desde el repositorio oficial denominadas como ScriptingComposerTools. Solo tendréis que instalarlo y reiniciar gvSIG. Si queréis echarle un vistazo al código, solo tendréis que entrar en el Scripting Composer y buscar en la carpeta de addons.

Todas estas herramientas son de nuevo desarrollo y siguen en desarrollo. Os animamos a probarlas y a reportar los posibles errores que podáis encontrar, también recomendaciones para su mejora. Os podéis poner en contacto con nosotros en Listas de Usuarios o Desarrolladores.