Тестирование приложений GeoDjango

В этом документе содержатся дополнительные заметки и настройки для пользователей PostGIS.

PostGIS

Настройки

POSTGIS_VERSION

При инициализации пространственного бэкенда GeoDjango на PostGIS необходимо выполнить SQL-запрос для определения версии, чтобы узнать, какие функции доступны. Расширенные пользователи, желающие предотвратить этот дополнительный запрос, могут установить версию вручную, используя кортеж из трёх целых чисел, указывающих основные, второстепенные и микроверсии PostGIS. Например, для настройки PostGIS X.Y.Z используется:

POSTGIS_VERSION = (X, Y, Z)

Получение достаточных привилегий

В зависимости от вашей конфигурации, этот раздел описывает несколько способов настройки пользователя базы данных с достаточными привилегиями для запуска тестов приложений GeoDjango в PostgreSQL. Если ваша шаблон пространственной базы данных был создан так, как описано в инструкциях, то пользователю вашей тестовой базы данных необходимо только иметь возможность создавать базы данных. В других конфигурациях вам может потребоваться использовать суперпользователя базы данных.

Создать пользователя базы данных

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

$ createuser --createdb -R -S <user_name>

Флаги -R -S указывают, что мы не хотим, чтобы пользователь имел возможность создавать дополнительных пользователей (ролей) или быть суперпользователем соответственно.

В качестве альтернативы, вы можете изменить роль существующего пользователя из SQL-оболочки (предполагая, что это выполняется из существующей учётной записи суперпользователя):

postgres# ALTER ROLE <user_name> CREATEDB NOSUPERUSER NOCREATEROLE;

Создать суперпользователя базы данных

Это можно сделать во время создания пользователя, например:

$ createuser --superuser <user_name>

Или вы можете изменить роль пользователя из SQL-оболочки (предполагая, что это выполняется из существующей учётной записи суперпользователя):

postgres# ALTER ROLE <user_name> SUPERUSER;

Windows

В платформах Windows можно использовать утилиту pgAdmin III для добавления привилегий суперпользователя к вашему пользователю базы данных.

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

Тесты GeoDjango

Чтобы запустить тесты GeoDjango при выполнении набора тестов Django с помощью runtests.py, все базы данных в файле настроек должны использовать один из пространственных бэкендов баз данных.

Пример

Ниже приведен пример файла настроек с пространственными бэкендами, который можно использовать для запуска всего набора тестов Django, включая тесты в django.contrib.gis:

DATABASES = {
    "default": {
        "ENGINE": "django.contrib.gis.db.backends.postgis",
        "NAME": "geodjango",
        "USER": "geodjango",
    },
    "other": {
        "ENGINE": "django.contrib.gis.db.backends.postgis",
        "NAME": "other",
        "USER": "geodjango",
    },
}

SECRET_KEY = "django_tests_secret_key"

Предполагая, что приведенные выше настройки находятся в файле postgis.py в той же директории, что и runtests.py, то все тесты Django и GeoDjango будут выполняться при выполнении команды:

$ ./runtests.py --settings=postgis

Для запуска только набора тестов GeoDjango укажите gis_tests:

$ ./runtests.py --settings=postgis gis_tests