https://github.com/precice/systemtests
Testing preCICE / solver combinations using Docker
https://github.com/precice/systemtests
Last synced: 4 months ago
JSON representation
Testing preCICE / solver combinations using Docker
- Host: GitHub
- URL: https://github.com/precice/systemtests
- Owner: precice
- License: gpl-3.0
- Created: 2018-07-02T07:44:15.000Z (almost 8 years ago)
- Default Branch: develop
- Last Pushed: 2021-03-22T20:49:35.000Z (about 5 years ago)
- Last Synced: 2025-04-08T15:21:17.724Z (about 1 year ago)
- Language: Python
- Size: 400 MB
- Stars: 4
- Watchers: 4
- Forks: 5
- Open Issues: 49
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# preCICE System Tests
[](https://travis-ci.org/precice/systemtests)
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](docs/)
## Dependencies
* [preCICE](https://github.com/precice/precice)
* [docker](https://docs.docker.com/install/linux/docker-ce/ubuntu/)
* Make sure you can run docker as non-root user (see [here](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user))
* 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`](docs/development.md) if this does not work.
* [docker-compose](https://docs.docker.com/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
```