Entradas de agosto 2011

Tests para formularios HTML con Watir

25 de agosto, 2011 - por | 2 comentarios | Desarrollo, QA

Modelar nos ayuda a adelantar problemas futuros. Es igual que lo hagamos con plastilina, madera o tests.

Aunque nosotros no tenemos una orientación fuerte hacia los tests, en el sentido de considerarlos una parte esencial de cualquiera de nuestros proyectos, sí que los incorporamos cuando entendemos que nos vienen bien. Ésto ocurre sobre todo en proyectos de larga duración, con múltiples funcionalidades, y en constante crecimiento.

Cuando se dan esas ocasiones, utilizamos las siguientes herramientas:

  • el framework PHPUnit para código PHP
  • el framework unittest para código Python
  • el framework Watir para tests basados en el navegador

Hoy queremos hablar un poco del último, ofreciendo un ejemplo de cómo lo utilizamos.

Instalar Watir (Web Application Testing in Ruby)

Watir es una gema de Ruby, por lo que lo primero que tienes que tener funcionando en tu máquina es Ruby. Tienes toda la información necesaria en la página oficial de Ruby.

Con Ruby funcionando, en un entorno Linux como el nuestro, la instalación de Watir requiere primero tener instaladas las rubygems. A partir de ahí, instalamos Watir:


sudo gem install watir-webdriver

Para cualquier otro entorno, o ver más información sobre detalles de la instalación, consulta la documentación oficial de Watir (en inglés).

Test para un formulario HTML

Un caso habitual en los tests basados en el navegador son los formularios. Por ejemplo, piensa en el siguiente formulario, que es una captura de uno de nuestros proyectos.

Captura del formulario sobre el que se hace el test.

En este típico formulario hay 2 campos (‘Title’ ‘Comment’) y un botón de envío (‘send’). Con Watir podemos montar un test sencillo que compruebe, por ejemplo, que el proceso de añadir un comentario está funcionando correctamente.

Cuando escribes un test basado en el navegador, tus 2 recursos principales son la URL y el HTML. Con la primera obtienes la página que quieres testear, y con todo el documento HTML de esa página puedes empezar a establecer las evaluaciones que quieres probar. En nuestro ejemplo, la parte que nos interesa del HTML, es la que afecta al formulario que acabamos de mostrar. Así que una aproximación razonable sería rellenar ese formulario con datos de prueba y realizar el envío.

Creamos un fichero, lo nombramos como test_review_form.rb, y lo iniciamos con el siguiente código.


# Test for Biz Review
require 'rubygems'
require 'watir-webdriver'
b = Watir::Browser.new :firefox
b.goto 'http://mistones.dev/hdz-granite-dallas/review'
b.text_field(:name, 'title').set('Great stock and fast service')
b.text_field(:name, 'comment').set('
        Both my husband and I are pretty happy with the job the
        guys at HDZ Granite have done in our kitchen and our
        master bath. Fair price, helpful, informative and on time.
')
b.button(:value, 'send').click

Bastante claro, ¿no? Le decimos a Watir que abra una URL. Que dentro del documento HTML de esa URL rellene los campos, cuyos atributos name son ‘title’ y ‘comment’, con los datos que le pasamos. Y que a continuación pulse el botón cuyo atributo value es ‘send’.

Nos falta añadir la evaluación. En nuestro caso, vamos a evaluar si existe cierto contenido en el documento HTML, contenido que sabemos que sólo existe en la página posterior a un envío correcto.


if b.text.include? 'Your Review has been Published'
        puts 'Test passed. Test review successful.'
else
        puts 'Test failed. Test review was not successful.'
end

Con ésto ya tenemos un test completo. Podemos probarlo llamándolo:


ruby test_review_form.rb

A continuación, Watir abre el navegador instanciado en el test y ejecuta los pasos indicados. Cuando termina, devuelve los mensajes de ‘passed’ o ‘failed’.

Una vez que cuentas con este tipo de tests, dependiendo de tus gustos, filosofía, metodología, estilo, etc. puedes automatizarlos con herramientas de integración continua, o crearte tu propio proceso de comprobación, o sencillamente correrlos cada cierto tiempo para asegurarte de que las cosas siguen funcionando.

Git: ver el log, buscar en el log

23 de agosto, 2011 - por | | Desarrollo, Tips

Una buena búsqueda te puede ayudar mucho. También a sobrevivir.

Cuando llevas un tiempo trabajando en un repositorio con Git, empiezas a tener la necesidad de revisar el log de lo que ha ido pasando. Algunas de las acciones más típicas con las que te vas a encontrar, son las siguientes.

Ver lo que ha cambiado en cada commit


git log -p

Ver los ficheros que han cambiado en cada commit


git log --stat

Ver el listado de todos los commits con sus ramas


git log --pretty=oneline --abbrev-commit --graph --decorate

Ésto te devuelve un listado de los commits con sus títulos abreviados, en una sola línea y con una representación jerárquica de sus ramas. Puedes verlo en la siguiente captura de uno de nuestros proyectos:

Buscar palabras que aparecen en el título del commit


git log --grep="tu búsqueda"

Buscar cuándo algo fue añadido o eliminado


git log -S "tu búsqueda"

Filtrar por fechas recientes con MySQL sobre Codeigniter

12 de agosto, 2011 - por | | Desarrollo

Nos pierde lo que acaba de suceder. Vivimos más intensamente lo que es reciente.

Hace poco he tenido que desarrollar el clásico grupo de filtros en forma de checkboxes, combos y radio buttons que se van aplicando con cada click que hace el usuario sobre un listado inicial de todos los elementos posibles.

Uno de los filtros tiene el siguiente aspecto:

La forma más fácil de desarrollar este filtro la encontré utilizando la función MySQL DATE_SUB(). Esta función tiene la siguiente sintaxis:


DATE_SUB(date,INTERVAL expr type)

donde date es una fecha cualquiera válida, y INTERVAL el número que quieres sustraer.

Lo que hice fue lo siguiente. A cada una de las opciones del filtro le asigno un valor numérico (31, 7 y 2 respectivamente). Considero date como el día de hoy, es decir, el momento en el que el usuario está aplicando el filtro. Le paso ambos argumentos a la función de MySQL, en la forma en el que Active Record de Codeigniter permite hacer este tipo de cosas:


$where = "upload_ts > DATE_SUB( NOW( ) , INTERVAL " . $days . " DAY)";
$this->db->where($where, null, false);

Página de mantenimiento con nginx

11 de agosto, 2011 - por | | Sistemas, Tips

En varios de nuestros proyectos utilizamos nginx como servidor HTTP. A veces solo, y otras como proxy de Apache sirviendo únicamente contenidos estáticos (mira este otro post para ver las ventajas de hacer ésto).

En cualquier sitio web te ves obligado en algún momento a poner el sitio offline: por tareas de mantenimiento de sistemas, por nuevas versiones del código, por cambios en la infraestructura, etc. Puesto que debes informar siempre al usuario de lo que pasa en tu sitio, debes tener preparada para todas esas ocasiones una página que indique que el servicio no está disponible.

En nginx eso se consigue colocando en el fichero de configuración lo siguiente:


server {
        error_page 503 @maintenance;
        location @maintenance {
                rewrite ^(.*)$ /503.html break;
        }
}

El nombre del fichero puede ser cualquiera que tú elijas. Lo que hace nginx es que siempre que existe ese fichero (en el $document_root), redirige cualquier petición que le llega a esa página. Y lo hace, además, devolviendo un código de estado 503. Puedes comprobar ésto en el Header de la página con cualquier herramienta popular tipo Firebug (documentación en inglés).

Instalar SSH2 para PHP 5.3 en CentOS

10 de agosto, 2011 - por | 1 comentario | Desarrollo, Sistemas

En el proceso de instalación de SSH2 para PHP 5.3 sobre CentOS hay un primer paso que sigue funcionando igual de bien que anteriormente:


yum install gcc php53-devel libssh2 libssh2-devel

Sin embargo, PHP 5.3 sobre CentOS aún no ha incorporado el paquete correspondiente para:


php53-pear

necesario para manejar la instalación de la extensión SSH2 mediante PECL. Es un bug ya apuntado en el Bugzilla de Redhat, pero que aún está pendiente de resolución.

Hay dos métodos principales para resolver este problema. Uno que consiste en utilizar el repositorio IUS, que ofrece paquetes php53 y extensiones más actualizados, junto con un php53-pear. Si te decides por este método, este post de Eric London te explica los pasos principales (en inglés).

El segundo método consiste en conservar el paquete tradicional php-pear y forzar su actualización mediante los siguientes comandos:


pear upgrade --force Console_Getopt
pear upgrade --force pear
pear upgrade-all

Una vez que tienes instalados los paquetes mencionados, ya puedes instalar la extensión SSH2:


pecl install -f ssh2

Una vez que esté instalada, verás que al final del proceso de instalación te indica como siempre la línea que debes añadir al fichero php.ini:


extension=ssh2.so

Reinicias tu servidor HTTP y compruebas que la extensión está cargada y funcionando:


php -m | grep ssh2

Actualizar WordPress por SSH

10 de agosto, 2011 - por | | Sistemas, Tips

Tenemos que ir más allá de nuestros límites corporales para conseguir muchas cosas.

WordPress incluye desde hace tiempo la posibilidad de actualizar directamente desde el admin tanto el core, como los plugins y los temas. Es decir, los 3 componentes principales. Para nosotros, que manejamos múltiples WordPress, es la forma más cómoda de mantenerlos actualizados.

La lástima es que la interfaz del admin sólo menciona la posibilidad de hacerlo por FTP, cuando en realidad también existe la alternativa de hacerlo por SSH. Lo único que hace falta es que tengas instalada y funcionando en tu servidor la extensión SSH2 para PHP; una vez la tienes corriendo, verás cómo WordPress te enseña en la misma pantalla de actualización la posibilidad de hacerlo por SSH.

Si te mueves en Linux, en la mayoría de las distribuciones recientes instalar la extensión SSH2 para PHP es muy fácil: no te exige compilar nada, como hace unos años. Por ejemplo, para Debian/Ubuntu este post de Kevin van Zonneveld te lo resuelve todo (en inglés).

Ahora bien, si te mueves en CentOS, y te has animado a probar PHP 5.3 sobre esa plataforma, la cosa desgraciadamente se complica un poco. Si estás interesado en ésto, te lo explicamos en este otro post.