Difference between revisions of "Tests"

From A-Eskwiki
Jump to: navigation, search
(Created page with "We hebben een systeem voor testing zelf gebouwd omdat alle standaard PHP-oplossingen niet bepaald gebruiksvriendelijk zijn. Tests worden uitgevoerd op de vm-www-debug, dus ze...")
 
Line 4: Line 4:
  
 
Als je code hebt geschreven, is het de bedoeling dat je test dat er niets stukging. Dit doe je met <code>./manage test</code> in je <code>wwwdebug/www</code>-map.
 
Als je code hebt geschreven, is het de bedoeling dat je test dat er niets stukging. Dit doe je met <code>./manage test</code> in je <code>wwwdebug/www</code>-map.
 +
 +
Ook kun je naar <code>https://$bla-debug.a-eskwadraat.nl/Service/Intern/Test/</code> gaan om een mooie grafische webinterface te zien.
  
 
== Om tests te maken ==
 
== Om tests te maken ==
  
Maak in <code>scripts/test</code> een php-bestand waarvan de naam begint met <code>test</code>, zoals bijvoorbeeld <code>test_periodes.php</code>. Stop hier functies in die code executeren (bijvoorbeeld <code>function test_voorbeeld() { ... }</code>, en een statement daaronder <code>new FunctieTest('test_voorbeeld');</code>. Een test telt als gefaald dan en slechts dan als er een error / exception is gebeurd. (Overigens telt die()/exit() ook als error, want dat wil je ook gewoon niet gebruiken ).
+
Maak in <code>scripts/test</code> een php-bestand waarvan de naam begint met <code>test</code>, zoals bijvoorbeeld <code>test_periodes.php</code>. <!-- Dit is uitgecomment in de veronderstelling dat https://git.a-eskwadraat.nl/webcie/website/pulls/24 gemerged wordt: Stop hier functies in die code executeren (bijvoorbeeld <code>function test_voorbeeld() { ... }</code>, en een statement daaronder <code>new FunctieTest('test_voorbeeld');</code>. -->
 +
Een simpele test kun je maken door een aanroep als <code>$runner->def('testvoorbeeld', function () { ... });</code>, waarin je dan de te teste aanroepen neerzet. Voor meer configuratie kun je een TestFactory gebruiken, zoals bijvoorbeeld: <code>$runner->nieuw('testvoorbeeld')->fixture(new VoorbeeldFixture())->uitgesteld()->doet(function() { ... })->registreer();</code>. (Zie die class voor alle opties.)
  
Geavanceerdere testopzet kun je doen met behulp van klasses als <code>UitgesteldeTest</code>, zie de inhoud van <code>scripts/test/init.php</code> voor allemaal (TODO: stop dit ook in Doxygen).
+
Een test telt als gefaald dan en slechts dan als er een error / exception is gebeurd. (Overigens telt die()/exit() ook als error, want dat wil je ook gewoon niet gebruiken ☺).
  
 
== Hoe de code werkt ==
 
== Hoe de code werkt ==

Revision as of 21:45, 25 February 2018

We hebben een systeem voor testing zelf gebouwd omdat alle standaard PHP-oplossingen niet bepaald gebruiksvriendelijk zijn. Tests worden uitgevoerd op de vm-www-debug, dus ze passen ook de debugdatabase aan.

Om tests te runnen

Als je code hebt geschreven, is het de bedoeling dat je test dat er niets stukging. Dit doe je met ./manage test in je wwwdebug/www-map.

Ook kun je naar https://$bla-debug.a-eskwadraat.nl/Service/Intern/Test/ gaan om een mooie grafische webinterface te zien.

Om tests te maken

Maak in scripts/test een php-bestand waarvan de naam begint met test, zoals bijvoorbeeld test_periodes.php. Een simpele test kun je maken door een aanroep als $runner->def('testvoorbeeld', function () { ... });, waarin je dan de te teste aanroepen neerzet. Voor meer configuratie kun je een TestFactory gebruiken, zoals bijvoorbeeld: $runner->nieuw('testvoorbeeld')->fixture(new VoorbeeldFixture())->uitgesteld()->doet(function() { ... })->registreer();. (Zie die class voor alle opties.)

Een test telt als gefaald dan en slechts dan als er een error / exception is gebeurd. (Overigens telt die()/exit() ook als error, want dat wil je ook gewoon niet gebruiken ☺).

Hoe de code werkt

Manage ssh't naar de vm-www-debug en roept scripts/runTests.php aan. Dit is een wrapper om scripts/test/init.php, die allerlei testinitialisatie doet, zoals WhosWho4 inladen en de testklassen. Vervolgens worden alle bestanden in script/test/ ingeladen die aan het bovengenoemde formaat voldoen, en dan een voor een de tests uitgevoerd. Met behulp van een hoop PHP-magie worden alle excepties en errors opgevangen door de TestRunner-klasse, en aan het einde van alle tests wordt een mooi overzicht van testresultaten gegenereerd.