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

 

Возвращает '''True''' если все значения последовательности правдивые (или последовательность пуста). Эквивалентно:

def all(iterable):

for element in iterable:

return False

return True

''Появилось в версии 2.5''

 

Возвращает '''True''' если хоть один из элементов правдив. Если последовательность пуста возврощает False. Эквивалентно:

 

def any(iterable):

for element in iterable:

return True

return False

 

''Появилось в версии 2.5''

 

Класс-метод получает класс с неявным первым аргументом, например метод получает экземпляр объекта. Декларация класса-метода такова:

class C:

@classmethod

def f(cls, arg1, arg2, ...): ...

@classmethod это функция-декоратор

 

Вот короткий сценарий для тестирования трех функций из модуля '''random''':

 

import random

import unittest

if __name__ == '__main__':

unittest.main()

 

Тестовый вариант создан как подкласс '''unittest.TestCase'''. Три отдельных теста заданы с помощью методов, названия которых начинаются с последовательности 'test'. Такое соглашение об наименовании сообщает исполнитель тестов о том, какие методы представляют тесты.

 

Существуют и другие способы выполнение тестов, кроме '''unittest.main()''', причем с большей степенью контроля, не таким скупым выводом и не обязательно запускаемые из командной строки. Например, последние две строки могут быть заменены следующими:

suite = unittest.TestLoader().loadTestsFromTestCase(TestSequenceFunctions)

unittest.TextTestRunner(verbosity=2).run(suite)

 

Результатом выполнения измененного сценария из интерпретатора, либо из другого сценария, будет следующий вывод:

Простейший подкласс '''TestCase''' просто замещает метод '''runTest()''' для выполнения определенного тестового кода:

 

import unittest

 

widget = Widget('The widget')

self.assertEqual(widget.size(), (50, 50), 'incorrect default size')

 

Обратите внимание, что для того чтобы протестировать что-либо, используется один из методов '''assert*()''' или '''fail*()''' базового класса '''TestCase()'''. Если тест проваливается, поднимается исключение, и '''unittest''' идентифицирует тестовый вариант как «провалившийся» (failure). Любые иные исключения воспринимаются как ошибки (errors). Такое разделение позволяет определить место проблемы: ''failure'' вызываются неправильными результатами – 5 в том месте, в котором ожидается 6. ''Errors'' вызываются некорректным кодом – например, причиной'''TypeError''' является неправильный вызов функции

Способ выполнения тестовых вариантов будет описан чуть позже. Сейчас же, отметьте что для того чтобы создать экземпляр такого тестового варианта вызывается его конструктор без аргументов:

 

testCase = DefaultWidgetSizeTestCase()

 

Подобные тестовые варианты могут быть многочисленными и установка начальных значений для них может повторяться многократно. В примере выше, создание виджета для каждого из 100 тестовых вариантов для виджетов, означает некрасивое повторение кода.

К счастью, можно избежать таких проблем с кодом установки начальных значений, используя метод '''setUp()''', автоматически вызываемый тестовым каркасом при выполнении теста:

 

import unittest

 

self.assertEqual(self.widget.size(), (100,150),

'wrong size after resize')

 

Если метод '''setUp()''' поднимает исключение во время выполнения теста, каркас полагает что в тесте есть ошибка и метод '''runTest()''' не выполняется.

Аналогичными образом можно добавить метод '''tearDown()''' который сбрасывает изменения в начальных установках после выполнения метода '''runTest()'''

 

class SimpleWidgetTestCase(unittest.TestCase):

def setUp(self):

self.widget.dispose()

self.widget = None

 

Если метод '''setUp()''' был успешно выполнен, метод '''tearDown()''' будет выполнятся вне зависимости от успешности выполнения '''runtTest()'''.

Часто множество небольших тестовых вариантов используют одинаковое окружение. В таких случаях, для класса '''SimpleWidgetTestCase''' может создаваться куча подклассов с одним методом, типа '''DefaultWidgetSizeTestCase'''. Эта операция отнимает много времени и отбивает всякое желание ей заниматься, поэтому, аналогично с '''JUnit''', '''unittest''' предоставляет более простой механизм:

 

import unittest

 

self.assertEqual(self.widget.size(), (100,150),

'wrong size after resize')

 

В приведенном примере нет метода '''runTest()''', вместо этого есть два разных тестовых метода. Каждый экземпляр класса будут выполнять один из методов '''test_*()''' с созданием и уничтожением '''self.widget''' при запуске тестового метода. При создании экземпляра требуется указать какой тестовый метод следует выполнять. Это достигается передачей названия метода в конструктор.

 

defaultSizeTestCase = WidgetTestCase('test_default_size')

resizeTestCase = WidgetTestCase('test_resize')

 

Экземпляры тестовых вариантов группируются в соответствии с функциями, которые они тестируют. '''unittest''' предоставляет механизм такой группировки: тестовые наборы, представляемые классом '''TestSuite''' модуля '''unittest''':

 

widgetTestSuite = unittest.TestSuite()

widgetTestSuite.addTest(WidgetTestCase('test_default_size'))

widgetTestSuite.addTest(WidgetTestCase('test_resize'))

 

Для упрощения выполнения тестов, как мы убедимся чуть позже, рекомендуется создать в каждом тестовом модуле вызываемый объект, возвращающий предварительно созданный тестовый набор:

 

def suite():

suite = unittest.TestSuite()

 

return unittest.TestSuite(map(WidgetTestCase, tests))

 

Поскольку создание подкласса '''TestCase''' с несколькими тестовыми функциями со сходными названиями является общей практикой, в '''unittest''' есть класс '''TestLoader''', который можно использовать для автоматизации процесса создания тестового набора и наполнения его отдельными тестами. Например, строка:

 

suite = unittest.TestLoader().loadTestsFromTestCase(WidgetTestCase)

 

создаст тестовый набор выполняющий методы '''WidgetTestCase.test_default_size()''' и '''WidgetTestCase.test_resize()'''. '''TestLoader''' автоматически находит тестовые методы по префиксу 'test' в названии метода.

Часто возникает необходимость группировать тестовые наборы, например для выполнения тестов для целой системы сразу. С этим нет никаких сложностей, поскольку экземпляры '''TestSuite''' могут добавляться в '''TestSuite''', так же как и экземпляры '''TestCase'''.

 

suite1 = module1.TheTestSuite()

suite2 = module2.TheTestSuite()

alltests = unittest.TestSuite([suite1, suite2])

 

Код тестовых вариантов и тестовых наборов может размещаться в тех же модулях, что и код, который они тестируют (таких как '''widget.py'''), но размещение тестового кода в отдельном модуле (таком как '''test_widget.py''') дает ряд преимуществ:

Для следующей тестовой функции:

 

def testSomething():

something = makeSomething()

assert something.name is not None

# ...

 

возможно создание экземпляра тестового варианта таким образом:

 

testcase = unittest.FunctionTestCase(testSomething)

 

При необходимости дополнительного запуска методов установки начального состояния и сброса в ходе выполнения тестового варианта, они должны указываться как в примере:

 

testcase = unittest.FunctionTestCase(testSomething,

setUp=makeSomethingDB,

tearDown=deleteSomethingDB)

 

Для упрощения использования уже существующих тестов, '''unittest''' поддерживает тесты поднимающие '''AssertionError''' для отображения провала теста. Тем не менее, рекомендуется использовать методы '''TestCase.fail*()''' и '''TestCase.assert*()''', поскольку в будущих версиях '''unittest''' обработка '''AssertionError''' может отличаться.

Каждый экземпляр TestCase выполняет единственный тестовый метод под названием ''methodName''. Как вы возможно помните, выше приводился пример в котором было что-то вроде этого:

 

def suite():

suite = unittest.TestSuite()

suite.addTest(WidgetTestCase('test_resize'))

return suite

 

В нем создаются два экземпляра '''WidgetTestCase''', каждый из которых выполняет единственный тест.

Командно-строчная программа выполняющая набор тестов, предназначена для реализации простого выполнения тестовых модулей. Простейшим использованием данной функции является включение следующей строки в конец тестового сценария:

 

if __name__ == '__main__':

unittest.main()

 

Аргумент '''testRunner''' может быть как классом тестового прогонщика, так и уже созданным экземпляром такого класса.