• Выполнение тестов

Оригинал на GitHub

Odoo обеспечивает поддержку тестирования модулей с использованием unittest.

Чтобы написать тесты, просто определите субмодуль``tests`` в вашем модуле, он будет автоматически запущен для тестирования модулей. Модули тестирования должны иметь имя, начинающееся с test_, и должны быть импортированы из tests/__init__.py, например:

your_module
|-- ...
`-- tests
    |-- __init__.py
    |-- test_bar.py
    `-- test_foo.py

а __init__.py содержит:

from . import test_foo, test_bar

Предупреждение

Модули тестирования, которые импортируются не из tests/__init__.py запускаться не будут

Изменено в версии 8.0: previously, the test runner would only run modules added to two lists fast_suite and checks in tests/__init__.py. In 8.0 it will run all imported modules

При тестировании будет запускаться любой тест, как описано в официальной unittest documentation, но Odoo предоставляет ряд утилит и помощников, связанных с тестированием контента Odoo (главным образом модулей):

class odoo.tests.common.TransactionCase(methodName='runTest')

TestCase, в котором каждый тестовый метод запускается в своей транзакции и с собственным курсором. Откат транзакции и закрытие курсора после каждого теста.

browse_ref(xid)

Возвращает объект записи для предоставленного external identifier

Параметры

xid -- Полный external identifier, в форме module.identifier

Raise

ValueError если не найден

Результат

BaseModel

ref(xid)

Возвращает ID базы данных для предоставленного external identifier, ярлык для get_object_reference

Параметры

xid -- Полный external identifier, в форме module.identifier

Raise

ValueError если не найден

Результат

Зарегистрированный id

class odoo.tests.common.SingleTransactionCase(methodName='runTest')

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

browse_ref(xid)

Возвращает объект записи для предоставленного external identifier

Параметры

xid -- Полный external identifier, в форме module.identifier

Raise

ValueError если не найден

Результат

BaseModel

ref(xid)

Возвращает ID базы данных для предоставленного external identifier, ярлык для get_object_reference

Параметры

xid -- Полный external identifier, в форме module.identifier

Raise

ValueError если не найден

Результат

Зарегистрированный id

class odoo.tests.common.SavepointCase(methodName='runTest')

Аналогичен SingleTransactionCase в том, что все методы тестирования выполняются в одной транзакции, но каждый TestCase выполняется в откатанной точке сохранения (под-транзакции).

Полезно для тестовых случаев, содержащих быстрые тесты, но со значительной настройкой базы данных, общей для всех случаев (сложные тестовые данные в бд): :meth:[UNKNOWN NODE problematic]~.setUpClass`может использоваться для генерации тестовых данных БД один раз и тогда все TestCase будут использовать одни и те же данные, не влияя друг на друга, и без необходимости заново создавать тестовые данные.

class odoo.tests.common.HttpCase(methodName='runTest')

Transactional HTTP TestCase with url_open and phantomjs helpers.

browse_ref(xid)

Возвращает объект записи для предоставленного external identifier

Параметры

xid -- Полный external identifier, в форме module.identifier

Raise

ValueError если не найден

Результат

BaseModel

phantom_js(url_path, code, ready='window', login=None, timeout=60, **kw)

Протируетjs код запустив его в браузере - дополнительно авторизуется в системе как login, загрузит объявленную страницу url_path, дождется пока объект сможет быть выполнен и исполнит code внутри страницы

To signal success test do: console.log('ok')

To signal failure do: console.log('error')

If neither are done before timeout test fails.

ref(xid)

Возвращает ID базы данных для предоставленного external identifier, ярлык для get_object_reference

Параметры

xid -- Полный external identifier, в форме module.identifier

Raise

ValueError если не найден

Результат

Зарегистрированный id

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

odoo.tests.common.at_install(flag)

Устанавливает состояние at-install для теста, флаг является логическим значением, указывающим, должен ли тест (True) или не должен (False) выполняться во время установки модуля.

По умолчанию тесты запускаются сразу после установки модуля перед началом установки следующего модуля.

odoo.tests.common.post_install(flag)

Устанавливает состояние после установки теста. Флаг является логическим параметром, определяющим, должен ли тест запускаться или не запускаться после установки набора модулей.

По умолчанию тесты не запускаются после установки всех модулей в текущем наборе для.

Наиболее распространенная ситуация заключается в использовании TransactionCase и тестирования свойства модели в каждом методе:

class TestModelA(common.TransactionCase):
    def test_some_action(self):
        record = self.env['model.a'].create({'field': 'value'})
        record.some_action()
        self.assertEqual(
            record.field,
            expected_field_value)

    # other tests...

Примечание

Методы тестов должны начинаться с test_

Выполнение тестов

Тесты автоматически запускаются при установке или обновлении модулей, если опция --test-enable была включена при запуске сервера Odoo.

As of Odoo 8, running tests outside of the install/update cycle is not supported.