preCICE System Tests

System tests for the distributed multi-physics coupling library library preCICE.

This repository provides Dockerfiles for building preCICE images, solvers, and adapters, as well as docker-compose files and scripts that coordinate everything. More information can be found in the docs

Dependencies

• preCICE
• docker
  • Make sure you can run docker as non-root user (see here)
  • Test your docker installation with e.g. docker run --rm hello-world
  • Test your network connectivity with docker run --rm alpine ping 8.8.8.8. See docs/development.md if this does not work.
• docker-compose
• python3

Main scripts

• system_testing.py is the main script to run automatic testing on CI system
• local_test.py is a simple wrapper to run tests on a local machine
• trigger_systemtests.py is a script that can be used by CI on other repositories or from the local machine to trigger Travis builds

Run a system test locally

To run OpenFOAM-OpenFOAM system test using Ubuntu 16.04 as the base for building preCICE and adapters:

   python3 local_test.py -s of-of -d Dockerfile.Ubuntu1604.home

Run python3 local_test.py -h for more information.

Alternatively, for debugging purposes, it might be useful to execute system_testing.py directly to emulate a TravisCI run. Here an example Fenics-Fenics test using Ubuntu 18.04 with verbose container output (-v) enabled:

python system_testing.py -s fe-fe --base Ubuntu1804.home -v