Corriendo las pruebas de Symfony2

Antes de presentar un parche para su inclusión, es necesario ejecutar la batería de pruebas de Symfony2 para comprobar que no ha roto nada.

PHPUnit

Para ejecutar la batería de pruebas de Symfony2, primero instala PHPUnit 3.6.4 o superior:

$ pear config-set auto_discover 1
$ pear install pear.phpunit.de/PHPUnit

Dependencias (opcional)

Para ejecutar la batería de pruebas completa, incluyendo las pruebas supeditadas con dependencias externas, Symfony2 tiene que ser capaz de cargarlas automáticamente. De forma predeterminada, se cargan automáticamente desde vendor/ en la raíz del directorio principal (consulta la sección autoload.php.dist).

La batería de pruebas necesita las siguientes bibliotecas de terceros:

  • Doctrine
  • Swiftmailer
  • Twig
  • Monolog

Para instalarlas todas, usa Composer:

Paso 1: Consigue Composer

curl -s http://getcomposer.org/installer | php

Asegúrate de descargar composer.phar en el mismo directorio dónde se encuentra el archivo composer.json.

Paso 2: Instala las bibliotecas de terceros

$ php composer.phar --dev install

Nota

Ten en cuenta que el guión toma algún tiempo para terminar.

Nota

Si no tienes instalado curl, simplemente puedes descargar manualmente el archivo instalador de http://getcomposer.org/installer. Coloca ese archivo en tu proyecto y luego ejecuta:

$ php installer
$ php composer.phar --dev install

Después de la instalación, puedes actualizar los proveedores en cualquier momento con la siguiente orden.

$ php composer.phar --dev update

Ejecutando

En primer lugar, actualiza los proveedores (consulta más arriba).

A continuación, ejecuta la batería de pruebas desde el directorio raíz de Symfony2 con la siguiente orden:

$ phpunit

La salida debe mostrar OK. Si no es así, es necesario averiguar qué está pasando y si las pruebas se rompen a causa de tus modificaciones.

Truco

Si deseas probar la ruta de un tipo de componente único después de la orden phpunit, por ejemplo:

$ phpunit src/Symfony/Component/Finder/

Truco

Ejecuta la batería de pruebas antes de aplicar las modificaciones para comprobar que funcionan bien en tu configuración.

Cobertura de código

Si agregas una nueva característica, también necesitas comprobar la cobertura de código usando la opción coverage-html:

$ phpunit --coverage-html=cov/

Verifica la cobertura de código abriendo en un navegador la página generada cov/index.html.

Truco

La cobertura de código sólo funciona si tienes activado XDebug e instaladas todas las dependencias.

Bifúrcame en GitHub