Python - doctest vs unittest

- Je utiliser unittest presque exclusivement.

De temps en temps, je vais mettre des trucs dans une docstring qui est utilisable par doctest.

95% des cas de test sont unittest.

Pourquoi? J'aime garder docstrings un peu plus courte et plus au point. Parfois, les cas de test aider à clarifier une docstring. La plupart du temps, l'application du cas de test sont trop longs pour une docstring.

Je travaille comme un bioinformatician, et la plupart du code que j'écris est "un temps, une tâche" scripts, code qui sera exécuté qu'une seule fois ou deux fois, et que d'exécuter une seule tâche spécifique.

Dans cette situation, écrit gros unittests peut-être exagéré, et doctests sont un compromis utile. Ils sont plus rapides à écrire, et depuis qu'ils sont normalement incorporés dans le code, ils permettent de toujours garder un œil sur la façon dont le code doit comporter, sans avoir à disposer d'un autre fichier ouvert. C'est utile lors de l'écriture de script de petites.

Aussi, doctests sont utiles lorsque vous devez passer votre script à un chercheur qui n'est pas expert en programmation. Certaines personnes trouvent qu'il est très difficile de comprendre comment unittests sont structurés; d'autre part, les doctests sont des exemples simples d'utilisation, afin que les gens il suffit de copier et de les coller pour voir comment les utiliser.

Donc, pour reprendre ma réponse: doctests sont utiles lorsque vous avez à écrire de petits scripts, et quand vous devez les transmettre ou de les montrer à des chercheurs qui ne sont pas des informaticiens.

- Je utiliser unittest exclusivement; je pense que doctest encombre jusqu'le module principal de trop. Cela a probablement à voir avec l'écriture des tests.

Je n'utilise pas doctest comme un remplacement pour unittest. Bien qu'ils se chevauchent un peu, les deux modules n'ont pas la même fonction:

• - Je utiliser unittest comme un framework de test unitaire, le sens qu'il m'aide à déterminer rapidement l'impact de toute modification sur le reste du code.

• - Je utiliser doctest comme une garantie que les commentaires (à savoir les docstrings) sont toujours d'actualité à la version actuelle du code.

La largement documenté les avantages du développement piloté par les tests que je reçois de unittest. doctest résout le beaucoup plus subtile danger d'avoir dépassées commentaires trompeurs de la maintenance du code.

Doctest peut parfois conduire à un mauvais résultat. En particulier lors de la sortie contient les séquences d'échappement. Par exemple

def convert():
    """
    >>> convert()
    '\xe0\xa4\x95'
    """
    a = '\xe0\xa4\x95'
    return a
import doctest
doctest.testmod()

donne

**********************************************************************
File "hindi.py", line 3, in __main__.convert
Failed example:
    convert()
Expected:
    'क'
Got:
    '\xe0\xa4\x95'
**********************************************************************
1 items had failures:
   1 of   1 in __main__.convert
***Test Failed*** 1 failures. 

Aussi ne vérifie pas le type de la sortie. Il se contente de comparer les chaînes de sortie. Par exemple, il ont fait un certain type rationnel qui imprime tout entier comme si c'est un nombre entier. Ensuite, supposons que vous disposez de la fonction de retour rationnelle. Donc, un doctest de ne pas différencier si la sortie est rationnel nombre entier ou un nombre entier.