lynx-runtime

• lynx-runtime
  • Architecture
  • Setup
  • Building container image
    • Podman
    • Docker
  • Running container image
    • Podman
    • Docker
  • Running tests
  • Development
    • version 0.1: Runtime responsible for creating game's environment, running user's code and returning the results through other microservices to lynx-frontend.

Architecture

Small runtime running user's code in randomly generated environment.

User can perform specific callbacks in order to change state of the game's world.

Changes to the world are printed to stdout which is captured by runner microservice and passed further until it reaches frontend service which displays it in a visual environment.

Setup

pip install -r requirements.txt

To use autopep8 hook for pre-commit:

python -m pip install autopep8 pre-commit
pre-commit install

Building container image

Podman

podman build . -t lynx-runtime:<version>

Docker

docker build . -t lynx-runtime:<version>

Running container image

In order to run code.py found inside ./usr directory use:

Podman

podman run -v./usr/:/code:ro lynx-runtime:<version>

Docker

docker run -v <absolute local path to the ./usr directory>:/code:ro lynx-runtime:<version>

Running tests

In order to run all tests found inside ./tests directory use:

pytest tests 

Development

version 0.1:

• Create basic classes for level, agents etc.
• Add game main loop.
• User's code execution inside exec using predefined __builtins__.