все Python 3doctestпонятие

doctest

модуль

Проверка примеров из docstring: модуль находит в тексте сеансы «>>>», исполняет их и сверяет вывод с записанным.

Синтаксис

import doctest

doctest хорош, чтобы примеры в документации не устаревали: пример и есть тест. Для настоящего набора тестов с фикстурами и проверкой исключений удобнее unittest или pytest. Сверка идёт по тексту вывода буквально, поэтому ломается на порядке элементов множества, адресах объектов и лишних пробелах.

Примеры

import doctest
def square(x):
    """
    >>> square(3)
    9
    """
    return x * x
print(doctest.testmod().failed)  # → 0

См. также

Открыть в полном глоссарииdocs.python.orgСообщить о неточности