To run tests in an automated fashion, the AIMMS Unit Test framework comes with a Python script
AIMMSUnitTests.py that you can call from the command line to run all, or selected tests. You can copy the
AIMMSUnitTest.py script to your project folder by calling the procedure
aimmsunit::CopyPythonScript. The arguments of the Python script are:
- the AIMMS version to be used to run the test (e.g.
22.214.171.124), the test script will automatically download the AIMMS version from the AIMMS download site and unpack it in the aimms subfolder of the location from which you run the script
- the architecture to run the test on (
x64on Windows, or
- the project folder, relative to the working folder, containing the AIMMS project to test
- the name of the project file (e.g.
- optionally, the names of the test suites to test (
--suitesargument), if not specified all test suites will be run.
You can use this script, for instance, when checking in a new version of your project into your version control system.
Requirements for the Python script¶
To successfully run the script, you should have the following software installed on your test machine:
- Python 2.7
- Python requests module installed (install via
pip install requests)
- 7-zip (Windows only, installed in
Example - we practise what we preach¶
When checking in a new version of the AIMMS Unit Test library into our internal Gitlab repository, a build script will automatically be run to
- build all external DLLs that come with the AIMMS Unit Test library,
- run the unit test suites defined by the AIMMS Unit Test library project itself, and
- if successful, package the AIMMS Unit Test library, and upload it to the AIMMS Library repository.
The following output of running the test suites is returned during the second step
AimmsCmd.exe (build 126.96.36.199) Copyright 1993 - 2014 AIMMS B.V. Running project: c:\u\Gitlab-Runner\builds\e03d9f06\0\Libraries\aimms-unit-test\AIMMSUnitTest-edit\test-AIMMSUnitTest-edit.aimms 1:> Return value = 0 2:> Ok Closing project +++++ Unit tests of project test-AIMMSUnitTest-edit.aimms succeeded
If any of the tests fail, the python script will list the contents of the file
log/AimmsUnit.xml to show the individual results of all tests.
Last Updated: January, 2020