Bon d'accord, voici comment.
Nous devons créer une sous-classe de l'affichage utilisée,
dans notre cas il s'agit de HtmlReporter.
La classe HtmlReporter est situé dans le fichier
simpletest/reporter.php :
pour l'instant elle a l'interface suivante...
Voici ce que les méthodes pertinentes veulent dire.
Vous pouvez consulter la
liste complète ici
si cela vous intéresse.
-
HtmlReporter()
est le constructeur. Notez qu'un test unitaire initie
le lien vers l'affichage plutôt que l'inverse.
L'affichage est un réceptacle passif des évènements de test.
Cela permet une adaptation facile de l'affichage
pour d'autres systèmes de test en dehors
des tests unitaires comme la surveillance
de serveurs par exemple.
Autre avantage, un test unitaire peut écrire
vers plus d'un affichage à la fois.
-
void paintFail(string $message)
peint un échec. Voir ci-dessous.
-
void paintPass(string \$message)
ne fait rien par défaut. C'est cette méthode
que nous allons modifier.
-
string getCss()
renvoie le style CSS - via une chaîne - pour
la méthode d'entête de la page.
Des styles complémentaires peuvent être ajoutés ici.
-
array getTestList()
est une méthode commode pour des sous-classes.
Elle liste l'emboîtement courant des tests
via une liste de noms de test.
Le premier, le test emboîté le plus profondément,
est le premier dans la liste et la méthode
du test courant sera la dernière.
Pour afficher les succès nous avons juste
besoin que la méthode paintPass()
se comporte comme paintFail().
Bien sûr nous n'allons pas modifier l'original.
Nous allons juste créer une sous-classe.
Premièrement nous allons créer un fichier
tests/show_passes.php dans notre projet de log
et y placer cette classe vide...
HtmlReporter();
}
}
?>
]]>
Une rapide mais attentive lecture du
code de SimpleTest
indique que l'implémentation de paintFail() ressemble à...
Fail: ";
$breadcrumb = $this->getTestList();
array_shift($breadcrumb);
print implode("->", $breadcrumb);
print "->$message
\n";
}
]]>
Essentiellement elle s'enchaîne à la version du parent,
que nous devons aussi réaliser pour garantir le ménage,
et ensuite imprime une trace calculée à partir de la liste
des tests courants. Par contre elle perd au passage
le nom du test du premier niveau.
Etant donné qu'il est identique pour chaque test,
ce serait un peu trop d'informations.
En la transposant dans notre nouvelle classe...
HtmlReporter();
}
function paintPass($message) {
parent::paintPass($message);
print "Pass: ";
$breadcrumb = $this->getTestList();
array_shift($breadcrumb);
print implode("->", $breadcrumb);
print "->$message
\n";
}
}
]]>
Pour l'instant tout roule.
Maintenant pour utiliser notre nouvelle classe,
nous allons modifier notre fichier tests/all_tests.php...
require_once('show_passes.php');
$test = &new GroupTest('All tests');
$test->addTestFile('log_test.php');
$test->addTestFile('clock_test.php');
$test->run(new ShowPasses());
?>
]]>
Nous pouvons le lancer pour voir le résultat de notre bricolage...
All tests
Pass: log_test.php->Log class test->testappendingtofile->Expecting [/Test line 1/] in [Test line 1]
Pass: log_test.php->Log class test->testappendingtofile->Expecting [/Test line 2/] in [Test line 2]
Pass: log_test.php->Log class test->testcreatingnewfile->Created before message
Pass: log_test.php->Log class test->testcreatingnewfile->File created
Pass: clock_test.php->Clock class test->testclockadvance->Advancement
Pass: clock_test.php->Clock class test->testclocktellstime->Now is the right time
3/3 test cases complete.
6 passes and 0 fails.
Joli, mais pas encore digne d'une médaille d'or.
Nous avons perdu un peu d'information au passage.
L'affichage du span.pass n'est pas stylé en CSS,
mais nous pouvons l'ajouter en modifiant une autre méthode...
HtmlReporter();
}
function paintPass($message) {
parent::paintPass($message);
print "Pass: ";
$breadcrumb = $this->getTestList();
array_shift($breadcrumb);
print implode("->", $breadcrumb);
print "->$message
\n";
}
protected function getCss() {
return parent::getCss() . ' .pass { color: green; }';
}
}
]]>
Si vous ajoutez le code au fur et à mesure,
vous verrez l'ajout du style dans le code source
du résultat via le navigateur. A l'oeil,
l'affichage devrait ressembler à...
All tests
Pass: log_test.php->Log class test->testappendingtofile->Expecting [/Test line 1/] in [Test line 1]
Pass: log_test.php->Log class test->testappendingtofile->Expecting [/Test line 2/] in [Test line 2]
Pass: log_test.php->Log class test->testcreatingnewfile->Created before message
Pass: log_test.php->Log class test->testcreatingnewfile->File created
Pass: clock_test.php->Clock class test->testclockadvance->Advancement
Pass: clock_test.php->Clock class test->testclocktellstime->Now is the right time
3/3 test cases complete.
6 passes and 0 fails.
Certains préfèrent voir les succès quand ils travaillent sur le code;
le sentiment de travail achevé est sympathique après tout.
Une fois que vous commencez à naviguer
de haut en bas pour trouver les erreurs, assez vite
vous en comprendrez le côté obscur.
Essayez les deux méthodes pour déterminer votre préférence.
Nous allons le laisser tel que pour l'étape qui approche :
les objets fantaisie.
Il s'agit du premier outil de test qui ajoute des tests additionnels :
il sera utile de voir ce qui se passe dans les coulisses.