Запуск тестов

Backend

Для запуска тестов backend, запустите и подключитесь к контейнеру backend, как описано в running-the-dev-environment.md. После входа в контейнер выполните make test или make test-parallel, чтобы запустить тесты.

Тесты используют конфигурацию config.settings.tests, которая устанавливает базовые переменные и игнорирует переменные окружения в файле .env. Файл .env предназначен для режимов производства или разработки.

Настройка параметров тестирования

Вы можете настроить параметры тестирования, создав файл .env.testing в директории backend. Например:

# backend/.env.testing
BASEROW_MAX_FIELD_LIMIT=1

Миграции и настройка базы данных

По умолчанию, BASEROW_TESTS_SETUP_DB_FIXTURE считается on в конфигурации config.settings.tests. Это означает, что база данных будет настроена без выполнения миграций, но только с установкой формул базы данных, необходимых для тестов. Это делается для ускорения процесса настройки тестов.

Если вы хотите выполнить миграции, вы можете запустить BASEROW_TESTS_SETUP_DB_FIXTURE=off pytest, чтобы выполнить все миграции. Это полезно, когда вы хотите протестировать миграции и не беспокоитесь о скорости настройки тестов.

Если вы хотите установить пользовательские функции pgSQL только один раз и затем переиспользовать базу данных между тестами, вы можете запустить BASEROW_TESTS_SETUP_DB_FIXTURE=off pytest --no-migrations --reuse-db.

Вы даже можете опустить --no-migrations, чтобы применить новые миграции из текущей ветки и избежать пересоздания базы данных с нуля.

Запуск тестов вне контейнера backend

Для запуска тестов вне контейнера backend следуйте этим шагам:

1. Создайте виртуальное окружение Python. См. supported, чтобы определить поддерживаемую версию Python.
2. Из директории backend установите необходимые пакеты с помощью pip install requirements/base.txt и pip install requirements/dev.txt.
3. Установите переменные окружения для подключения к базе данных. Создайте файл .env.testing-local в директории backend. Минимально, установите DATABASE_HOST в localhost, так как значение по умолчанию db действует только внутри сети Docker.

# backend/.env.testing-local
DATABASE_HOST=localhost

4. Экспортируйте переменную TEST_ENV_FILE, чтобы указать файл окружения:

export TEST_ENV_FILE='.env.testing-local'

5. Запустите make test или make test-parallel из вашего терминала вне контейнеров в директории backend.