Python/Справочник по библиотеке Python 2.6: различия между версиями

Содержимое удалено Содержимое добавлено
Строка 541:
Возвращает однострочное описание теста, либо '''None''' если описание не задано. Реализация по умолчанию возвращает первую строку описания (docstring) тестового метода, либо '''None''', если описание не задано.
 
====25.3.6. Объекты TestSuite ====
Объекты '''TestSuite''' ведут себя в основном похоже на объекты '''TestCase''', за тем исключением, что онони на самом деле не реализуют тесты. Вместо этого, они используются для объединения тестов в группы тестов которые требуется запускать вместе. В объектах есть ряд дополнительных методов для добавления тестов в экземпляры '''TestSuite'''.
 
'''TestSuite.addTest(''test'')'''
Добавляет TestCase либо TestSuite к набору.
 
TestSuite.addTests(tests)¶
Добавляет все тесты в итераторе по экземплярамэкземпляр '''TestCase''' илибо '''TestSuite''' в данный тестовыйк наборнабору.
 
Вызов метода эквивалентен итерированию по tests, с вызовом addTest() для каждого элемента.
'''TestSuite.addTests(''tests'')'''
TestSuite разделяет с TestCase следующие методы:
 
TestSuite.run(result)¶
Добавляет все тесты в итераторе по экземплярам '''TestCase''' и '''TestSuite''' в данный тестовый набор.
Выполняет тесты связанные с данным набором, сохраняет результат в объекте результата теста, переданного в качестве result. Обратите внимание, что в отличие от TestCase.run(), TestSuite.run() требует передачи объекта результатов.
Вызов метода эквивалентен итерированию по ''tests'', с вызовом '''addTest()''' для каждого элемента.
TestSuite.debug()¶
 
Выполняет тесты, связанные с данным набором, без сбора результата. Это позволяет исключениям поднятым тестом добраться до вызвавшего объекта и может использоваться для выполнения тестов в отладчике (debugger).
'''TestSuite''' разделяет с TestCaseимеет следующие общие методы с TestCase:
 
'''TestSuite.run(''result'')'''
 
Выполняет тесты связанные с данным набором, сохраняет результат в объекте результата теста, переданного в качестве ''result''. Обратите внимание, что в отличие от '''TestCase.run()''', '''TestSuite.run()''' требует передачи объекта результатов.
 
'''TestSuite.debug()'''
 
Выполняет тесты, связанные с данным набором, без сбора результата. Это позволяет исключениям поднятым тестом добраться до вызвавшего объекта и может использоваться для выполнения тестов в отладчике (debugger).
 
'''TestSuite.countTestCases()'''
 
TestSuite.countTestCases()¶
Возвращает количество тестов представляемых данным тестовым объектом, включая все отдельные тесты и вложенные наборы.
 
В типичном сценарии использования объекта '''TestSuite''', метод '''run()''' вызывается классом '''TestRunner''', а не пользовательской обвязкой теста.
 
====25.3.7. Объекты TestResult====
Объект TestResult хранит результаты выполнения серии тестов. Классы TestCase и TestSuite отвечают за корректную запись результатов тестов. Авторам тестов нет необходимости заниматься записью исходов тестов.