Я пытаюсь начать с модульного тестирования в Python, и мне было интересно, кто-нибудь может объяснить преимущества и недостатки doctest и unittest.
Для каких условий вы бы использовали каждый?
Я пытаюсь начать с модульного тестирования в Python, и мне было интересно, кто-нибудь может объяснить преимущества и недостатки doctest и unittest.
Для каких условий вы бы использовали каждый?
Оба ценны. Я использую и doctest, и нос вместо места unittest. Я использую doctest для случаев, когда тест дает пример использования, который на самом деле полезен в качестве документации. Обычно я не делаю эти тесты всеобъемлющими, стремясь исключительно к информативности. Я эффективно использую doctest в обратном порядке: не для проверки правильности моего кода на основе моего doctest, а для проверки правильности моей документации на основе кода.
Причина в том, что я нахожу, что всесторонние тесты документов слишком сильно загромождают вашу документацию, поэтому вы либо столкнетесь с неиспользуемыми строками документов, либо с неполным тестированием.
Для реального тестирования кода цель состоит в том, чтобы тщательно протестировать каждый случай, а не проиллюстрировать, что делает пример, что является другой целью, которая, я думаю, лучше достигается другими средами.
Я использую unittest почти исключительно.
Время от времени я помещаю некоторые вещи в строку документации, которые можно использовать в doctest.
95% тестов являются юнит-тестами.
Зачем? Мне нравится держать строки документов несколько короче и ближе к делу. Иногда тестовые случаи помогают уточнить строку документации. В большинстве случаев тестовые случаи приложения слишком длинны для строки документации.
источник
docstring
а что нет. На самом деле мне нравится docstring в термине, который явно показывает, как использовать интерфейс, но использование его для этого и модульного тестирования может не подходить.Еще одним преимуществом тестирования документов является то, что вы можете убедиться, что ваш код выполняет то, что написано в документации. Через некоторое время изменения программного обеспечения могут заставить вашу документацию и код делать разные вещи. :-)
источник
Я работаю биоинформатиком, и большая часть кода, который я пишу, представляет собой сценарии «один раз, одна задача», код, который будет выполняться только один или два раза и который выполняет одну конкретную задачу.
В этой ситуации написание больших юнит-тестов может быть излишним, а док-тесты - полезный компромисс. Они быстрее пишутся, и поскольку они обычно включаются в код, они позволяют всегда следить за тем, как должен вести себя код, без необходимости открывать другой файл. Это полезно при написании небольших сценариев.
Кроме того, doctests полезны, когда вы должны передать свой сценарий исследователю, который не является экспертом в программировании. Некоторым людям очень трудно понять, как устроены юнит-тесты; с другой стороны, doctests являются простыми примерами использования, поэтому люди могут просто скопировать и вставить их, чтобы увидеть, как их использовать.
Итак, чтобы возобновить мой ответ: doctests полезна, когда вам нужно написать небольшие сценарии и когда вы должны передать их или показать их исследователям, которые не являются компьютерными учеными.
источник
Если вы только начинаете с идеей модульного тестирования, я бы начал с того,
doctest
что он настолько прост в использовании. Это также естественно обеспечивает некоторый уровень документации. А для более всестороннего тестированияdoctest
вы можете поместить тесты во внешний файл, чтобы он не загромождал вашу документацию.Я бы посоветовал,
unittest
если вы исходите из опыта использования JUnit или чего-то подобного, где вы хотите иметь возможность писать модульные тесты в целом так же, как вы это делали в других местах.источник
doctest
для начала), но в конце концов пожалел об этом. Для нетривиальных тестовых случаев я потерял подсветку синтаксиса и автозаполнение моего редактора. Когда тесты были в отдельном файле, я больше не мог запускать его прямо из редактора - мне приходилось каждый раз менять контекст на соответствующий исходный файл.Я использую исключительно unittest; Я думаю, что doctest слишком сильно загромождает основной модуль. Это, вероятно, связано с написанием тщательных тестов.
источник
Использование обоих является допустимым и довольно простым вариантом.
doctest
Модуль обеспечиваетDoctTestSuite
иDocFileSuite
методы , которые создают UnitTest-совместимые Тесты из модуля или файла, соответственно.Поэтому я использую оба и обычно использую doctest для простых тестов с функциями, которые практически не требуют настройки (простые типы для аргументов). Я действительно думаю, что несколько тестов doctest помогают документировать функцию, а не отвлекать от нее.
Но для более сложных случаев и для более полного набора тестов я использую unittest, которая обеспечивает больший контроль и гибкость.
источник
Я не использую doctest в качестве замены для unittest. Хотя они немного перекрывают друг друга, эти два модуля не имеют одинаковую функцию:
Я использую
unittest
в качестве фреймворка для модульного тестирования, это означает, что он помогает быстро определить влияние любой модификации на остальную часть кода.Я использую
doctest
в качестве гарантии, что комментарии (а именно строки документов) по-прежнему актуальны для текущей версии кода.Широко документированные преимущества тест-ориентированной разработки, которую я получил
unittest
.doctest
решает гораздо более тонкую опасность устаревших комментариев, вводящих в заблуждение содержание кода.источник
Я почти никогда не пользуюсь документами. Я хочу, чтобы мой код самодокументировался, а строки документации предоставляют документацию пользователю. IMO, добавляющий сотни строк тестов в модуль, делает строки документов гораздо менее читабельными. Я также считаю, что модульные тесты легче модифицировать при необходимости.
источник
Doctest
может несколько раз привести к неправильному результату. Особенно, когда выходные данные содержат escape-последовательности. Напримердает
Также не проверяет тип вывода. Он просто сравнивает выходные строки. Например, он сделал некоторый тип рациональным, который печатает как целое число, если это целое число. Тогда предположим, что у вас есть функция, которая возвращает рациональную. Таким образом, doctest не будет дифференцироваться, если результат будет рациональным целым числом или целым числом.
источник
r""" ... """
) для решения первой проблемы.'\\xe0\\xa4\\x95'
в вашей строке документации.Я предпочитаю системы, основанные на открытиях («перенос» и «py.test», использующие первый в настоящее время).
doctest хорош, когда тест также хорош как документация, в противном случае они слишком часто загромождают код.
источник