TP4 Tests Unitaires PHP, TDD

1. Objectifs

Savoir développer des tests unitaires
Faire du test de robustesse
Implémenter des mocks
Faire du Test Driven Development (TDD)

2.

L'objectif final est d'implémenter une classe Money gràce au TDD en écrivant ce que l'on veut avec des tests.

Spécification: La classe Money a pour paramètres amount et  curr représentant un montant et une devise respectivement. La devise s’exprime comme une chaîne de trois caractères définie par la norme ISO (ici, seulement EUR (euro), USD ($), CHF (franc suisse), GBP (livre sterling)). Quand on additionne deux Money de même devise, le résultat a pour montant la somme des deux autres montants. Mais si les devises sont différentes alors il faut convertir.

La structure de la classe est la suivante:

class Money {

private $amount ;
private $curr ;


public function __construct( $amount , $currency );

public function amount ( ): float ;

public function currency ( ): string;

public function addM (Money $m) : void;

public function add (float $namount , string $ncurrency ) : void;

}

Dans la suite, vous pouvez coder les tests avec assertions classiques ou  par contrats avec Hamcrest (que je vous invite à essayer).

En partant de la structure ci-dessus, écrire la classe Money grâce au TDD.

Je vous propose d'y réfléchir de la façon suivante en commencant à écrire vos tests:

1. commencez par écrire le les tests pour le (les) constructeur, petit à petit (un test après l'autre
2. idem pour les getter / settter ????
3. puis passez à la méthode add(). Réfléchissez bien et écrivez les scénarios possibles avec vos tests (Cela forme la spécification de votre classe).
   De même, n'oubliez pas la fixture (@Before, @BeforeClass, etc.)

Nous nous limiterons aux devises EUR, USD (1 EUR = 1.29 USD).

Ecrivez chaque cas de test, puis chaque méthode de la classe Money  de façon incrémentale (l'une après l'autre, petit à petit, donc en TDD).

En fin de cette partie, stockez la classe Money

3. Simulation de classes, de dépendances -> Mock

Il est fort probable que vous ayez effectué les convertions euro-dollard dans le code avec l'unité de convertion (1 EUR = 1.29 USD). Pour faire mieux, il plus interessant d'utiliser une Classe externe qui est une dépendance à Money.

Soit donc la Classe Convertion qui prends une méthode unit_Convertion (string $s):float avec s une chaine de convertion "EUR-USD", "USD_EUR" dans notre cas.

Nous ne souhaitons pas coder cette classe de suite car il faut finir Money. Il est important d'isoler la classe Money pour ne tester que cette classe et pas une classe Convertion "codée à l'arrache". Nous allons donc mettre en place un Mock de cette classe Convertion

A

Doc PHPUnit Mock ICI

class Convertion {
public function unit_Convertion(string $s):float {return 0.0;}
}

Modifiez votre classe Money pour que le constructeur prenne une instance de Convertion (__construct($amount, $curr, $conv) et pour que les méthodes add et addM utilisent cette instance de Convertion.

Mettez à jour vos tests en utilisant le mock : dans le code, créez un mock de la classe Convertion avec $obs= $this->createMock(...) et

un exemple:

$obs->method('unit_Convertion')
    ->with($this->equalTo('EUR-EUR'))
    ->willReturn(1.0);

B

Corrigez vos tests, puis la classe Money.

Sur un de ces cas de test, vérifiez que la méthode unit_convertion du mock n'est appelée qu'une fois.

C

D

Ajoutez les méthodes sub  et subM qui effectuent la soustraction deux monnaies en commençant par créer les tests.

4. Test de Robustesse

Il semble logique que les montants ne doivent pas être négatifs. Cela fait parti des tests de robustesse. De même, on ne veut pas de devise nulle ou farfelue.
Peut-être y avez vous pensé auparavant ?

A

Créez de nouveaux cas de tests afin de tester ces points. Combien faut-il de cas de test par classe ?

B

Modifiez le code de la classe Money pour que vos tests passent.

5. Couverture de code

A

Donnez la couverture de code obtenue avec dans les questions 2 et maintenant (fin de 4). Y a t-il une différence?

Complétez le code de Money et /ou les cas de test (en précisant les modifications) pour obtenir une couverture de 100%