Programmation PYTHON - Zenk - Security - Repository

Marqueur Ellipsis
def mon_objet():
"""
>>> mon_objet() #doctest: +ELLIPSIS
"""
return object()
Programmation dirigée par les tests
CHAPITRE 12
Ce marqueur fait partie d’un ensemble de drapeaux présentés ci-dessous.
Environnement et options d’exécution
Pour chaque docstring parcouru, un environnement d’exécution est créé à partir d’une
copie des variables globales du module parcouru, renvoyée par globals(). Cette copie
est abandonnée à la fin du docstring, afin d’éviter tout impact sur les tests suivants.
Il est aussi possible de faire varier le fonctionnement des doctests par le biais
d’options d’exécution, appelées marqueurs. Chaque marqueur peut être ajouté aux
lignes des doctests, pour une action locale, ou passé en paramètre lorsque tous les
tests sont lancés, pour une action globale.
Ajouter un marqueur localement se fait en insérant un commentaire en fin de ligne,
avec le nom du marqueur précédé du signe plus (+).
Les marqueurs globaux quant à eux sont concaténés par des opérateurs OR et forment
le paramètre optionflags de la fonction testmod().
Insertion d’un marqueur
# marqueur local
>>> error() # doctest: +IGNORE_EXCEPTION_DETAIL
# marqueur global
importdoctest
if __name__ == "__main__":
flags = doctest.IGNORE_EXCEPTION_DETAIL
doctest.testmod(optionflags=flags)
Les marqueurs disponibles sont :
DONT_ACCEPT_TRUE_FOR_1 : les versions 2.2 et précédentes de Python affichent 0
et 1 pour le retour d’une fonction booléenne. Le module doctest accepte donc ces
valeurs en lieu et place de True et False pour que la transition vers des versions
plus récentes de l’interpréteur ne se fasse pas brutalement. Cette option, qui ne
peut être utilisée que globalement, permet de forcer un contrôle strict.
DONT_ACCEPT_BLANKLINE : empêche l’utilisation de . S’utilise globalement.
415