diff options
Diffstat (limited to 'vendors/simpletest/docs/fr/index.html')
| -rw-r--r-- | vendors/simpletest/docs/fr/index.html | 572 |
1 files changed, 572 insertions, 0 deletions
diff --git a/vendors/simpletest/docs/fr/index.html b/vendors/simpletest/docs/fr/index.html new file mode 100644 index 000000000..a13cb5787 --- /dev/null +++ b/vendors/simpletest/docs/fr/index.html @@ -0,0 +1,572 @@ +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title> + Prise en main rapide de SimpleTest pour PHP - + Tests unitaire et objets fantaisie pour PHP + </title> +<link rel="stylesheet" type="text/css" href="docs.css" title="Styles"> +</head> +<body> +<div class="menu_back"><div class="menu"> +<a href="index.html">SimpleTest</a> + | + <a href="overview.html">Overview</a> + | + <a href="unit_test_documentation.html">Unit tester</a> + | + <a href="group_test_documentation.html">Group tests</a> + | + <a href="mock_objects_documentation.html">Mock objects</a> + | + <a href="partial_mocks_documentation.html">Partial mocks</a> + | + <a href="reporter_documentation.html">Reporting</a> + | + <a href="expectation_documentation.html">Expectations</a> + | + <a href="web_tester_documentation.html">Web tester</a> + | + <a href="form_testing_documentation.html">Testing forms</a> + | + <a href="authentication_documentation.html">Authentication</a> + | + <a href="browser_documentation.html">Scriptable browser</a> +</div></div> +<h1>Prise en main rapide de SimpleTest</h1> + This page... + <ul> +<li> + <a href="#unit">Utiliser le testeur rapidement</a> + avec un exemple. + </li> +<li> + <a href="#group">Groupes de tests</a> + pour tester en un seul clic. + </li> +<li> + <a href="#mock">Utiliser les objets fantaisie</a> + pour faciliter les tests et gagner en contrôle. + </li> +<li> + <a href="#web">Tester des pages web</a> + au niveau de l'HTML. + </li> +</ul> +<div class="content"> + + <p> + Le présent article présuppose que vous soyez familier avec + le concept de tests unitaires ainsi que celui de développement + web avec le langage PHP. Il s'agit d'un guide pour le nouvel + et impatient utilisateur de + <a href="https://sourceforge.net/project/showfiles.php?group_id=76550">SimpleTest</a>. + Pour une documentation plus complète, particulièrement si + vous découvrez les tests unitaires, consultez la + <a href="http://www.lastcraft.com/unit_test_documentation.php">documentation + en cours</a>, et pour des exemples de scénarios de test, + consultez le + <a href="http://www.lastcraft.com/first_test_tutorial.php">tutorial + sur les tests unitaires</a>. + </p> + + <p><a class="target" name="unit"><h2>Utiliser le testeur rapidement</h2></a></p> + <p> + Parmi les outils de test pour logiciel, le testeur unitaire + est le plus proche du développeur. Dans un contexte de + développement agile, le code de test se place juste à côté + du code source étant donné que tous les deux sont écrits + simultanément. Dans ce contexte, SimpleTest aspire à être + une solution complète de test pour un développeur PHP et + s'appelle "Simple" parce qu'elle devrait être simple à + utiliser et à étendre. Ce nom n'était pas vraiment un bon + choix. Non seulement cette solution inclut toutes les + fonctions classiques qu'on est en droit d'attendre de la + part des portages de <a href="http://www.junit.org/">JUnit</a> et des <a href="http://sourceforge.net/projects/phpunit/">PHPUnit</a>, + mais elle inclut aussi les <a href="http://www.mockobjects.com/">objets fantaisie ou + "mock objects"</a>. + </p> + <p> + Ce qui rend cet outil immédiatement utile pour un développeur PHP, + c'est son navigateur web interne. + Il permet des tests qui parcourent des sites web, remplissent + des formulaires et testent le contenu des pages. + Etre capable d'écrire ces tests en PHP veut dire qu'il devient + facile d'écrire des tests de recette (ou d'intégration). + Un exemple serait de confirmer qu'un utilisateur a bien été ajouté + dans une base de données après s'être enregistré sur une site web. + </p> + <p> + La démonstration la plus rapide : l'exemple + </p> + <p> + Supposons que nous sommes en train de tester une simple + classe de log dans un fichier : elle s'appelle + <span class="new_code">Log</span> dans <em>classes/Log.php</em>. Commençons + par créer un script de test, appelé + <em>tests/log_test.php</em>. Son contenu est le suivant... +<pre> +<?php +<strong>require_once('simpletest/autorun.php');</strong> +require_once('../classes/log.php'); + +class TestOfLogging extends <strong>UnitTestCase</strong> { +} +?> +</pre> + Ici le répertoire <em>simpletest</em> est soit dans le + dossier courant, soit dans les dossiers pour fichiers + inclus. Vous auriez à éditer ces arborescences suivant + l'endroit où vous avez installé SimpleTest. + Le fichier "autorun.php" fait plus que juste inclure + les éléments de SimpleTest : il lance aussi les tests pour nous. + </p> + <p> + <span class="new_code">TestOfLogging</span> est notre premier scénario de test + et il est pour l'instant vide. + Chaque scénario de test est une classe qui étend une des classes + de base de SimpleTest. Nous pouvons avoir autant de classes de ce type + que nous voulons. + </p> + <p> + Avec ces trois lignes d'échafaudage + l'inclusion de notre classe <span class="new_code">Log</span>, nous avons une suite + de tests. Mais pas encore de test ! + </p> + <p> + Pour notre premier test, supposons que la classe <span class="new_code">Log</span> + prenne le nom du fichier à écrire au sein du constructeur, + et que nous avons un répertoire temporaire dans lequel placer + ce fichier. +<pre> +<?php +require_once('simpletest/autorun.php'); +require_once('../classes/log.php'); + +class TestOfLogging extends UnitTestCase { + function <strong>testLogCreatesNewFileOnFirstMessage()</strong> { + @unlink('/temp/test.log'); + $log = new Log('/temp/test.log'); + <strong>$this->assertFalse(file_exists('/temp/test.log'));</strong> + $log->message('Should write this to a file'); + <strong>$this->assertTrue(file_exists('/temp/test.log'));</strong> + } +} +?> +</pre> + Au lancement du scénario de test, toutes les méthodes qui + commencent avec la chaîne <span class="new_code">test</span> sont + identifiées puis exécutées. + Si la méthode commence par <span class="new_code">test</span>, c'est un test. + Remarquez bien le nom très long de notre exemple : + <span class="new_code">testLogCreatesNewFileOnFirstMessage()</span>. + C'est bel et bien délibéré : ce style est considéré désirable + et il rend la sortie du test plus lisible. + </p> + <p> + D'ordinaire nous avons bien plusieurs méthodes de tests. + Mais ce sera pour plus tard. + </p> + <p> + Les assertions dans les + méthodes de test envoient des messages vers le framework de + test qui affiche immédiatement le résultat. Cette réponse + immédiate est importante, non seulement lors d'un crash + causé par le code, mais aussi de manière à rapprocher + l'affichage de l'erreur au plus près du scénario de test + concerné via un appel à <span class="new_code">print</span>code>. + </p> + <p> + Pour voir ces résultats lançons effectivement les tests. + Aucun autre code n'est nécessaire, il suffit d'ouvrir + la page dans un navigateur. + </p> + <p> + En cas échec, l'affichage ressemble à... + <div class="demo"> + <h1>TestOfLogging</h1> + <span class="fail">Fail</span>: testcreatingnewfile->True assertion failed.<br> + <div style="padding: 8px; margin-top: 1em; background-color: red; color: white;">1/1 test cases complete. + <strong>1</strong> passes and <strong>1</strong> fails.</div> + </div> + ...et si ça passe, on obtient... + <div class="demo"> + <h1>TestOfLogging</h1> + <div style="padding: 8px; margin-top: 1em; background-color: green; color: white;">1/1 test cases complete. + <strong>2</strong> passes and <strong>0</strong> fails.</div> + </div> + Et si vous obtenez ça... + <div class="demo"> + <b>Fatal error</b>: Failed opening required '../classes/log.php' (include_path='') in <b>/home/marcus/projects/lastcraft/tutorial_tests/Log/tests/log_test.php</b> on line <b>7</b> + </div> + c'est qu'il vous manque le fichier <em>classes/Log.php</em> + qui pourrait ressembler à : +<pre> +<?php<strong> +class Log { + function Log($file_path) { + } + + function message() { + } +}</strong> +?> +</pre> + C'est largement plus sympathique d'écrire le code après le test. + Plus que sympatique même - cette technique s'appelle + "Développement Piloté par les Tests" ou + "Test Driven Development" en anglais. + </p> + <p> + Pour plus de renseignements sur le testeur, voyez la + <a href="unit_test_documentation.html">documentation pour les tests de régression</a>. + </p> + + <p><a class="target" name="group"><h2>Construire des groupes de tests</h2></a></p> + <p> + Il est peu probable que dans une véritable application on + ait uniquement besoin de passer un seul scénario de test. + Cela veut dire que nous avons besoin de grouper les + scénarios dans un script de test qui peut, si nécessaire, + lancer tous les tests de l'application. + </p> + <p> + Notre première étape est de créer un nouveau fichier appelé + <em>tests/all_tests.php</em> et d'y inclure le code suivant... +<pre> +<?php +<strong>require_once('simpletest/autorun.php');</strong> + +class AllTests extends <strong>TestSuite</strong> { + function AllTests() { + $this->TestSuite(<strong>'All tests'</strong>); + <strong>$this->addFile('log_test.php');</strong> + } +} +?> +</pre> + L'inclusion de "autorun" permettra à notre future suite + de tests d'être lancée juste en invoquant ce script. + </p> + <p> + La sous-classe <span class="new_code">TestSuite</span> doit chaîner + son constructeur. Cette limitation sera supprimée dans + les versions à venir. + </p> + <p> + The method <span class="new_code">TestSuite::addFile()</span> + will include the test case file and read any new classes + that are descended from <span class="new_code">SimpleTestCase</span>. + + Cette méthode <span class="new_code">TestSuite::addTestFile()</span> va + inclure le fichier de scénarios de test et lire parmi + toutes les nouvelles classes créées celles qui sont issues + de <span class="new_code">SimpleTestCase</span>. + <span class="new_code">UnitTestCase</span> est juste un exemple de classe dérivée + depuis <span class="new_code">SimpleTestCase</span> et vous pouvez créer les vôtres. + <span class="new_code">TestSuite::addFile()</span> peut aussi inclure d'autres suites. + </p> + <p> + La classe ne sera pas encore instanciée. + Quand la suite de tests est lancée, elle construira chaque instance + une fois le test atteint, et le détuira juste ensuite. + Cela veut dire que le constructeur n'est lancé qu'une fois avant + chaque initialisation de ce scénario de test et que le destructeur + est lui aussi lancé avant que le test suivant ne commence. + </p> + <p> + Il est commun de grouper des scénarios de test dans des super-classes + qui ne sont pas sensées être lancées, mais qui deviennent une classe de base + pour d'autres tests. + Pour que "autorun" fonctionne proprement les fichiers + des scénarios de test ne devraient pas lancer aveuglement + d'autres extensions de scénarios de test qui ne lanceraient pas + effectivement des tests. + Cela pourrait aboutir à un mauvais comptages des scénarios de test + pendant la procédure. + Pas vraiement un problème majeure, mais pour éviter cet inconvénient + il suffit de marquer vos classes de base comme <span class="new_code">abstract</span>. + SimpleTest ne lance pas les classes abstraites. Et si vous utilisez encore + PHP4 alors une directive <span class="new_code">SimpleTestOptions::ignore()</span> + dans votre fichier de scénario de test aura le même effet. + </p> + <p> + Par ailleurs, le fichier avec le scénario de test ne devrait pas + avoir été inclus ailleurs. Sinon aucun scénario de test + ne sera inclus à ce groupe. + Ceci pourrait se transformer en un problème plus grave : + si des fichiers ont déjà été inclus par PHP alors la méthode + <span class="new_code">TestSuite::addFile()</span> ne les détectera pas. + </p> + <p> + Pour afficher les résultats, il est seulement nécessaire + d'invoquer <em>tests/all_tests.php</em> à partir du serveur + web. + </p> + <p> + Pour plus de renseignements des groupes de tests, voyez le + <a href="group_test_documentation.html">documentation sur le groupement des tests</a>. + </p> + + <p><a class="target" name="mock"><h2>Utiliser les objets fantaisie</h2></a></p> + <p> + Avançons un peu plus dans le futur. + </p> + <p> + Supposons que notre class logging soit testée et terminée. + Supposons aussi que nous testons une autre classe qui ait + besoin d'écrire des messages de log, disons + <span class="new_code">SessionPool</span>. Nous voulons tester une méthode + qui ressemblera probablement à quelque chose comme... +<pre><strong> +class SessionPool { + ... + function logIn($username) { + ... + $this->_log->message('User $username logged in.'); + ... + } + ... +} +</strong> +</pre> + Avec le concept de "réutilisation de code" comme fil + conducteur, nous utilisons notre class <span class="new_code">Log</span>. Un + scénario de test classique ressemblera peut-être à... +<pre> +<?php +require_once('simpletest/autorun.php'); +require_once('../classes/log.php'); +<strong>require_once('../classes/session_pool.php');</strong> + +class <strong>TestOfSessionLogging</strong> extends UnitTestCase { + + function setUp() { + <strong>@unlink('/temp/test.log');</strong> + } + + function tearDown() { + <strong>@unlink('/temp/test.log');</strong> + } + + function testLoggingInIsLogged() { + <strong>$log = new Log('/temp/test.log'); + $session_pool = &new SessionPool($log); + $session_pool->logIn('fred');</strong> + $messages = file('/temp/test.log'); + $this->assertEqual($messages[0], "User fred logged in.<strong>\n</strong>"); + } +} +?> +</pre> + Nous expliquerons les méthodes <span class="new_code">setUp()</span> + et <span class="new_code">tearDown()</span> plus tard. + </p> + <p> + Le design de ce scénario de test n'est pas complètement + mauvais, mais on peut l'améliorer. Nous passons du temps à + tripoter les fichiers de log qui ne font pas partie de + notre test. + Pire, nous avons créé des liens de proximité + entre la classe <span class="new_code">Log</span> et ce test. Que se + passerait-il si nous n'utilisions plus de fichiers, mais la + bibliothèque <em>syslog</em> à la place ? + + Cela veut dire que notre test <span class="new_code">TestOfSessionLogging</span> + enverra un échec alors même qu'il ne teste pas Logging. + </p> + <p> + Il est aussi fragile sur des petites retouches. Avez-vous + remarqué le retour chariot supplémentaire à la fin du + message ? A-t-il été ajouté par le loggueur ? Et si il + ajoutait aussi un timestamp ou d'autres données ? + </p> + <p> + L'unique partie à tester réellement est l'envoi d'un + message précis au loggueur. + Nous pouvons réduire le couplage en + créant une fausse classe de logging : elle ne fait + qu'enregistrer le message pour le test, mais ne produit + aucun résultat. Sauf qu'elle doit ressembler exactement à + l'original. + </p> + <p> + Si l'objet fantaisie n'écrit pas dans un fichier alors nous + nous épargnons la suppression du fichier avant et après le + test. Nous pourrions même nous épargner quelques lignes de + code supplémentaires si l'objet fantaisie pouvait exécuter + l'assertion. + <p> + </p> + Trop beau pour être vrai ? Pas vraiement on peut créer un tel + objet très facilement... +<pre> +<?php +require_once('simpletest/autorun.php'); +require_once('../classes/log.php'); +require_once('../classes/session_pool.php'); + +<strong>Mock::generate('Log');</strong> + +class TestOfSessionLogging extends UnitTestCase { + + function testLoggingInIsLogged() {<strong> + $log = &new MockLog(); + $log->expectOnce('message', array('User fred logged in.'));</strong> + $session_pool = &new SessionPool(<strong>$log</strong>); + $session_pool->logIn('fred'); + } +} +?> +</pre> + L'appel <span class="new_code">Mock::generate()</span> a généré + une nouvelle classe appelé <span class="new_code">MockLog</span>. + Cela ressemble à un clone identique, sauf que nous pouvons + y adjoindre du code de test. + C'est ce que fait <span class="new_code">expectOnce()</span>. + Cela dit que si <span class="new_code">message()</span> m'est appelé, + il a intérêt à l'être avec le paramètre + "User fred logged in.". + </p> + <p> + L'appel <span class="new_code">tally()</span> est nécessaire pour annoncer à + l'objet fantaisie qu'il n'y aura plus d'appels ultérieurs. + Sans ça l'objet fantaisie pourrait attendre pendant une + éternité l'appel de la méthode sans jamais prévenir le + scénario de test. Les autres tests sont déclenchés + automatiquement quand l'appel à <span class="new_code">message()</span> est + invoqué sur l'objet <span class="new_code">MockLog</span> par le code + <span class="new_code">SessionPool::logIn()</span>. + L'appel <span class="new_code">mock</span> va déclencher une comparaison des + paramètres et ensuite envoyer le message "pass" ou "fail" + au test pour l'affichage. Des jokers peuvent être inclus + pour ne pas avoir à tester tous les paramètres d'un appel + alors que vous ne souhaitez qu'en tester un. + </p> + <p> + Les objets fantaisie dans la suite SimpleTest peuvent avoir + un ensemble de valeurs de sortie arbitraires, des séquences + de sorties, des valeurs de sortie sélectionnées à partir + des arguments d'entrée, des séquences de paramètres + attendus et des limites sur le nombre de fois qu'une + méthode peut être invoquée. + </p> + <p> + Pour que ce test fonctionne la librairie avec les objets + fantaisie doit être incluse dans la suite de tests, par + exemple dans <em>all_tests.php</em>. + </p> + <p> + Pour plus de renseignements sur les objets fantaisie, voyez le + <a href="mock_objects_documentation.html">documentation sur les objets fantaisie</a>. + </p> + + <p><a class="target" name="web"><h2>Tester une page web</h2></a></p> + <p> + Une des exigences des sites web, c'est qu'ils produisent + des pages web. Si vous construisez un projet de A à Z et + que vous voulez intégrer des tests au fur et à mesure alors + vous voulez un outil qui puisse effectuer une navigation + automatique et en examiner le résultat. C'est le boulot + d'un testeur web. + </p> + <p> + Effectuer un test web via SimpleTest reste assez primitif : + il n'y a pas de javascript par exemple. + La plupart des autres opérations d'un navigateur sont simulées. + </p> + <p> + Pour vous donner une idée, voici un exemple assez trivial : + aller chercher une page web, + à partir de là naviguer vers la page "about" + et finalement tester un contenu déterminé par le client. +<pre> +<?php +require_once('simpletest/autorun.php'); +<strong>require_once('simpletest/web_tester.php');</strong> + +class TestOfAbout extends <strong>WebTestCase</strong> { + function testOurAboutPageGivesFreeReignToOurEgo() { + <strong>$this->get('http://test-server/index.php'); + $this->click('About'); + $this->assertTitle('About why we are so great'); + $this->assertText('We are really great');</strong> + } +} +?> +</pre> + Avec ce code comme test de recette, vous pouvez vous + assurer que le contenu corresponde toujours aux + spécifications à la fois des développeurs et des autres + parties prenantes au projet. + </p> + <p> + Vous pouvez aussi naviguer à travers des formulaires... +<pre> +<?php +require_once('simpletest/autorun.php'); +require_once('simpletest/web_tester.php'); + +class TestOfRankings extends WebTestCase { + function testWeAreTopOfGoogle() { + $this->get('http://google.com/'); + $this->setField('q', 'simpletest'); + $this->click("I'm Feeling Lucky"); + $this->assertTitle('SimpleTest - Unit Testing for PHP'); + } +} +?> +</pre> + ...même si cela pourrait constituer une violation + des documents juridiques de Google(tm). + </p> + <p> + Pour plus de renseignements sur comment tester une page web, voyez la + <a href="web_tester_documentation.html">documentation sur tester des scripts web</a>. + </p> + <p> + <a href="http://sourceforge.net/projects/simpletest/"><img src="http://sourceforge.net/sflogo.php?group_id=76550&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo"></a> + </p> + + </div> + References and related information... + <ul> +<li> + <a href="https://sourceforge.net/project/showfiles.php?group_id=76550&release_id=153280">Télécharger PHP Simple Test</a> + depuis <a href="http://sourceforge.net/projects/simpletest/">SourceForge</a>. + </li> +<li> + L'<a href="http://simpletest.org/api/">API de SimpleTest pour développeur</a> + donne tous les détails sur les classes et assertions existantes. + </li> +</ul> +<div class="menu_back"><div class="menu"> +<a href="index.html">SimpleTest</a> + | + <a href="overview.html">Overview</a> + | + <a href="unit_test_documentation.html">Unit tester</a> + | + <a href="group_test_documentation.html">Group tests</a> + | + <a href="mock_objects_documentation.html">Mock objects</a> + | + <a href="partial_mocks_documentation.html">Partial mocks</a> + | + <a href="reporter_documentation.html">Reporting</a> + | + <a href="expectation_documentation.html">Expectations</a> + | + <a href="web_tester_documentation.html">Web tester</a> + | + <a href="form_testing_documentation.html">Testing forms</a> + | + <a href="authentication_documentation.html">Authentication</a> + | + <a href="browser_documentation.html">Scriptable browser</a> +</div></div> +<div class="copyright"> + Copyright<br>Marcus Baker 2006 + </div> +</body> +</html> |