Add test for DBManager's PostGIS connector and plugin

Only enabled when ENABLE_PGTEST is set Includes test for dbname-less URI and service-only URI (ref #10600 ref #16625 ref #16626) The test connects to the `qgis_test` database, or what the QGIS_PGTEST_DB variable requests (as per tests/README.md) A raster table is added to the test postgis setup script, for use by this new test.
qgis · Jun 6, 2017 · 3efee43 · 3efee43
1 parent ecb4c5a
commit 3efee43
Show file tree

Hide file tree

Showing 5 changed files with 229 additions and 0 deletions.
diff --git a/python/plugins/db_manager/db_plugins/postgis/CMakeLists.txt b/python/plugins/db_manager/db_plugins/postgis/CMakeLists.txt
@@ -8,3 +8,10 @@ PLUGIN_INSTALL(db_manager db_plugins/postgis/icons ${ICON_FILES})
 
 ADD_SUBDIRECTORY(plugins)
 
+IF(ENABLE_TESTS)
+  INCLUDE(UsePythonTest)
+  IF (ENABLE_PGTEST)
+    ADD_PYTHON_TEST(dbmanager-postgis-connector connector_test.py)
+    ADD_PYTHON_TEST(dbmanager-postgis-plugin plugin_test.py)
+  ENDIF (ENABLE_PGTEST)
+ENDIF(ENABLE_TESTS)
diff --git a/python/plugins/db_manager/db_plugins/postgis/connector_test.py b/python/plugins/db_manager/db_plugins/postgis/connector_test.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+
+"""
+***************************************************************************
+    connector_test.py
+    ---------------------
+    Date                 : May 2017
+    Copyright            : (C) 2017, Sandro Santilli
+    Email                : strk at kbt dot io
+***************************************************************************
+*                                                                         *
+*   This program is free software; you can redistribute it and/or modify  *
+*   it under the terms of the GNU General Public License as published by  *
+*   the Free Software Foundation; either version 2 of the License, or     *
+*   (at your option) any later version.                                   *
+*                                                                         *
+***************************************************************************
+"""
+
+__author__ = 'Sandro Santilli'
+__date__ = 'May 2017'
+__copyright__ = '(C) 2017, Sandro Santilli'
+# This will get replaced with a git SHA1 when you do a git archive
+__revision__ = '$Format:%H$'
+
+import os
+import qgis
+from qgis.testing import start_app, unittest
+from qgis.core import QgsDataSourceURI
+from qgis.utils import iface
+
+start_app()
+
+from db_manager.db_plugins.postgis.connector import PostGisDBConnector
+
+
+class TestDBManagerPostgisConnector(unittest.TestCase):
+
+    #def setUpClass():
+
+    def _getUser(self, connector):
+        r = connector._execute(None, "SELECT USER")
+        val = connector._fetchone(r)[0]
+        connector._close_cursor(r)
+        return val
+
+    def _getDatabase(self, connector):
+        r = connector._execute(None, "SELECT current_database()")
+        val = connector._fetchone(r)[0]
+        connector._close_cursor(r)
+        return val
+
+    # See https://issues.qgis.org/issues/16625
+    # and https://issues.qgis.org/issues/10600
+    def test_dbnameLessURI(self):
+        c = PostGisDBConnector(QgsDataSourceURI())
+        self.assertIsInstance(c, PostGisDBConnector)
+        uri = c.uri()
+
+        # No username was passed, so we expect it to be taken
+        # from PGUSER or USER environment variables
+        expected_user = os.environ.get('PGUSER') or os.environ.get('USER')
+        actual_user = self._getUser(c)
+        self.assertEqual(actual_user, expected_user)
+
+        # No database was passed, so we expect it to be taken
+        # from PGDATABASE or expected user
+        expected_db = os.environ.get('PGDATABASE') or expected_user
+        actual_db = self._getDatabase(c)
+        self.assertEqual(actual_db, expected_db)
+
+    # TODO: add service-only test (requires a ~/.pg_service.conf file)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/python/plugins/db_manager/db_plugins/postgis/plugin_test.py b/python/plugins/db_manager/db_plugins/postgis/plugin_test.py
@@ -0,0 +1,130 @@
+# -*- coding: utf-8 -*-
+
+"""
+***************************************************************************
+    plugin_test.py
+    ---------------------
+    Date                 : May 2017
+    Copyright            : (C) 2017, Sandro Santilli
+    Email                : strk at kbt dot io
+***************************************************************************
+*                                                                         *
+*   This program is free software; you can redistribute it and/or modify  *
+*   it under the terms of the GNU General Public License as published by  *
+*   the Free Software Foundation; either version 2 of the License, or     *
+*   (at your option) any later version.                                   *
+*                                                                         *
+***************************************************************************
+"""
+
+__author__ = 'Sandro Santilli'
+__date__ = 'May 2017'
+__copyright__ = '(C) 2017, Sandro Santilli'
+# This will get replaced with a git SHA1 when you do a git archive
+__revision__ = '$Format:%H$'
+
+import os
+import re
+import qgis
+from qgis.testing import start_app, unittest
+from qgis.core import QgsDataSourceURI
+from qgis.utils import iface
+from qgis.PyQt.QtCore import QObject
+
+start_app()
+
+from db_manager.db_plugins.postgis.plugin import PostGisDBPlugin, PGRasterTable
+from db_manager.db_plugins.postgis.plugin import PGDatabase
+from db_manager.db_plugins.plugin import Table
+from db_manager.db_plugins.postgis.connector import PostGisDBConnector
+
+
+class TestDBManagerPostgisPlugin(unittest.TestCase):
+
+    @classmethod
+    def setUpClass(self):
+        self.old_pgdatabase_env = os.environ.get('PGDATABASE')
+        self.testdb = os.environ.get('QGIS_PGTEST_DB') or 'qgis_test'
+        os.environ['PGDATABASE'] = self.testdb
+
+        # Create temporary service file
+        self.old_pgservicefile_env = os.environ.get('PGSERVICEFILE')
+        self.tmpservicefile = '/tmp/qgis-test-{}-pg_service.conf'.format(os.getpid())
+        os.environ['PGSERVICEFILE'] = self.tmpservicefile
+
+        f = open(self.tmpservicefile, "w")
+        f.write("[dbmanager]\ndbname={}\n".format(self.testdb))
+        # TODO: add more things if PGSERVICEFILE was already set ?
+        f.close()
+
+    @classmethod
+    def tearDownClass(self):
+        # Restore previous env variables if needed
+        if self.old_pgdatabase_env:
+            os.environ['PGDATABASE'] = self.old_pgdatabase_env
+        if self.old_pgservicefile_env:
+            os.environ['PGSERVICEFILE'] = self.old_pgservicefile_env
+        # Remove temporary service file
+        os.unlink(self.tmpservicefile)
+
+    # See https://issues.qgis.org/issues/16625
+
+    def test_rasterTableGdalURI(self):
+
+        def check_rasterTableGdalURI(expected_dbname):
+            tables = database.tables()
+            raster_tables_count = 0
+            for tab in tables:
+                if tab.type == Table.RasterType:
+                    raster_tables_count += 1
+                    gdalUri = tab.gdalUri()
+                    m = re.search(' dbname=([^ ]*) ', gdalUri)
+                    self.assertTrue(m)
+                    actual_dbname = m.group(1)
+                    self.assertEqual(actual_dbname, expected_dbname)
+                #print(tab.type)
+                #print(tab.quotedName())
+                #print(tab)
+
+            # We need to make sure a database is created with at
+            # least one raster table !
+            self.assertEqual(raster_tables_count, 1)
+
+        obj = QObject() # needs to be kept alive
+
+        # Test for empty URI
+        # See https://issues.qgis.org/issues/16625
+        # and https://issues.qgis.org/issues/10600
+
+        expected_dbname = self.testdb
+        os.environ['PGDATABASE'] = expected_dbname
+
+        database = PGDatabase(obj, QgsDataSourceURI())
+        self.assertIsInstance(database, PGDatabase)
+
+        uri = database.uri()
+        self.assertEqual(uri.host(), '')
+        self.assertEqual(uri.username(), '')
+        self.assertEqual(uri.database(), expected_dbname)
+        self.assertEqual(uri.service(), '')
+
+        check_rasterTableGdalURI(expected_dbname)
+
+        # Test for service-only URI
+        # See https://issues.qgis.org/issues/16626
+
+        os.environ['PGDATABASE'] = 'fake'
+        database = PGDatabase(obj, QgsDataSourceURI('service=dbmanager'))
+        self.assertIsInstance(database, PGDatabase)
+
+        uri = database.uri()
+        self.assertEqual(uri.host(), '')
+        self.assertEqual(uri.username(), '')
+        self.assertEqual(uri.database(), '')
+        self.assertEqual(uri.service(), 'dbmanager')
+
+        check_rasterTableGdalURI(expected_dbname)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/testdata/provider/testdata_pg.sh b/tests/testdata/provider/testdata_pg.sh
@@ -4,6 +4,7 @@ SCRIPTS="
   tests/testdata/provider/testdata_pg.sql
   tests/testdata/provider/testdata_pg_reltests.sql
   tests/testdata/provider/testdata_pg_vectorjoin.sql
+  tests/testdata/provider/testdata_pg_raster.sql
 "
 
 createdb qgis_test || exit 1

diff --git a/tests/testdata/provider/testdata_pg_raster.sql b/tests/testdata/provider/testdata_pg_raster.sql
@@ -0,0 +1,15 @@
+-- Table: qgis_test.raster1
+
+CREATE TABLE qgis_test."Raster1"
+(
+  pk serial NOT NULL,
+  name character varying(255),
+  "Rast" raster
+);
+
+INSERT INTO qgis_test."Raster1" (name, "Rast") SELECT
+  'simple one',
+  ST_AddBand(
+    ST_MakeEmptyRaster(16, 32, 7, -5, 0.2, -0.7, 0, 0, 0),
+    1, '8BUI', 0.0, NULL
+  );