Documentation sur le groupement des tests

Grouper des tests

Pour lancer les scénarios de tests en tant que groupe, ils devraient être placés dans des fichiers sans le code du lanceur...

<?php
    require_once('../classes/io.php');

    class FileTester extends UnitTestCase {
        ...
    }

    class SocketTester extends UnitTestCase {
        ...
    }
?>

Si vous avez étendu l'un ou l'autre des scénarios de test, vous pouvez aussi les inclure.

<?php
    require_once('../classes/io.php');

    class MyFileTestCase extends UnitTestCase {
        ...
    }
    SimpleTestOptions::ignore('MyFileTestCase');

    class FileTester extends MyFileTestCase {
        ...
    }

    class SocketTester extends UnitTestCase {
        ...
    }
?>

Ensuite nous créons un fichier de groupe de tests, disons group_test.php. Vous penserez à un nom plus convaincant, j'en suis sûr. Nous lui ajoutons le fichier de test avec une méthode sans risque...

<?php
    require_once('simpletest/unit_tester.php');
    require_once('simpletest/reporter.php');
    require_once('file_test.php');

    $test = &new GroupTest('All file tests');
    $test->addTestCase(new FileTestCase());
    $test->run(new HtmlReporter());
?>

<?php
    require_once('simpletest/unit_tester.php');
    require_once('simpletest/reporter.php');
    require_once('file_test.php');

    $test = &new GroupTest('All file tests');
    $test->addTestClass('FileTestCase');
    $test->run(new HtmlReporter());
?>

<?php
    require_once('simpletest/unit_tester.php');
    require_once('simpletest/reporter.php');

    $test = &new GroupTest('All file tests');
    $test->addTestFile('file_test.php');
    $test->run(new HtmlReporter());
?>

Il y a deux choses qui peuvent planter et qui demandent un minimum d'attention...

1. Le fichier peut déjà avoir été analysé par PHP et dans ce cas aucune classe ne sera ajoutée. Pensez à bien vérifier que les scénarios de test ne sont inclus que dans ce fichier et dans aucun autre (Note : avec la nouvelle fonctionnalité autorun, ce problème a maintenant été résolu).
2. Les nouvelles classes d'extension de scénario de test qui sont incluses seront placées dans le groupe de tests et exécutées par la même occasion. Vous aurez à ajouter une directive SimpleTestOptions::ignore() pour ces classes ou alors pensez à les ajouter avant la ligne GroupTest::addTestFile().

Groupements de plus haut niveau

La technique ci-dessus place tous les scénarios de test dans un unique et grand groupe. Sauf que pour des projets plus conséquents, ce n'est probablement pas assez souple; vous voudriez peut-être grouper les tests tout à fait différemment.

Pour obtenir un groupe de tests plus souple nous pouvons sous classer GroupTest et ensuite l'instancier au cas par cas...

<?php
    require_once('simpletest/unit_tester.php');
    require_once('simpletest/reporter.php');
    
    class FileGroupTest extends GroupTest {
        function FileGroupTest() {
            $this->GroupTest('All file tests');
            $this->addTestFile('file_test.php');
        }
    }
?>

<?php
    require_once('file_group_test.php');
    
    $test = &new FileGroupTest();
    $test->run(new HtmlReporter());
?>

<?php
    require_once('file_group_test.php');
    
    $test = &new BigGroupTest('Big group');
    $test->addTestCase(new FileGroupTest());
    $test->addTestCase(...);
    $test->run(new HtmlReporter());
?>

<?php
    class FileGroupTest extends GroupTest {
        function FileGroupTest() {
            $this->GroupTest('All file tests');
            $test->addTestFile('file_test.php');
        }
    }
    
    if (! defined('RUNNER')) {
        define('RUNNER', true);
        $test = &new FileGroupTest();
        $test->run(new HtmlReporter());
    }
?>

<?php
    define('RUNNER', true);

    require_once('file_group_test.php');
    $test = &new BigGroupTest('Big group');
    $test->addTestCase(new FileGroupTest());
    $test->addTestCase(...);
    $test->run(new HtmlReporter());
?>

  
<?php   
    define('RUNNER', true); 
        
    $test = &new BigGroupTest('Big group'); 
    $test->addTestFile('file_group_test.php');  
    $test->addTestFile(...);   
    $test->run(new HtmlReporter()); 
?>  

Intégrer des scénarios de test hérités

Si vous avez déjà des tests unitaires pour votre code ou alors si vous étendez des classes externes qui ont déjà leurs propres tests, il y a peu de chances pour que ceux-ci soient déjà au format SimpleTest. Heureusement il est possible d'incorporer ces scénarios de test en provenance d'autres testeurs unitaires directement dans des groupes de test SimpleTest.