Bônus - Doctests

Python possui um módulo chamado doctest que procura por sessões interativas dentro das documentações e as executa validando os resultados.

Exemplo:

arquivo soma.py

# coding: utf-8

def soma(a, b):
    """
    Soma a + b 
    Ex:
        >>> soma(1, 1)
        2
        >>> soma(2, 3)
        5
    """
    return a + b
`

O conteúdo contido dentro das aspas triplas será avaliado pelo módulo doctest e executado como um test Python.

Podemos executar diretamente com python -m doctest -v soma.py e veremos o resultado:

Trying:
    soma(1, 1)
Expecting:
    2
ok
Trying:
    soma(2, 3)
Expecting:
    5
ok
1 items had no tests:
    soma
1 items passed all tests:
   2 tests in soma.soma
2 tests in 2 items.
2 passed and 0 failed.
Test passed.