Programmation PYTHON - Zenk - Security - Repository

doctests
À SAVOIR Scripts de tests des frameworks
Programmation dirigée par les tests
CHAPITRE 12
Les frameworks de développement Python, comme Twisted ou Zope, proposent généralement leurs propres
scripts de tests, plus ou moins similaires à l’implémentation présentée et plus ou moins pratiques.
Les doctests offrent une approche complémentaire très intéressante pour l’écriture
des tests unitaires : il est possible de les insérer directement dans le code à tester.
Contenus dans les docstrings de toute fonction, méthode, classe ou module, les tests
sont récupérés par un outil spécialisé, défini dans le module doctest.
Pour être reconnus par l’outil, ces tests doivent être écrits sous la forme de petites
sessions de code ressemblant à des séquences d’un prompt Python interactif.
Exemple de doctest
def somme(a, b):
""" renvoie a + b
>>> somme(2, 2)
4
>>> somme(2, 4)
6
"""
return a + b
L’outil vérifie alors que toutes ces séquences, qui sont indépendantes les unes des
autres, fonctionnent en les exécutant.
Exécution des doctests
Le module doctest fournit une fonction similaire à la fonction main() de unittest,
qui permet d’exécuter les tests unitaires contenus dans les docstrings d’un module
donné.
Module de code avec appel à testmod
import doctest
def somme(a, b):
""" renvoie a + b
>>> somme(2, 2)
4
411