Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Тестирование через документацию Python: Автоматическое тестирование

Помимо классических тестов, в Python встроено тестирование через документацию. Это довольно необычный способ писать тесты, который иногда применяют для библиотечных функций. В этом уроке мы изучим эту тему подробнее и разберемся, как выглядит такая документация.

Как работает тестирование через документацию

Идея довольно проста. Внутри терминала вызывается функция. Сам вызов и полученный в результате вывод — это и есть тест. Далее он добавляется в документацию функции:

# Внутри example.py определена функция reverse(), которая переворачивает строку
# Флаг -i переключает в интерактивный режим (REPL) после выполнения модуля
python -i example.py
reverse('')
# ''
reverse('Hexlet')
# 'telxeH'

Сделав нужные вызовы, мы просто добавляем их в описание функции:

def reverse(string):
    """Reverse string

    >>> reverse('')
    ''

    >>> reverse('Hexlet')
    'telxeH'
    """

    return string[::-1]

# Нужно для запуска тестов
if __name__ == "__main__":
    import doctest
    doctest.testmod()

Если передать этот файл в интерпретатор, то мы увидим отчет о выполненных тестах:

# Для полного вывода нужно добавить флаг -v (verbose)
python example.py -v
Trying:
    reverse('')
Expecting:
    ''
ok
Trying:
    reverse('Hexlet')
Expecting:
    'telxeH'
ok
1 items had no tests:
    __main__
1 items passed all tests:
   2 tests in __main__.reverse
2 tests in 2 items.
2 passed and 0 failed.
Test passed.

Вот так документация может одновременно выполнять роль тестов. Это достаточно удобно и практично. То же самое можно делать не только на уровне конкретной функции, но и на уровне всего модуля:

"""
This is the "example" module.

The example module supplies one function, reverse().  For example,

>>> reverse('awesome!')
'!emosewa'
"""

Дополнительные материалы

  1. Документация Doctest

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты

Об обучении на Хекслете

Для полного доступа к курсу нужен базовый план

Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.

Получить доступ
1000
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно

  • 130 курсов, 2000+ часов теории
  • 1000 практических заданий в браузере
  • 360 000 студентов
Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff
Рекомендуемые программы
профессия
Обучитесь разработке бэкенда сайтов и веб-приложений — серверной части, которая отвечает за логику и базы данных
10 месяцев
с нуля
Старт 17 октября

Используйте Хекслет по-максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»