Skip to content

GeoProcessor / Running / Testing Framework

Overview

The GeoProcessor includes a testing framework, which is used to test the GeoProcessor itself (see the Developer Documentation) by running tests in the test repository. The test framework can also be used to automate testing of command file workflows, for example to validate other software and processes. The GeoProcessor testing framework does not require additional Python programming and instead relies on GeoProcessor commands that provide testing features. Examples of using the testing framework are:

  • tests for commands - see the GeoProcessor test repository
  • tests to confirm that a workflow is valid, for example by running a subset of a large analysis or to confirm that a snapshot of the large analysis is correct
  • test to confirm that a command line program gives expected results (see the RunProgram command)

Installation

The normal GeoProcessor run programs (gp.bat and gpui.bat on Windows, and gp and gpui on Linux) assume that the QGIS or ArcGIS Proo software is installed, and provide full access to geoprocessing commands. However, the testing framework included in the GeoProcessor is also useful in stand-alone mode without relying on GIS software.

The standalone testing framework (gptest) is currently not under active development. Use the normal GeoProcessor for testing. The gptest variable may be removed in the future.

The installation instructions explain how to install the test framework version, which installs testing framework run programs (gptest.bat and gptestui on Windows, and gptest and gptestui on Linux). In summary, installing the testing framework will install a Python virtual environment that isolates the GoeProcessor software from other Python installations on the system.

Running the Testing Framework

The standalone testing framework (gptest) is currently not under active development. Use the normal GeoProcessor for testing. The gptest variable may be removed in the future.

The GeoProcessor testing framework is run using:

  • Command line: gptest.bat on windows Windows and gptest on linux Linux
  • User interface (UI): gptestui.bat on windows Windows and gptestui on linux Linux

The above programs are located in the scripts folder of the GeoProcessor virtual environment.