mosaik.Multi-Project 0.1.0rc20210726000639

Manage multiple mosaik projects with using common tooling.

mosaik.Multi-Project

Tooling for setting up and maintaining multiple (mosaik) projects.

Motivation

mosaik scenarios often contain multiple simulators. Sometimes, additional packages need to be developed alongside of them. Managing such a set of loosely coupled projects becomes laborious easily. This project provides tooling for some common operations on projects. These operations range from cloning the repository to building a docker image. Operations can be run in parallel on projects, enabling quite some automation.

Status

Maturity

The code of this project was largely in operation in the Designetz project. There, it was used to maintain and develop components of the AI-powered power grid control room "System-Cockpit". The System-Cockpit consisted of about 12 mosaik simulators as well as about 18 support and infrastructure projects.

One-line Execution

mosaik.Multi-Project can be run as a container directly from GitLab.com:

docker run registry.gitlab.com/offis.energy/mosaik/mosaik.multi-project:latest --help

Prerequisites

• Python 3.6+
• git

Downloading

git clone [e-mail]:offis.energy/mosaik/mosaik.multi-project.git

Virtual Environment

python3 -m venv venv

Tox

venv/bin/python -m pip install -r requirements.d/venv.txt
venv/bin/python -m tox -e py39

Running

PYTHONPATH=. \
.tox_py38_bin_python mosaik_multi_project/multi_project/cli/main.py \
--help

Use Cases

Setup all projects in the config and update their requirements in parallel:

PYTHONPATH=. \
.tox_py38_bin_python mosaik_multi_project/multi_project/cli/main.py

Setup one project in the config and update its requirements:

PYTHONPATH=. \
.tox_py38_bin_python mosaik_multi_project/multi_project/cli/main.py \
--parallel False --project mosaik.EId --operation ALL