El motivo de escribir esta pequeña entrada es para que no se me olvide que si queremos trabajar con MySQL y utf-8, y lo hacemos usando en API de PHP (sin librerías ni frameworks) no se nos puede olvidar indicar que nuestra sesión con MySQL (que actúa de cliente) use utf-8. Por muy a pesar de que MySQL tenga configurado en el servidor que su encoding por defecto sea utf-8. Eso sirve, entre otras cosas, para la creación de nuevos esquemas.

Os dejo un ejemplo:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

$xml = simplexml_load_file('/home/recena/countries_es.xml');
$link =  mysql_connect('localhost', 'root', '');
mysql_select_db('mivecindad', $link);
if(!$link) {
    die('No pudo conectarse: ' . mysql_error());
}
mysql_query("SET NAMES 'utf8';");
foreach($xml as $key => $value) {
    $capital = mysql_real_escape_string($value->capital);
    $sql = "INSERT INTO MV_PAIS (CAPITAL) VALUES('".$capital."')";
    $result = mysql_query($sql);
    if(!$result) {
        die('Invalid query: ' . mysql_error());
    }
}
mysql_close($link);

Para el sitio web estamos usando yii framework y el pequeño modelo (datos) que necesitamos (persona, dirección, comunidad) se construye según la propuesta del framework. Me dejé llevar pensado que luego tendría la posibilidad de generar mi JSON según lo requiere el servicio y me encontré bastante limitado.

En mi entorno de desarrollo tengo compilado PHP con soporte (nativo, parte del core de PHP) para JSON. Lo probé, no conseguí hacer lo que necesitaba sin reinventar la rueda en el framework, y decidí buscar algo de información para conocer qué otras opciones tenía. La idea era encontrar alguna librería que me permitiese manipular JSON con mayor flexibilidad.

1. Extensión de PECL. Realmente no es una opción porque esta extensión es la que ahora forma parte del core de PHP y está muy limitada.
2. Service JSON. Un paquete de PEAR cuya última versión fue publicada a comienzos de este año. Al igual que la anterior, muy limitada.
3. Zend_JSON. Realmente tampoco era una opción porque no estoy usando Zend framework, pero es bueno saber que está ahí.

Hay algunas (pocas) opciones más pero ninguna hacía lo que necesitaba. Tengo que reconocer que vengo muy condicionado porque en Java sí existen librerías que permiten una mayor manipulación en la codificación. Concretamente en nuestros últimos proyectos estamos usando FlexJSON (v.2.0b4, aunque ya está publicada la v2.1).

¿Realicé una mala búsqueda de información o realmente lo que está publicado se limita a decode/encode? Cualquier sugerencia será bienvenida para completar esta pequeña entrada en el blog.

Finalmente decidí hacer algo muy simple pero no por ello menos eficaz. Comprobé que si en lugar de trabajar con objetos, trabajaba con un array asociativo, podía obtener el JSON que necesitaba, por lo tanto, creé dicho array a partir de los datos almacenados en el modelo (clases de yii framework). Dejo una última referencia con una comparativa interesante.

Como recordatorio, y por si a alguien le pudiera ser de interés, algunos apuntes sobre la instalación. Indicar que para este entorno de desarrollo estoy usando Ubuntu y tirando de paquetes (nada de compilar por raro que parezca en mi):

1. Comprobar que tenéis PEAR y en caso negativo instalarlo.
2. Comprobar que tenéis el paquete de desarrollo de PHP (php5-dev). Nos daremos cuenta fácilmente que lo necesitamos porque durante la compilación de la extensión nos dirá que no encuentra la herramienta phpize.
3. [opcional] Comprobar que tenéis CURL y su paquete de desarrollo
4. Instalación de la extensión: sudo pecl install oauth
5. En el directorio /etc/php5/conf.d creamos un archivo llamado oauth.ini (podéis llamarlo como queráis) e incluis la siguiente línea:

   extension=/usr/lib/php5/20060613+lfs/oauth.so

6. Reiniciamos el servidor web e invocamos al conocido testphp.php con su llamada a phpinfo() para asegurarnos de que la extensión está disponible y se ha cargado correctamente.

Le enviaré al autor de la extensión (yii) nuestros cambios confiando que aplique el parche y publique una nueva versión. Leyendo un poco en su blog he podido comprobar que está trabajando en una herramienta de gestión de proyectos similar a Trac y Redmine. Le seguiré el rastro para ver su evolución.

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.