PageRenderTime 49ms CodeModel.GetById 24ms RepoModel.GetById 0ms app.codeStats 0ms

/vendor/swiftmailer/test-suite/lib/simpletest/docs/source/fr/mock_objects_tutorial.xml

https://bitbucket.org/cryofrost/portal
XML | 374 lines | 364 code | 9 blank | 1 comment | 0 complexity | 0f60b4f7ee345224f7e14ad1d9065cd7 MD5 | raw file
Possible License(s): Apache-2.0, JSON, LGPL-2.1, LGPL-2.0, LGPL-3.0, BSD-3-Clause, BSD-2-Clause
  1. <?xml version="1.0" encoding="ISO-8859-1" ?>
  2. <!-- $Id: mock_objects_tutorial.xml 1701 2008-03-24 20:08:06Z pp11 $ -->
  3. <page title="Objets fantaisie" here="Utiliser des objets fantaisie">
  4. <synchronisation lang="en" version="1687" date="24/03/2008" maintainer="pp11" />
  5. <long_title>tutorial sur les tests unitaires en PHP - Utiliser les objets fantaisie en PHP</long_title>
  6. <content>
  7. <section name="remaniement" title="Remanier les tests à nouveau">
  8. <p>
  9. Avant d'ajouter de nouvelles fonctionnalités
  10. il y a du remaniement à faire.
  11. Nous allons effectuer des tests chronométrés
  12. et la classe <code>TimeTestCase</code> a définitivement
  13. besoin d'un fichier propre.
  14. Appelons le <em>tests/time_test_case.php</em>...
  15. <php><![CDATA[
  16. <strong><?php
  17. if (! defined('SIMPLE_TEST')) {
  18. define('SIMPLE_TEST', 'simpletest/');
  19. }
  20. require_once(SIMPLE_TEST . 'unit_tester.php');
  21. class TimeTestCase extends UnitTestCase {
  22. function TimeTestCase($test_name = '') {
  23. $this->UnitTestCase($test_name);
  24. }
  25. function assertSameTime($time1, $time2, $message = '') {
  26. if (! $message) {
  27. $message = "Time [$time1] should match time [$time2]";
  28. }
  29. $this->assertTrue(
  30. ($time1 == $time2) || ($time1 + 1 == $time2),
  31. $message);
  32. }
  33. }
  34. ?></strong>
  35. ]]></php>
  36. Nous pouvons lors utiliser <code>require()</code>
  37. pour incorporer ce fichier dans le script <em>all_tests.php</em>.
  38. </p>
  39. </section>
  40. <section name="timestamp" title="Ajouter un timestamp au Log">
  41. <p>
  42. Je ne sais pas trop quel devrait être
  43. le format du message de log pour le test alors
  44. pour vérifier le timestamp nous pourrions juste
  45. faire la plus simple des choses possibles,
  46. c'est à dire rechercher une suite de chiffres.
  47. <php><![CDATA[
  48. <?php
  49. require_once('../classes/log.php');<strong>
  50. require_once('../classes/clock.php');
  51. class TestOfLogging extends TimeTestCase {
  52. function TestOfLogging() {
  53. $this->TimeTestCase('Log class test');
  54. }</strong>
  55. function setUp() {
  56. @unlink('../temp/test.log');
  57. }
  58. function tearDown() {
  59. @unlink('../temp/test.log');
  60. }
  61. function getFileLine($filename, $index) {
  62. $messages = file($filename);
  63. return $messages[$index];
  64. }
  65. function testCreatingNewFile() {
  66. ...
  67. }
  68. function testAppendingToFile() {
  69. ...
  70. }<strong>
  71. function testTimestamps() {
  72. $log = new Log('../temp/test.log');
  73. $log->message('Test line');
  74. $this->assertTrue(
  75. preg_match('/(\d+)/', $this->getFileLine('../temp/test.log', 0), $matches),
  76. 'Found timestamp');
  77. $clock = new clock();
  78. $this->assertSameTime((integer)$matches[1], $clock->now(), 'Correct time');
  79. }</strong>
  80. }
  81. ?>
  82. ]]></php>
  83. Ce scénario de test crée un nouvel objet <code>Log</code>
  84. et écrit un message. Nous recherchons une suite de chiffres
  85. et nous la comparons à l'horloge présente en utilisant
  86. notre objet <code>Clock</code>. Bien sûr ça ne marche pas
  87. avant d'avoir écrit le code.
  88. <div class="demo">
  89. <h1>All tests</h1>
  90. <span class="pass">Pass</span>: log_test.php->Log class test->testappendingtofile->Expecting [/Test line 1/] in [Test line 1]<br />
  91. <span class="pass">Pass</span>: log_test.php->Log class test->testappendingtofile->Expecting [/Test line 2/] in [Test line 2]<br />
  92. <span class="pass">Pass</span>: log_test.php->Log class test->testcreatingnewfile->Created before message<br />
  93. <span class="pass">Pass</span>: log_test.php->Log class test->testcreatingnewfile->File created<br />
  94. <span class="fail">Fail</span>: log_test.php->Log class test->testtimestamps->Found timestamp<br />
  95. <br />
  96. <b>Notice</b>: Undefined offset: 1 in <b>/home/marcus/projects/lastcraft/tutorial_tests/tests/log_test.php</b> on line <b>44</b><br />
  97. <span class="fail">Fail</span>: log_test.php->Log class test->testtimestamps->Correct time<br />
  98. <span class="pass">Pass</span>: clock_test.php->Clock class test->testclockadvance->Advancement<br />
  99. <span class="pass">Pass</span>: clock_test.php->Clock class test->testclocktellstime->Now is the right time<br />
  100. <div style="padding: 8px; margin-top: 1em; background-color: red; color: white;">3/3 test cases complete.
  101. <strong>6</strong> passes and <strong>2</strong> fails.</div>
  102. </div>
  103. Cette suite de tests montre encore les succès
  104. de notre modification précédente.
  105. </p>
  106. <p>
  107. Nous pouvons faire passer les tests en ajoutant
  108. simplement un timestamp à l'écriture dans le fichier.
  109. Oui, bien sûr, tout ceci est assez trivial et d'habitude
  110. je ne le testerais pas aussi fanatiquement,
  111. mais ça va illustrer un problème plus général...
  112. Le fichier <em>log.php</em> devient...
  113. <php><![CDATA[
  114. <?php<strong>
  115. require_once('../classes/clock.php');</strong>
  116. class Log {
  117. var $_file_path;
  118. function Log($file_path) {
  119. $this->_file_path = $file_path;
  120. }
  121. function message($message) {<strong>
  122. $clock = new Clock();</strong>
  123. $file = fopen($this->_file_path, 'a');<strong>
  124. fwrite($file, "[" . $clock->now() . "] $message\n");</strong>
  125. fclose($file);
  126. }
  127. }
  128. ?>
  129. ]]></php>
  130. Les tests devraient passer.
  131. </p>
  132. <p>
  133. Par contre notre nouveau test est plein de problèmes.
  134. Qu'est-ce qui se passe si notre format de temps change ?
  135. Les choses vont devenir largement plus compliquées
  136. si ça venait à se produire.
  137. Cela veut aussi dire que n'importe quel changement
  138. du format de notre classe horloge causera aussi
  139. un échec dans les tests de log.
  140. Bilan : nos tests de log sont tout mélangés
  141. avec les test d'horloge et par la même très fragiles.
  142. Tester à la fois des facettes de l'horloge
  143. et d'autres du log manque de cohésion,
  144. ou de focalisation étanche si vous préférez.
  145. Nos problèmes sont causés en partie parce que
  146. le résultat de l'horloge est imprévisible alors que
  147. l'unique chose à tester est la présence
  148. du résultat de <code>Clock::now()</code>.
  149. Peu importe le contenu de l'appel de cette méthode.
  150. </p>
  151. <p>
  152. Pouvons-nous rendre cet appel prévisible ?
  153. Oui si nous pouvons forcer le loggueur à utiliser
  154. une version factice de l'horloge lors du test.
  155. Cette classe d'horloge factice devrait se comporter
  156. exactement comme la classe <code>Clock</code>
  157. à part une sortie fixée dans la méthode <code>now()</code>.
  158. Et au passage, ça nous affranchirait même
  159. de la classe <code>TimeTestCase</code> !
  160. </p>
  161. <p>
  162. Nous pourrions écrire une telle classe assez
  163. facilement même s'il s'agit d'un boulot plutôt fastidieux.
  164. Nous devons juste créer une autre classe
  165. d'horloge avec la même interface sauf que
  166. la méthode <code>now()</code> retourne une valeur modifiable
  167. via une autre méthode d'initialisation.
  168. C'est plutôt pas mal de travail pour un test plutôt mineur.
  169. </p>
  170. <p>
  171. Sauf que ça se fait sans aucun effort.
  172. </p>
  173. </section>
  174. <section name="fantaisie" title="Une horloge fantaisie">
  175. <p>
  176. Pour atteindre le nirvana de l'horloge instantané
  177. pour test nous n'avons besoin que de trois lignes de code supplémentaires...
  178. <php><![CDATA[
  179. require_once('simpletest/mock_objects.php');
  180. ]]></php>
  181. Cette instruction inclut le code de générateur
  182. d'objet fantaisie. Le plus simple reste de le mettre
  183. dans le script <em>all_tests.php</em> étant donné
  184. qu'il est utilisé assez fréquemment.
  185. <php><![CDATA[
  186. Mock::generate('Clock');
  187. ]]></php>
  188. C'est la ligne qui fait le travail.
  189. Le générateur de code scanne la classe,
  190. en extrait toutes ses méthodes, crée le code
  191. pour générer une classe avec une interface identique,
  192. mais en ajoutant le nom &quot;Mock&quot;
  193. et ensuite <code>eval()</code> le nouveau code pour créer la nouvelle classe.
  194. <php><![CDATA[
  195. $clock = &new MockClock($this);
  196. ]]></php>
  197. Cette ligne peut être ajoutée dans n'importe
  198. quelle méthode de test qui nous intéresserait.
  199. Elle crée l'horloge fantaisie prête à recevoir nos instructions.
  200. </p>
  201. <p>
  202. Notre scénario de test en est à ses premiers pas
  203. vers un nettoyage radical...
  204. <php><![CDATA[
  205. <?php
  206. require_once('../classes/log.php');
  207. require_once('../classes/clock.php');<strong>
  208. Mock::generate('Clock');
  209. class TestOfLogging extends UnitTestCase {
  210. function TestOfLogging() {
  211. $this->UnitTestCase('Log class test');
  212. }</strong>
  213. function setUp() {
  214. @unlink('../temp/test.log');
  215. }
  216. function tearDown() {
  217. @unlink('../temp/test.log');
  218. }
  219. function getFileLine($filename, $index) {
  220. $messages = file($filename);
  221. return $messages[$index];
  222. }
  223. function testCreatingNewFile() {
  224. ...
  225. }
  226. function testAppendingToFile() {
  227. ...
  228. }
  229. function testTimestamps() {<strong>
  230. $clock = &new MockClock($this);
  231. $clock->setReturnValue('now', 'Timestamp');
  232. $log = new Log('../temp/test.log');
  233. $log->message('Test line', &$clock);
  234. $this->assertWantedPattern(
  235. '/Timestamp/',
  236. $this->getFileLine('../temp/test.log', 0),
  237. 'Found timestamp');</strong>
  238. }
  239. }
  240. ?>
  241. ]]></php>
  242. Cette méthode de test crée un objet <code>MockClock</code>
  243. puis définit la valeur retourné par la méthode
  244. <code>now()</code> par la chaîne &quot;Timestamp&quot;.
  245. A chaque fois que nous appelons <code>$clock->now()</code>,
  246. elle retournera cette même chaîne.
  247. Ça devrait être quelque chose de facilement repérable.
  248. </p>
  249. <p>
  250. Ensuite nous créons notre loggueur et envoyons un message.
  251. Nous incluons dans l'appel <code>message()</code>
  252. l'horloge que nous souhaitons utiliser.
  253. Ça veut dire que nous aurons à ajouter un paramètre
  254. optionnel à la classe de log pour rendre ce test possible...
  255. <php><![CDATA[
  256. class Log {
  257. var $_file_path;
  258. function Log($file_path) {
  259. $this->_file_path = $file_path;
  260. }
  261. function message($message, <strong>$clock = false</strong>) {<strong>
  262. if (!is_object($clock)) {
  263. $clock = new Clock();
  264. }</strong>
  265. $file = fopen($this->_file_path, 'a');
  266. fwrite($file, "[" . $clock->now() . "] $message\n");
  267. fclose($file);
  268. }
  269. }
  270. ]]></php>
  271. Maintenant tous les tests passent et ils ne testent
  272. que le code du loggueur. Nous pouvons à nouveau respirer.
  273. </p>
  274. <p>
  275. Est-ce que ce paramètre supplémentaire dans la classe <code>Log</code>
  276. vous gêne ? Nous n'avons changé l'interface que
  277. pour faciliter les tests après tout.
  278. Les interfaces ne sont-elles pas la chose la plus importante ?
  279. Avons nous souillé notre classe avec du code de test ?
  280. </p>
  281. <p>
  282. Peut-être, mais réfléchissez à ce qui suit.
  283. A la prochaine occasion,
  284. regardez une carte avec des circuits imprimés,
  285. peut-être la carte mère de l'ordinateur que
  286. ous regardez actuellement. Sur la plupart d'entre elles
  287. vous trouverez un trou bizarre et vide
  288. ou alors un point de soudure sans rien de fixé
  289. ou même une épingle ou une prise sans aucune fonction évidente.
  290. Peut-être certains sont là en prévision d'une expansion
  291. ou d'une variation future, mais la plupart n'y sont que pour les tests.
  292. </p>
  293. <p>
  294. Pensez-y. Les usines qui fabriquent ces cartes imprimées
  295. par centaine de milliers gaspillent des matières premières
  296. sur des pièces qui n'ajoutent rien à la fonction finale.
  297. Si les ingénieurs matériel peuvent faire quelques sacrifices
  298. à l'élégance, je suis sûr que nous pouvons aussi le faire.
  299. Notre sacrifice ne gaspille pas de matériel après tout.
  300. </p>
  301. <p>
  302. Ça vous gêne encore ? En fait moi aussi, mais pas tellement ici.
  303. La priorité numéro 1 reste du code qui marche,
  304. pas un prix pour minimalisme.
  305. Si ça vous gêne vraiment alors déplacez la création
  306. de l'horloge dans une autre méthode mère protégée.
  307. Ensuite sous classez l'horloge pour le test
  308. et écrasez la méthode mère avec une qui renvoie le leurre.
  309. Vos tests sont bancals mais votre interface est intacte.
  310. </p>
  311. <p>
  312. Une nouvelle fois je vous laisse la décision finale.
  313. </p>
  314. </section>
  315. </content>
  316. <internal>
  317. <link>
  318. <a href="#remaniement">Remanier les tests</a>
  319. dans le but de réutiliser notre nouveau test de temps.
  320. </link>
  321. <link>
  322. Ajouter des <a href="#timestamp">timestamps de Log</a>.
  323. </link>
  324. <link>
  325. <a href="#fantaisie">Créer une horloge fantaisie</a>
  326. pour rendre les tests cohésifs.
  327. </link>
  328. </internal>
  329. <external>
  330. <link>
  331. La section précédente :
  332. <a href="first_test_tutorial.php">tutorial de test unitaire</a>.
  333. </link>
  334. <link>
  335. La section suivante :
  336. <a href="boundary_classes_tutorial.php">les frontières de l'application</a>.
  337. </link>
  338. <link>
  339. Vous aurez besoin du
  340. <a href="simple_test.php">framework de test SimpleTest</a>
  341. pour essayer ces exemples.
  342. </link>
  343. <link>
  344. Documents sur les <a href="http://www.mockobjects.com/">objets fantaisie</a>.
  345. </link>
  346. </external>
  347. <meta>
  348. <keywords>
  349. développement logiciel,
  350. programmation php,
  351. outils de développement logiciel,
  352. tutoriel php,
  353. scripts php gratuits,
  354. architecture,
  355. ressources php,
  356. objet fantaisie,
  357. junit,
  358. phpunit,
  359. simpletest,
  360. test php,
  361. outil de test unitaire,
  362. suite de test php
  363. </keywords>
  364. </meta>
  365. </page>