Testing

Run automated tests suite

make test

This will run the automated tests suite in a docker container.

Note that this plugin contains tools that take some datasets as input and produce other datasets as outputs. Some tests compare those outputs to expected ones.

Overwrite the expected result datasets

make test-overwrite-outputs

This will run the tests and overwrite the expected resultsets. After that you can check the expected results sets feet your needs and commit them.

Test the plugin with QGIS desktop in a docker environment

make qgis

This will run a docker container with QGIS desktop application.

Source code in mounted though a volume in folder /app.

This /app folder is also declared in QGIS_PLUGINPATH so the plugin can be directly activated in "QGIS Extensions manager".

You can also access the tests input and expected results datasets in folder /app/tests/data.

Note that QGIS setting are also stored in a named volume, so they will persist when QGIS container is deleted and recreated.

Test the plugin with QGIS desktop

Linux

make link

This will create a symbolic link to the plugin source code folder in your home QGIS Python plugins folder.

Windows

In QGIS settings, in tab System add an environment variable named QGIS_PLUGINPATH with as value the path to this folder (git repository root folder).

All operating systems

In QGIS desktop extensions manager:

• load plugin PreCourlis;
• install QGIS Plugin Plugin Reloader.

Now you can easily make changes in source code, reload plugin PreCourlis and see changes in QGIS desktop.