Running the test suite


Install the dependencies and OpenREM

OpenREM is a Django application, and therefore we use Django’s test-execution framework to test OpenREM.

The first thing to do is to create a local copy of the git repository, then install all of OpenREM’s dependencies in a virtualenv.

You will need python, pip, git and virtualenv installed - see the links on the Pre-installation preparations docs for the latter, but you might try pip install virtualenv.

mkdir openremrepo
git clone openremrepo

Now create the virtualenv:

mkdir veOpenREM
virtualenv veOpenREM
. veOpenREM/bin/activate  # Linux
veOpenREM\Scripts\activate  # Windows

At this stage there should be a (veOpenREM) prefix to our prompt telling us the virtualenv is activated.

Now install the dependencies:

pip install -e openremrepo/
pip install

In the future it might be necessary to install numpy too for testing.

Configure OpenREM

Rename and configure openremproject/ and openremproject/ as per the Installing OpenREM docs.

Create a database following the same Installing OpenREM instructions.

Run the tests!

Making sure the virtualenv is activated, move to openremrepo/openrem and run:

python test remapp

All the tests that exit in openrem/remapp/tests/ will now be run.

Creating test versions of production systems

If you wish to create a duplicate install to test upgrades etc, refer to Restore the database and the preceding text regarding making backups.