Plugin Eclipse pour Simpletest

Compatibilité

Installation

Mettre à jour une version existante

1. Sélectionner "Help > Software Updates > Manage Configuration" dans le menu
2. Trouver le plugin Simpletest dans la liste et le choisir
3. Dans la section de droite, cliquer sur le lien "Scan for Updates"
4. Si aucune mise à jour n'est détectée, naviguer vers "Window > Preferences > Install/Update > Valid Updates" dans les préférences d'Eclipse et sélectionner "compatible", en lieu et place de "equivalent". Puis recommencer les étapes ci-dessus.
5. Sélectionner les versions à mettre à jour et cliquer sur "Next".
6. Relire les licences pour ces mises à jour : si elles sont acceptables, cocher "I accept the terms in the license agreements." Si les termes de la licence ne vous paraissent pas acceptables, il est encore temps d'arrêter le téléchargement.
7. Cliquer sur "Install" pour permettre le téléchargement est l'installation.
8. Une fois que toutes les fonctionnalités et plugins ont été téléchargés avec succès et que leurs fihciers ont été installés sur l'ordinateur local, une nouvelle configuration qui incorpore les nouvelles fonctionnalités et nouveaux plugins sera créée. Cliquer sur "Yes" quand on vous demander de quitter et relancher le "Workbench" pour les changements prennent effet.

Désinstallation

1. Sélectionner "Help > Software Updates > Manage Configuration"
2. Choisir le plugin Simpletest dans la liste
3. Cliquer-droit sur le plugin Simpletest et sélectionner l'option "Disable"
4. Accepter le redémarrage d'Eclipse
5. Une fois Eclipse redémarré, sélectionner "Help > Software Updates > Manage Configuration" depuis le menu
6. Sélectionner l'option "Show Disabled Features" dans la barre d'outils
7. Choisir le plugin SimpleTest dans la liste
8. Cliquer-droit sur le plugin SimpleTest et sélectionner l'option "Uninstall"
9. Accepter le redémarrage d'Eclipse

Utilisation

La suite présente quelques exemples d'utilsation du plugin.

1. Créer une nouveau projet de test (un lieu pour grouper des fichiers similaires)
   1. Sélectionner "File > New > Project.." dans le menu
   2. Agrandir le répertoire "General" et choisir "Project"
   3. Cliquer sur le bouton "Next"
   4. Sur le tab suivant, ajouter un nom de projet : "Test"
   5. Utiliser le contenu de projet par défaut
   6. Cliquer sur le bouton "Finish"
2. Créer un test unique avec un seul succès
   1. Dans l'explorateur de paquet cliquer-droit sur le projet "Test" et sélectionner "New > File".
   2. Comme nom de fichier remplir : test1.php et cliquer sur "Finish"
   3. Double-cliquer sur l'entrée test1.php dans l'explorateur de paquet : cela devrait ouvrir une nouvelle vue pour modifier ce fichier.
   4. Remplir le fichier avec ces lignes :

      <?php
      class test1 extends UnitTestCase {
        function test_pass(){
          $x = 1;
          $y = 2;
          $total = $x + $y;
          $this->assertEqual(3,$total, "This should pass");
        }
      }
      ?>
      

   5. Sélectionner "File > Save" depuis le menu.
   6. Cliquer-droit sur test1.php et sélectionner "Run > Run Simpletest".
   7. La "Result View" devrait se remplir avec les informations sur le résultat du test et la console SimpleTest devrait se remplir avec d'autres informations aussi.
3. Une seule classe de test, plusieurs tests
   1. dans l'explorateur de paquet, cliquer droit sur le projet "Test" et sélectionner "New > File".
   2. En tant que nom de fichier, utiliser : test2.php et cliquer sur "Finish".
   3. Double-cliquer sur l'entrée test2.php dans l'explorateur de paquet : une nouvelle vue s'ouvre, prête pour l'édition.
   4. Remplir le contenu avec :

      <?php
      class test2 extends UnitTestCase {          
        function test_pass(){
          $x = 1;
          $y = 2;
          $total = $x + $y;
          $this->assertEqual(3,$total, "This should pass");
        }
        function test_fail(){
          $x = 1;
          $y = 2;
          $total = $x + $y;
          $this->assertEqual(4,$total,"This should fail");
        }
      }
      ?>
      

   5. Sélectionner "File > save" dans la barre de menu.
   6. Cliquer-droit sur grouptest.php et sélectionner "Run > Run Simpletest".
   7. La "Result View" devrait se remplir avec les informations issus du test lancé, idem pour pour la console SimpleTest.
4. Tests groupés (plusieurs fichiers de test en même temps)
   1. dans l'explorateur de paquet, cliquer droit sur le projet "Test" et sélectionner "New > File".
   2. En tant que nom de fichier, utiliser : test2.php et cliquer sur "Finish".
   3. Double-cliquer sur l'entrée test2.php dans l'explorateur de paquet : une nouvelle vue s'ouvre, prête pour l'édition.
   4. Remplir le contenu avec :

      <?php
      class myGroupTest extends GroupTest {
        function myGroupTest() {
          parent::GroupTest('');
          $this->addTestFile(dirname(__FILE__).'/test1.php');
          $this->addTestFile(dirname(__FILE__).'/test2.php');
        }
      }
      ?>
      

   5. Sélectionner "File > Save" depuis le menu.
   6. Cliquer-droit sur test1.php et sélectionner "Run > Run Simpletest".
   7. La "Result View" devrait se remplir avec les informations sur le résultat du test et la console SimpleTest devrait se remplir avec d'autres informations aussi.

Problèmes connus

• Si un constructeur est utilisé dans le scénario de test, bien faire attention à ce que la dernière ligne de ce constructeur appelle le constructeur parent (par exemple parent::UnitTestCase)
• Ne pas mettre d'assertions dans le constructeur de la classe de test
• Si vous obtenez une erreur indiquant qu'une classe ne pouvait pas être chargé, alors il faut relancer Eclipse. Une fois qu'Eclipse a redémarré, ouvrir la "Result View" manuellement en sélectionnant "Window > Show View > Other..." Puis sélectionner la catégorie SimpleTest, puis la "Result View" et enfin cliquer sur "OK".

Foncationnalités à venir

Ci-dessous des fonctionnalités qui devrait arriver à un moment ou un autre dans ce plugin

• Permettre différents fichiers d'inclustion pour chaque lanceur (écraser l'include "master")
• Mieux gérer les erreurs fatales