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

doctest.DocTestFinder

строительные блоки

Ищет докстринги с примерами у объекта и вложенных в него функций, классов и методов, возвращая список DocTest.

Синтаксис

doctest.DocTestFinder(verbose=False, parser=DocTestParser(), recurse=True, exclude_empty=True).find(obj, name=None, module=None, globs=None)

Он проверяет __module__ и пропускает объекты, импортированные из других модулей: from utils import f не заставит testmod() проверять f. Объекты без докстринга по умолчанию отбрасываются (exclude_empty=True), а докстринг без примеров даёт DocTest с нулём примеров. Имена тестов — полные: 'Box.area', а у модуля — с его именем.

Примеры

import doctest
class Box:
    def area(self):
        """
        >>> Box().area()
        4
        """
        return 4
tests = doctest.DocTestFinder().find(Box)
print([t.name for t in tests])  # → ['Box.area']
print([t.name for t in doctest.DocTestFinder(exclude_empty=False).find(Box)])  # → ['Box', 'Box.area']

См. также

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