Los momentos de standby son realmente malos para cualquier proyecto, pero lo son especialmente para proyectos en los que sólo hay una persona y su planificación no se extiende más allá de tres meses para la primera versión. Con el nacimiento de klicap, decidimos impulsar este plugin y en ello estamos. Antes de retomarlo, analicé el trabajo realizado y me cuestioné algunas decisiones previas. Durante esos días, descubrí cmislib. Según he pedido comprobar, su primer commit tiene fecha de mediados de diciembre de 2009. Su autor es Jeff Potts, presidente y CEO en Metaversant Group, Inc., donde parece que es el único empleado. Esta librería, escrita en python, forma parte del proyecto (en incubación) Apache Chemistry. Éste último tiene como objetivo proporcionar librerías cliente para trabajar con soluciones que implementen la especificación CMIS. La librería no está completa, aun quedan funcionalidades por implementar, pero desde luego su última versión 0.3 publicada es estable y cubre gran parte de la especificación. Teniendo en cuenta que la versión 1.0 de la especificación de CMIS tiene fecha 1 de mayo de 2010, sólo me queda agradecer el excelente trabajo de Jeff.

Esto se traduce en que he dejado de implementar mi propio cliente, y he comenzado a usar esta librería. Esto hace incluso que me planté el nombre del plugin, porque ahora podemos integrar Trac con Alfresco, Nuxeo y otros ECM que implementen CMIS. Desde @klicap haremos lo posible por colaborar en este proyecto.

La configuración del plugin en relación a Alfresco es muy simple:

• Usuario y contraseña (credenciales)
• URL base en la que se publica RESTful API

Dejo por aquí el fragmento de código:

def is_alive(self):
    isAlive_service = self.__url_api + '/login' +  '?u=dummy&pw=dummy'
    self.__log.debug('Restful Service: ' + isAlive_service)
    try:
        response, content = self.__http.request(isAlive_service, 'GET')
        if response.status == httplib.FORBIDDEN:
            self.__log.debug('Alfresco RESTful API is alive')
            return True
        else:
            self.__log.debug('Alfresco RESTful API is not alive')
            return False
    except:
        self.__log.debug('Alfresco RESTful API is not alive')
        return False

Cualquier sugerencia será bienvenida.

1. Java CSV
2. SuperCSV

Opté por la segunda porque me ha permitido trabajar directamente con JavaBeans y es algo más completa que la primera. Otra librería que conocí hace algún tiempo es Smooks. Aunque hubiera sido como cortar el césped con una excavadora, estuve tentado a usarla. Tiene muy buena pinta y las referencias y ejemplos que he visto, son muy interesantes.

Automatic reloading: For development, Tracd can be used in auto_reload mode, which will automatically restart the server whenever you make a change to the code (in Trac itself or in a plugin).

Toda la configuración está perfectamente explicada en el sitio web de Trac. En mi caso me he creado un pequeño script (start_trac.sh):

tracd -p 8000 --basic-auth=AlfrescoTracIntegration,/home/recena/Documentos/trac-users.conf,/home/recena/Documentos/trac-projects/AlfrescoTracIntegration /home/recena/Documentos/trac-projects/AlfrescoTracIntegration

Si por el contrario lo que queremos es ejecutarlo desde Eclipse, también podemos encontrar las correspondientes instrucciones. La intención era haber publicado esta pequeña entrada el pasado jueves, 13 de agosto. Pero he estado sin acceso a Internet desde entonces. Algunas notas que a mi me están viniendo muy bien para comenzar a desarrollar un plugin de Trac sin tener experiencia en Python:

1. Configurar un buen entorno de desarrollo local que nos permita trabajar cómodamente y como no, depurar.
2. Conocer las características del lenguaje de programación. Me he leído “Python para todos“, y sólo agradecer a Raúl González Duque el excelente trabajo realizado.
3. Guías:
   1. Style Guide for Python Code
   2. Docstring Conventions
4. Estudiar otros plugins
5. Instalar TracDeveloper, un plugin de Trac muy útil para desarrollar.

Durante estos días me gustaría acercarme al desarrollo de plugins en Trac. Lo primero que he hecho es leer un poco y conocer qué necesito para configurar un entorno de desarrollo local que me permita trabajar cómodamente. A continuación una descripción del entorno:

1. Mandriva 2009
2. Aptana Studio 1.5.1 (con PyDev)
3. Python 2.6 (paquetes)
4. MySQL Server 5.1
5. Genshi 0.5.1 (paquetes)
6. Setuptools 0.6c9 (paquetes)
7. Subversion 1.6.4 (paquetes)
8. SWIG 1.3.38 (paquetes)
9. Subversion SWIG Python bindings (paquetes, subversion-devel)
10. MySQLDB (Ojo! no ZMySQLDA)
    1. Descargamos los fuentes correspondientes a la versión 1.2.2
    2. Descomprimimos el tar.gz
    3. Asegurarse de que están disponibles de los fuentes de MySQL porque MySQLDB los necesita para su instalación
    4. Seguimos las instrucciones que vienen en archivo README
11. Trac 0.11.5

Os podéis ahorrar muchos de estos pasos porque en varias distribuciones de Linux ya existe un paquete con Trac (con soporte para MySQL y Subversion). Por ejemplo, en Mandriva existe ese paquete. En nuestro ecosistema software usamos Trac con SQLite y todo va muy bien, sin embargo, he querido aprovechar esta ocasión para conocer de primera mano el soporte de MySQL que tiene Trac. Si los resultados son positivos, probablemente, nos planteemos la migración a medio plazo.

Las opciones que encontré para trabajar con documentos Excel desde Java fueron:

1. JExcelApi
2. POI-HSSF / POI-XSSF

En estos momentos estoy usando la primera en Opina, y las impresiones son muy buenas:

• Aunque a priori la documentación parece escasa, es suficiente para comenzar a trabajar y montar un ejemplo.
• Tiene carencias en cuanto al manejo de fórmulas y gráficos, pero si no necesitas algo complejo, es una opción válida.
• No he trabajado con documentos complejos y grandes, pero en breve tendré referencias en este sentido. Tengo encuestas con más de 40 preguntas y más de 1500 usuarios encuestados. Además la estamos usando en un proyecto donde se gestiona un volumen de datos importante y puede ser otra buena referencia. Cuando tenga resultados, los compartiré.
• Los conceptos a manejar son pocos: workbook, worksheet, label, writableFont, writableCellFormat y algunos más.
• La última versión (2.6.10) es el 28 de mayo de 2009. La primera versión de la rama 2.x es del 10 de octubre de 2003. Durante este periodo más de 30 versiones publicadas. Y si vemos la lista de correo, podemos comprobar su actividad.

Que conste que las necesidades que Opina tiene son muy básicas, es probable que otro tipo de proyectos tengan más requisitos y tengan que descartar esta opción. He buscando el artefacto por los repositorios de Maven que conozco, pero no lo he encontrado. Por lo tanto, he definido sus coordenadas para instalarlo en mi repositorio local (y en nuestro ecosistema) y he añadido el JAR a directorio libs correspondiente.

De la segunda opción no puedo decir nada de primera mano, sólo tengo comentarios e impresiones. Es un proyecto importante en ASF y son muchos los proyectos que en él se apoyan, por lo tanto, me da confianza. De hecho lo usamos de forma indirecta porque Eclipse Birt es nuestra opción (actual) para la generación de reportes.

Haz un sub-tema partiendo de Zen Extend And Design. Es un tema considerado base sobre el extender el tuyo. ¿Qué te proporciona?

• Plantillas de las vistas principales (node, page, comment, etc)
• Las plantillas tienen una semántica muy bien definida y usan correctamente los estándares web.
• Un punto de partida para aprender a desarrollar temas en Drupal
• Buena documentación

Una lectura que no puede faltal para todo aquel que vaya a desarrollar un tema es lo que se conoce como la anatomía de un tema. A mi me ha venido muy bien organizar las hojas de estilo según dicha anatomía:

En unos días liberaré el último en el que estoy trabajando.

1. Instalar y configurar Eclipse IDE con soporte para PHP (PDT Project). Ya comenté hace tiempo que uso Pulse para gestionar y mantener distintas instancias de Eclipse IDE.
2. Instalamos Apache Web Server con soporte para PHP (preferiblemente PHP5). Para esto tenemos varias opciones:
   1. LAMPStack de BitNami
   2. Seguir estas instrucciones.
   3. Instalar Apache Web Server con soporte para PHP y MySQL desde paquetes
   4. Instalar Apache Web Server con soporte para PHP y MySQL desde los fuentes
3. Descargamos y descomprimimos Drupal dentro de nuestro workspace de Eclipse:

   [recena@localhost Eclipse 3.3 PDT]$ wget http://ftp.drupal.org/files/projects/drupal-6.4.tar.gz
   [recena@localhost Eclipse 3.3 PDT]$ tar -xvzf drupal-6.4.tar.gz
   [recena@localhost Eclipse 3.3 PDT]$ rm drupal-6.4.tar.gz

4. Ahora configuramos un alias (p.e. qabox) para poder acceder a nuestra instalación de Drupal de una forma similar a http://localhost/qabox. Para ello añadimos a httpd.conf:

   Alias /qabox "/home/recena/Workspaces/Eclipse 3.3 PDT/drupal-6.4"
   <Directory "/home/recena/Workspaces/Eclipse 3.3 PDT/drupal-6.4">
           AllowOverride All
           Options MultiViews Indexes Includes FollowSymLinks
           Order allow,deny
           Allow from all
   </Directory>

5. A partir de este momento, accedemos a http://localhost/qabox, y lo que resta es seguir las instrucciones de la propia instalación de Drupal. Que no se os olvide colocar el correspondiente archivo .htaccess en el directorio raíz donde se encuentre instalado Drupal. En la documentación viene todo perfectamente comentado.

Una vez que tenemos lo básico para ejecutar Drupal nuestro trabajo se centrará -probablemente- en el desarrollo de módulos y/o temas. Pues bien, la idea es tener un proyecto para cada uno de los módulos y/o temas que desarrollemos. De esta forma tendremos nuestra instalación de Drupal por un lado, y nuestros desarrollos (modelados como proyectos de Eclipse) por otro. Ahora lo único que tenemos que hacer es decirle a Drupal que use estos módulos y/o temas. Así iremos viendo los resultados. Para hacer esto basta con hacer simples enlaces simbólicos donde corresponde y hacía donde se encuentran nuestros proyectos.

En la captura de pantalla que se muestra a continuación, veréis un tema que estoy desarrollando que se llama QABox y el enlace simbólico que he creado para que Drupal sepa que dispone de ese tema como se estuviera almacenado en $DRUPAL_HOME/sites/default/themes (p.e.):

Hace unos días os comentaba que estábamos (en GMV) trabajando en un plugin para TRAC llamado STractistics para medir la actividad de los proyectos. Todavía está un poco verde, pero estamos trabajando para añadirle nuevas funcionalidades. Para este proyecto se barajaron varias opciones:

• Generar las gráficas en el servidor al estilo de JpGraph y devolverlas al cliente como una imagen.
• Generar las gráficas en el cliente: HTML + CSS o HTML + CSS +Javascript.
• Generar las gráficas en el cliente: Flash (SWF), OpenFlashChart
• Generar las gráficas en “Google” haciendo uso de Google Chart API

Se hicieron algunas pruebas con la segunda opción y los resultados no eran malos, todo lo contrario, sin embargo, los problemas de compatibilidad con los distintos navegadores web suponía un problema. Las búsquedas nos llevaron a Open Flash Char, desde mi punto de vista, un excelente trabajo que nos permite generar unas vistosas y configurables gráficas.

Ayer leía que el software usado en SOITU durante las elecciones para el renderizado de gráficas ha sido liberado con licencia GNU GPLv3. Mi más sincera enhorabuena por la iniciativa. Después de conocer cómo funciona OpenFlashChart y de leer como funciona Charts (SOITU), la forma en la que este último recoje los datos es más sencilla y cómoda, basta con generar un XML.

Por ahora STractistics se quedará así pero se estudiará la migración a Charts (SOITU).

El objetivo del presente post es, teniendo nuestro proyecto J2EE descrito con Maven y configurado en Eclipse, trabajar con Jetty. En este caso el proyecto será Opina e intentaremos usar Jetty en lugar de Apache Tomcat durante el desarrollo.

En primer lugar tendremos que configurar el plugin de maven correspondiente. Para ello, en la sección correspondiente a build (dentro de pom.xml):

<plugin>
<groupId>org.mortbay.jetty</groupId>
<artifactId>maven-jetty-plugin</artifactId>
<version>6.1.5</version>
<configuration>
<scanIntervalSeconds>5</scanIntervalSeconds>
<scanTargets>
<scanTarget>
${basedir}/src/main/webapp/WEB-INF
</scanTarget>
</scanTargets>
<classesDirectory>
${basedir}/src/main/webapp/WEB-INF
</classesDirectory>
<contextPath>${project.artifactId}</contextPath>
<webAppSourceDirectory>
${basedir}/src/main/webapp
</webAppSourceDirectory>
<webXml>
${basedir}/src/main/webapp/WEB-INF/web.xml
</webXml>
</configuration>
</plugin>

Esta configuración está condicionada a que en Opina usarmos ${basedir}/src/main/webapp para montar la aplicación mientras estamos desarrollando. Prueba de ello es que normalmente usamos: mvn compile war:inplace

Una vez que hemos actualizado el archivo pom.xml, vamos a configurar Eclipse para que podamos invocar a Maven con los argumentos que necesitamos:

1. Run > External Tools > Open External Tools Dialog
2. Sobre Program, pulsamos el botón derecho y  New
3. Definimos un nombre para esta tarea (junto a Name)
4. Estando sobre la pestaña Main:
   1. Location: Indicamos donde se encuentra el ejecutable de Maven
   2. Working directory: Navegamos por Working Directory y seleccionamos nuestro proyecto
   3. Arguments: Indicamos los argumentos que nos interesen, por ejemplo: compile war:inplace jetty:run. Con estos argumentos conseguimos que nuestro proyecto pase por todas las fases del ciclo de vida definido en Maven hasta llegar a la fase de compilación. Esto nos garantizará que se han generado todos nuestros recursos (web.xml, struts-config.xml, etc), se ha aplicado nuestro perfil correspondiente (profiles.xml), se ha compilado nuestras clases, se han obtenido nuestras dependencias y que nuestra aplicación se ha construido en ${basedir}/src/main/webapp.
5. Aplicar
6. Cerrar

Si todo ha ido bien, estaremos dispuestos a ejecutar la tarea. Para ello:

He preparado un screencast de la consola de Eclipse simplemente para que vea como se ejecutan las distintas tareas que se le indican a Maven y como posteriormente se lanza Jetty con nuestra aplicación.

Y ahora lo más importante para poder desarrollar con estos ingredientes, la depuración. ¿Qué tenemos que hacer para poder depurar? El siguiente objetivo es claro. Ahora necesitamos seguir usando la perspectiva de depuración de Eclipse de igual forma que la usamos en otros proyectos o la usamos cuando usamos Apache Tomcat.

Tenemos que modificar la tarea que hemos creado. Para ello, editamos la tarea, y sobre la pestaña Environment, añadimos la variable MAVEN_OPTS con el valor: -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=4000,server=y,suspend=y

Una vez modificada la tarea:

1. Run > Open Debug Dialog
2. Sobre Remote Java Application, pulsamos con el botón derecho y New
3. Definimos un nombre (junto a Name)
4. Y sobre la pestaña Connetion:
   1. Project: Selecionamos nuestro proyecto
   2. Connection Properties:
      1. Host: localhost
      2. Port: 4000 (el que hemos indicando en MAVEN_OPTS).
5. Aplicar
6. Cerrar (aun no debemos depurar nada)

Teniendo la tarea definida y la configuración para la depuración, estamos en disposición de comprobar si todo ha ido bien. Para ello, he preparado un segundo screencast.

Algunas referencias donde viene todo esto explicado:

1. Debugging with the Maven Jetty Plugin inside Eclipse
2. Maven Jetty Plugin

Un problema con el que me he encontrado, y parece que más gente, es que cuando se desea terminar la tarea que acabados de ejecutar el proceso no se detiene y Jetty continua en ejecución. Si las tareas que hemos definido las ejecutamos desde la línea de comandos todo funciona perfectamente. Al pulsar CTRL+C, la tarea de Maven termina y Jetty de apaga correctamente. Parece que hay un parche que nos ayuda a terminar la tarea que aun no he probado.

Es probable que la integración mejore considerablemente cuando hagan compatible con la versión 6 de Jetty el plugin de Eclipse Jetty Launcher.

Existen otras formas de integración con los mismos ingredientes. Sin embargo esta es la que interesante me ha parecido, entre otras cosas porque no nos hemos tenido que preocupar ni de descargar Jetty.