FR 2. Prise en main

Créer une nouvelle méthode de test

Pour créer un nouveau test, vous devez créer une nouvelle méthode. Vous êtes libre de nommer la méthode comme vous le souhaitez.

Voici comment le composant va reconnaître une méthode de test unitaire : La première ligne doit commencer par

"// __UNIT_TEST"

Ensuite, vous pouvez créer un nouvel objet test en appelant la méthode New AJ_Tools_UT_describe :

   $test:= New AJ_Tools_UT_describe ("AJ_Tools_UT_assert";Current method name;"AJ_Tools_UT Tests")

⚠️ Seulement un "New AJ_Tools_UT_describe" est possible par méthode !

Vous pouvez alors définir les 4 propriétés obligatoires et appeler la fonction membre "assert".

Dans cet exemple, nous testons la méthode zz_max qui renvoie la valeur maximale passée en paramètre :

    // __UNIT_TEST

   $test:= New AJ_Tools_UT_describe ("Test the zz_max_method";Current method name;"Math")

   $test.given:="no arguments"
   $test.should:="return 0"
   $test.expected:=0
   $test.actual:=zz_max
   $test.assert()

   $test.given:="1 and 1"
   $test.should:="return 1"
   $test.expected:=1
   $test.actual:=zz_max (1;1)
   $test.assert()

Vous pouvez ajouter autant d'assertions que nécessaire pour vos tests.

Nous vous recommandons de tester une méthode par test unitaire et de ne pas mélanger différents tests dans une seule grande méthode de test.

⚠️ Il est important de ne pas oublier de cocher l'attribut de méthode "Partagée entre composants et base hôte" pour permettre au composant d'exécuter la méthode. Sinon, vous obtiendrez un message d'erreur. Il arrive souvent que l'on oublie de définir l'attribut, donc si vous voyez un message d'erreur, c'est la première chose à vérifier.

Macro

Le composant est fourni avec une macro qui vous aidera à créer un nouveau test. Vous pouvez simplement taper "_ut_new" et cela vous créera la structure minimale pour faire un test.

Main Window

Main Window vous permet d'afficher et de lancer tout ou une partie des tests.

Il y a deux façons d'afficher les tests : la vue en liste et la vue en accordéon.

La vue en liste sera remplie avec le résultat pendant que les tests sont en cours et lorsque le test sera terminé, elle affichera la vue en accordéon.

Voici quelques captures d'écran :

1 Vue en liste

2 Vue en accordéon - Tous les tests ont été réussis

3 Vue en accordéon - Certains tests ont échoué