# Change directory to where testharness tool is located
$ cd <PathToYourApplicationDirectory>/tools/testHarness

# Install pip
$ sudo easy_install pip

# First install virtualenv
$ sudo pip install virtualenv

# Create a new virtual environment
$ virtualenv env
# NOTE: Since we are using a version control system (Git), you shouldn't commit the env directory. Add it to your .gitignore file if it is not there.

# Activate the environment
$ source env/bin/activate
# NOTE: You should always activate the virtual environment before you start working with testHarness

# Install the dependencies for testHarness into this virtual environment
$ pip install -r requirements.txt

# Finally, install the testHarness so it is ready to be used. This will create a command line tool called "harness"
$ python setup.py install
$ python setup.py install --record files.txt  # Run this if you want to save the installed stuff for easy deletion later on

# Deactivate the virtual environment when you are done using testHarness
$ deactivate


# ######### Additional commands #########
# To delete the installed testharness binaries and other data
$ cat files.txt | xargs rm -rf

# If you want to output installed packages in requirements format (this will be saved to requirements.txt)
# This should only be ran if you install new libraries in the virtual environment that testharness depends on
$ pip freeze > requirements.txt

$ python setup.py install  # Needed to be run only when you update any file(s), for example, say you add more tests to definitions.py

# This will run the testharness
$ harness -c <path-to-config-file>

# This will give you the usage options for CLI "harness"
$ harness