Como usar o Doctests no python

Doctests são testes criados dentro do comentário da função.

Um exemplo de doctests, crie um arquivo calculo.py.

def soma(a, b):
"""soma os números a e b
>>> soma(1, 2)
3
"""
return a + b

Agora para rodar os testes basta executar o comando:

python -m doctest -v calculo.py

Pronto ;)