Programme Leçon 241 sur 250 · Projet final : livre-le (empaquette ton projet)
Projet final : livre-le (empaquette ton projet)

Écris un banc de test

Un dossier tests/ vide ne trompe personne. Dès qu'un relecteur voit de vrais tests, deux choses se produisent : il fait plus confiance au code, et il te fait plus confiance à toi, parce que les tests prouvent que tu as réfléchi à ce que « correct » veut dire. Dans le vrai dépôt, tu les lanceras avec pytest (une seule commande, vue à la leçon suivante). Mais sous le capot, un framework de test n'a rien de magique -> c'est une boucle qui exécute ta fonction sur des entrées connues et vérifie la sortie. Construire cette boucle toi-même, une fois, démystifie tout le reste.

Cette leçon parle donc de tests, enseignés comme du simple code déterministe. Tu écris un tout petit banc de test :

  • run_checks(fn, cases) -> cases est une liste de paires (args_tuple, expected). Appelle fn(*args) pour chaque cas, compare le résultat à expected, et renvoie une liste de {"args": args, "ok": bool} qui indique quels cas ont réussi. Si fn lève une exception pendant l'appel, ce cas est un échec (ok=False), pas un plantage qui fait tomber toute l'exécution -> un vrai lanceur de tests signale l'échec et continue.
  • all_pass(results) -> True seulement s'il y a au moins un résultat et que tous ont ok=True. Une liste de résultats vide veut dire que rien n'a vraiment été vérifié, donc ce n'est pas une réussite. C'est le signal de « build vert » : un seul booléen qui dit que toute la suite est bonne.

Pourquoi la règle « au moins un » compte : une suite de tests qui exécute sans bruit zéro test et annonce un succès est pire que pas de tests du tout, parce qu'elle donne une fausse confiance. Gérer le cas vide fait la différence entre un banc de test qui veut dire quelque chose et un qui dit toujours oui.

Exemple concret. Disons que ton projet expose add(a, b). Tu écris les cas [((1, 2), 3), ((0, 0), 0), ((5, 5), 10)]. Un additionneur correct réussit les trois -> all_pass vaut True. Une version boguée qui soustrait renvoie -1, 0, 0 -> deux cas échouent, all_pass vaut False, et ton banc de test vient d'attraper une régression. Voilà toute la valeur des tests en une phrase : une fonction correcte et une fonction cassée te donnent des réponses différentes, automatiquement.

Construis-le avec un simple try/except autour de l'appel, pour qu'une fonction qui lève une exception compte comme un cas échoué. Appuie sur Run pour passer un additionneur correct au banc de test et voir tous les cas passer au vert.

À ton tour

Construis un banc de test minimal. Écris run_checks(fn, cases), où cases est une liste de (args_tuple, expected) : appelle fn(*args) pour chacun, et renvoie une liste de {"args": args, "ok": bool} qui indique quels cas correspondent à expected (une fonction qui lève une exception donne ok=False pour ce cas, sans plantage). Écris all_pass(results) qui renvoie True seulement quand il y a au moins un résultat et que chaque ok vaut True (une liste vide donne False). Une fonction correcte et une fonction boguée doivent recevoir des verdicts différents.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.