Atoum, le framework de tests unitaires pour PHP 5.3 simple, moderne et intuitif.+

ATOUM
Le framework de tests unitaires pour PHP 5.3+
simple, moderne et intuitif.

PMSIpilot, Lyon, le 18 avril 2011

lundi 18 avril 2011

Mojo technique d’ATOUM

Modernité,
Rapidité,
Simplicité,
Fiabilité.

lundi 18 avril 2011

Modernité

PHP ≥ 5.3 :
Espaces de noms,
Late State Binding,
Fonctions anonymes et fermetures,
PHAR.

lundi 18 avril 2011

Dépendances optionnelles

Xdebug pour la couverture de code.
XML pour le rapport xunit.
SVN pour l’intégration continue.

lundi 18 avril 2011

Rapidité

Lors de l’installation :
Une archive PHAR à télécharger.
À l’utilisation :
Une archive PHAR à inclure dans le ﬁchier de test,
Fichier de tests exécutable directement.

lundi 18 avril 2011

Exemple de test
namespace vendorprojecttestsunits;
use mageekguyatoum, vendorproject;

require_once(__DIR__ . '/../../vendor/atoum.phar');

class foo extends atoumtest {
! public function testBar() {
! ! $foo = new projectfoo();

$this->assert
->object($foo->bar())->isIdenticalTo($foo)
;
! }
}

lundi 18 avril 2011

Exécution d’un test
# php path/to/test.php
> Atoum version 325 by Frédéric Hardy (/Users/fch/Atoum)
> PHP path: /Users/fch/PHP/Install/5.3.6/bin/php
> PHP version:
=> PHP 5.3.6 (cli) (built: Apr 3 2011 17:53:34)
=> Copyright (c) 1997-2011 The PHP Group
=> Zend Engine v2.3.0, Copyright (c) 1998-2011 Zend
Technologies
> vendorprojecttestsunitsfoo:
[S____________________________________________________][1/1]
=> Test duration: 0.14 second.
=> Memory usage: 1.00 Mb.
> Total test duration: 0.1 second.
> Total test memory usage: 1.00 Mb.
> Running duration: 0.5 second.
...

lundi 18 avril 2011

Alternatives pour l’exécution
# php atoum.phar -t path/to/tests/units/foo.php
...
# php atoum.phar -d path/to/tests/units
...
# ./atoum.phar path/to/test.php
...
# ./atoum.phar -d path/to/tests/units
...

lundi 18 avril 2011

Simplicité
Simpliﬁer l’écriture et la maintenance des
tests
Grâce à une API naturelle,
Grâce à des assertions expressives,
Grâce à la notion d’adaptateur,
Grâce à des bouchons simples à utiliser,
Grâce à des annotations.

lundi 18 avril 2011

Assertions expressives
...
$this->assert
->object($foo->bar())->isIdenticalTo($foo)
->string($foo->getBar())->isEqualTo(‘bar’)
->integer($foo->countBar()
->isGreaterThan(100)
->isLessThan(1000)
;
...

Calquent le langage « naturel »,
Utilisent une interface ﬂuide,
Permettent plusieurs tests sur une même variable,
Indépendantes de la classe de test.

lundi 18 avril 2011

Alias et labels
...
$this->define
->alias(‘int’, ‘integer’)
->alias(‘str’, ‘string’)
->object($foo)->is(‘foo’)
;

$this->assert
->foo->isIdenticalTo($foo->getBar())
->str($foo->getBar())->isEqualTo(‘bar’)
->int($foo->countBar()
->isGreaterThan(100)
->isLessThan(1000)
;
...

lundi 18 avril 2011

Adaptateur
Proxy indépendant et générique pour :
Les appels aux fonctions de PHP :
fopen(), etc.
Les appels aux super-globales de PHP :
$_SERVER, $_GET, etc.
Assertion dédiée.

lundi 18 avril 2011

Principe des adaptateurs
Valeur de retour des fonctions/super-globales
déﬁnissables :
par valeur,
via l’exécution d’une fonction anonyme.
$adapter = new projectadapter();
$adapter->_SERVER = array(‘foo’ => ‘bar’);
$adapter->_GET = function() use ($request) {
return $request->getValues();
};
$adapter->fopen = false;
$adapter->fopen[1] = true;
$adapter->md5 = function() { return md5(‘’); };

lundi 18 avril 2011

Déﬁnition d’un adaptateur
namespace vendorprojectadapter;
use mageekguyatoum;

interface adapter implements atoumadapterdefinition {}

use vendorprojectadapter, mageekguyatoumtest;

class adapter extends testadapter
implements adapterdefinition {}

namespace vendorproject;
use vendorprojectadapter, mageekguyatoum;

class adapter extends atoumadapter
implements adapterdefinition {}

lundi 18 avril 2011

Utilisation de l’adaptateur
dans une classe
namespace vendorproject;

class foo { ...
public function __construct(adapter $adapter) {
$this->adapter = $adapter;
}

public function write($string, $path) {
if ($this->adapter->fopen($path) === false) {
throw new exception(‘Unable to open’);
} ...
}
}

lundi 18 avril 2011

Utilisation de l’adaptateur
dans les tests
...
class foo ... { ...
public function testWrite() {
$foo = new projectfoo($adapter = new testadapter());
$adapter->fopen = false;
$this->assert->exception(function() use ($foo) {
$foo->write(uniqid(), uniqid());
}
)
->isInstanceOf(‘exception’)
->hasMessage(‘Unable to open’)
}
}

lundi 18 avril 2011

Bouchonnages
Extension de l’adaptateur.
Possible de bouchonner :
des classes, des classes abstraites ou des classes
inconnues,
des interfaces.
Espace de nom dédié.
Assertion dédiée.

lundi 18 avril 2011

Exemple de bouchonnage

use mageekguyatoummock;
...
class foo ... { ...
public function testWrite() {
$this->mock(‘vendorprojectfile’);

$file = new mockfile();
$file->getMockController()->open = false;

$foo = new foo($path = uniqid());

$this->assert
->exception(function() use ($foo)
{ $foo->open($file); }
)
->isInstanceOf(‘exception’)
->hasMessage(‘Unable to open’)
->mock($file)->call(‘open’, array($path))
;
}
}

lundi 18 avril 2011

Annotations
Utilisées pour l’instant pour :
Ignorer une classe de test,
Ignorer une méthode de test dans une classe.

...
/** @ignore off */
class foo extends atoumtest {
/** @ignore on */
public function testBar { ... }
}
...

lundi 18 avril 2011

Fiabilité

Isolation des tests.
Traçage correct des erreurs et des exceptions.
Rapports d’exécution simples et évolutifs.

lundi 18 avril 2011

Isolation des tests
Un processus PHP « vierge » est utilisé pour exécuter
chaque méthode d’une classe de test.
Aucune interaction entre les tests,
Pas de corruption de l’environnement,
Retour signiﬁcatif en cas de crash de PHP,
Un crash ou une erreur dans une méthode ne
perturbe pas les autres tests.
En contrepartie, perte de performance.

lundi 18 avril 2011

Traçage des erreurs et des
exceptions
Location précise des erreurs et des exceptions :
Dans la classe de tests d’origine par :
Méthode,
Numéro de ligne,
Assertion.
Dans la classe d’origine dans la mesure du possible.

lundi 18 avril 2011

Exemple de trace d’erreur
> Atoum version XXX by Frédéric Hardy (/path/to/atoum)
> vendorprojectfoo:
> Success (1 test, 1 method, 0 assertion, 1 error, 0
exception) !
> There is 1 error:
=> vendorprojecttestsunitsfoo::testBar():
==> Error 255 in /path/to/project/vendor/tests/units/classes/
foo.php on unknown line, generated by file /path/to/project/
vendor/tests/units/classes/foo.php on line 15:
Fatal error: Call to undefined function niqid()

lundi 18 avril 2011

Rapports simples et évolutifs
Un rapport est un ensemble de champs.
Un champ correspond à un type de données :
Durée d’exécution,
Assertion non vériﬁée,
Erreur,
Etc.
Remplis en fonction d’événements déclenchés lors de
l’exécution des tests.
lundi 18 avril 2011

Deux familles de rapports
Temps réel :
Le rapport est « écrit » au fur et à mesure de
l’exécution des tests.
Utilisé par défaut en ligne de commande.
Asynchrone :
Le rapport est « écrit » à la ﬁn de l’exécution des
tests.
xunit

lundi 18 avril 2011

Utilisation des rapports
Possible de générer plusieurs rapport simultanément :
CLI,
CLI + xunit.
Possible d’écrire sur plusieurs médias un même
rapport :
CLI,
CLI + mail,
Fichier + mail.
lundi 18 avril 2011

Exemple de mise en œuvre
des rapports
...
use mageekguyatoum;

$mailer = new atoummailersmail();
$mailer
->to(‘dev@atoum.org’);
->from(‘runner@atoum.org’)
;

$report = new atoumreportsasynchronousvim();
$report
->addWriter(new atoumwritersstdout());
->addWriter(new atoumwritersmail($mailer))
;

$runner->addReport($report);
...

lundi 18 avril 2011

Exemple de rapport
# php path/to/test.php
> PHP path: /Users/fch/PHP/Install/5.3.6/bin/php
> PHP version:
=> PHP 5.3.6 (cli) (built: Apr 3 2011 17:53:34)
=> Copyright (c) 1997-2011 The PHP Group
=> Zend Engine v2.3.0, Copyright (c) 1998-2011 Zend Technologies
> vendorprojecttestsunitsfoo:
[S____________________________________________________][1/1]

lundi 18 avril 2011

Quelques statistiques

> 800 Ko de code.
> 22 000 lignes de code.
2 développeurs.
Utilisé chez F-Secure.

lundi 18 avril 2011

Ressources
http://downloads.atoum.org/nightly.
https://svn.mageekbox.net/repositories/atoum/trunk.
Documentation en cours de rédaction mais :
php mageekguy.atoum.phar --help,
path/to/atoum/tests/units/classes.
Site en cours de réalisation.

lundi 18 avril 2011

Questions ?

lundi 18 avril 2011

Cette conférence est maintenant terminée,
vous pouvez reprendre une activité normale.

lundi 18 avril 2011

Atoum, le framework de tests unitaires pour PHP 5.3 simple, moderne et intuitif.+

Contenu connexe

Tendances (19)

Similaire à Atoum, le framework de tests unitaires pour PHP 5.3 simple, moderne et intuitif.+ (20)

Plus de Frederic Hardy (10)

Atoum, le framework de tests unitaires pour PHP 5.3 simple, moderne et intuitif.+