sharpetronics/QGIS
1
0
Fork 0
mirror of https://github.com/qgis/QGIS.git synced 2025-02-23 00:02:38 -05:00
Code Issues Packages Projects Releases Wiki Activity

Document PostgreSQL test db requirements

Browse Source 
Test DB needs be accessible via custom username/password,
and the qgis_test service should connect as a user with
the privilege to create other users.

References
https://github.com/qgis/QGIS/issues/45380#issuecomment-934531466
This commit is contained in:
Sandro Santilli 2021-10-05 17:59:27 +02:00
parent 0150ab8708
commit ccdf4a5c85
1 changed files with 15 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
tests/README.md
View File

@ -53,11 +53,11 @@ machine does not have an X server. In that case you need to run the test under
Make sure that you have enabled building of postgres test in CMake.
`cmake -DENABLE_TESTS=ON -DENABLE_PGTEST=ON ..`
To test the postgres provider you will need to have a database available to
which the postgres provider can connect. The server will need to have PostGIS
support enabled.
To test the postgres provider you will need to setup a test database
to which the postgres provider can connect.
By default the tests use the following connection string:
By default the tests use the following connection string to access
the test database:
service=qgis_test
@ -66,19 +66,26 @@ If these do not match your setup you can set the environment variable
rely on standard libpq environment variables to tweak host, port user
and password (PGHOST, PGPORT, PGUSER, PGPASSWORD).
Please note that the test database needs to be initialized using
the sql-scripts:
The test database must be initialized using the sql-scripts:
tests/testdata/provider/testdata_pg*.sql
They take care of activating PostGIS for the test database and
create some tables containing test data.
They take care of activating PostGIS and creating some tables containing
test data.
For convenience, a shell script is provided to create the database
and initialize it as needed:
tests/testdata/provider/testdata_pg.sh
Some tests will attempt to create database users too and expect them to
be allowed to connect using a password.
Most PostgreSQL installation by default use "ident" authentication
model when connecting via unix sockets. Make sure the `qgis_test`
service (or your `QGIS_PGTEST_DB` connection string) uses a connection
method which allows passing username/password pair to connect (and
which allows creating users)
# Write tests
Instructions about writing tests for the processing framework