Programmation PYTHON - Zenk - Security - Repository

420
Techniques avancées
QUATRIÈME PARTIE
REPORT_ONLY_FIRST_FAILURE
Ce marqueur global permet de spécifier que pour chaque séquence, seule la première
comparaison qui échoue est reportée. Le reste de la séquence est exécutée mais plus
aucune erreur n’est reportée. Utilisé pour minimiser le retour des tests dès lors que
des problèmes sont rencontrés.
doctests dans un fichier texte séparé
Des fichiers textes peuvent aussi être dédiés aux doctests : l’outil parcourt dans ce cas
les lignes et exécute le contenu comme un seul et même docstring. Cette technique
permet de réunir tous les tests dans un seul et même module, pour revenir à un principe
similaire aux tests unitaires, mais avec toute la puissance narrative des doctests en plus.
Les exemples de code s’alternent de commentaires, dans un flux continu et directement
lisible. Au fur et à mesure de l’évolution du code, des exemples de plus en plus
complexes et des cas particuliers s’ajoutent à ce fichier, qui devient une documentation
complète à progression logique.
L’exemple ci-dessous reprend l’exemple des tests sur cPickle, pour une écriture équivalente
en doctests.
test_cPickle.txt
le module cPickle permet de sauvegarder des
objets sur le système de fichiers ou dans tout autre flux.
>>> import cPickle
Prenons l'exemple d'une classe classique
et une instance de cette classe
que nous allons sauvegarder
>>> from UserDict import UserDict
>>> o = UserDict()
>>> o['a'] = 1
>>> o['b'] = 2
Pour sauver l'objet, cPickle prend en paramètre
un objet de type file, ouvert par nos soins
>>> fic = open('/home/tziade/pickled.bin', 'w')
La fonction dump se charge de la sérialisation
>>> cPickle.dump(o, fic)
fermons le fichier