Virtual Environments

This directory contains Bash scripts automating the creation of virtual environments ("venv"s) using virtualenv for testing purposes.

Requirements

The OS requirements of aeneas (espeak, ffmpeg, festival, etc.)
virtualenv, version 15.0.3 or later
Your choice of Python interpreters (e.g., python2.7, python3.5, pypy, etc.), which should be available on the command line (i.e., be in your PATH environment variable).

Usage

In the examples, python3.5 is the target interpreter. For example, on Debian:

$ which python3.5
/usr/bin/python3.5

Uninstall existing venv

$ bash manage_venvs.sh python3.5 uninstall

Install new venv

$ bash manage_venvs.sh python3.5 install

Install Python dependencies inside the venv

$ bash manage_venvs.sh python3.5 deps

Note: the above will perform a pip install -U ... (upgrade).

Install new version of aeneas from the sdist archive

To install from ../dist/aeneas*.tar.gz:

$ bash manage_venvs.sh python3.5 install
$ bash manage_venvs.sh python3.5 sdist

To install from file /tmp/foo.tar.gz:

$ bash manage_venvs.sh python3.5 install
$ bash manage_venvs.sh python3.5 sdist /tmp/foo.tar.gz

This procedure will:

create the venv
activate the venv
uninstall aeneas, if already installed
copy the sdist archive inside the venv and install it
delete the sdist archive inside the venv
perform the diagnostic tests
deactivate the venv

To uninstall aeneas from the venv:

$ bash manage_venvs.sh python3.5 sdist --remove

To force building the cfw extension:

$ bash manage_venvs.sh python3.5 install
$ AENEAS_FORCE_CFW=True bash manage_venvs.sh python3.5 sdist

Manual testing

$ bash manage_venvs.sh python3.5 full
$ cd venv_python3.5
$ source bin/activate
$ cd tests

$ # do your testing here
$ # for example:
$ python run_all_unit_tests.py
$ python run_all_unit_tests.py -l -v
$ python run_all_unit_tests.py task
$ python run_all_unit_tests.py configuration -v
$ # etc ...

$ cd ..
$ deactivate
$ cd ..

Note: full is equivalent to install + deps + tests.

Automated testing

First, do a full install of the venv:

$ bash manage_venvs.sh python3.5 full

Then, each time you want to run the tests:

$ # all
$ bash run_tests.sh python3.5 all

$ # fast
$ bash run_tests.sh python3.5 fast

$ # tool
$ bash run_tests.sh python3.5 tool

$ # long
$ bash run_tests.sh python3.5 long

$ # bench
$ bash run_tests.sh python3.5 bench

$ # net
$ bash run_tests.sh python3.5 net

$ # all, except net
$ bash run_tests.sh python3.5 nonet