TestVox Development

Downloading source code

You can either clone the TestVox repository on Bitbucket, or download the latest sources as a tarball.

Overview of the source code

The TestVox source directory has this structure:

testvox/
  webclient/
  webserver/
  scripts

The webclient is code written in PyJS. It provides the web interface that listening tests will be conducted with.

The webserver code and scripts are written in Python. It uses many built-in python modules, and these external modules:

• CherryPy for the web framework
• PyYAML for parsing YAML files
• Jinja2 for web templates
• Web2Py DAL as the database abstraction layer.

Build Dependencies

TestVox build requires you to have the following packages available on your system

• Python 2.7+
• PyJS 0.8.1+ for building the webclient
• Java runtime environment to optimize webclient before deployment

Building TestVox

cd testvox  # the source directory

# Get external python modules (CherryPy, PyYAML, Jinja2, Web2Py-DAL)
python setup.py --task=get_dependencies

# Create a debug build
python setup.py --task=build_debug

# Create a release build
python setup.py --task=build_release

# Create a deployment zipfile (like TestVox-prebuilt.zip)
python setup.py --task=deploy

# Clean the distribution
python setup.py --task=clean_dist